Update docs
This commit is contained in:
@@ -1 +1,75 @@
|
|||||||
Permissions required for the API key are `asset.read` and `albumAsset.create`
|
## Setup
|
||||||
|
|
||||||
|
### Create an API key
|
||||||
|
|
||||||
|
1. Open Immich on desktop
|
||||||
|
2. Click on your profile picture
|
||||||
|
3. Click **Account Settings**
|
||||||
|
4. Go to API Keys
|
||||||
|
5. Click **New API Key**
|
||||||
|
6. Give it a name
|
||||||
|
7. Add the permissions of `asset.read` and `albumAsset.create`
|
||||||
|
8. Click **Create**
|
||||||
|
9. Copy the new API key and put it in your config file
|
||||||
|
|
||||||
|
### Get your person and album IDs
|
||||||
|
|
||||||
|
Person IDs:
|
||||||
|
|
||||||
|
- Immich → Explore → People → Click person → Copy ID from URL
|
||||||
|
- Example URL: http://your-server/people/f3437c84-83f9-4e84-9640-0dcd12efd08e
|
||||||
|
- Person ID: f3437c84-83f9-4e84-9640-0dcd12efd08e
|
||||||
|
|
||||||
|
Album IDs:
|
||||||
|
|
||||||
|
- Immich → Albums → Click album → Copy ID from URL
|
||||||
|
- Example URL: http://your-server/albums/ff85e8c5-32e6-49e0-a0ad-e4dd7ef66bce
|
||||||
|
- Album ID: ff85e8c5-32e6-49e0-a0ad-e4dd7ef66bce
|
||||||
|
|
||||||
|
### Docker-compose configuration
|
||||||
|
|
||||||
|
Take a copy of the [docker-compose.yml](https://github.com/alangrainger/immich-person-to-album/blob/main/docker-compose.yml) file.
|
||||||
|
|
||||||
|
There are two methods for specifying the config options.
|
||||||
|
|
||||||
|
#### `config.json` file
|
||||||
|
|
||||||
|
1. In the folder which contains your `docker-compose.yml` file, create a `data` folder.
|
||||||
|
2 .Inside the `data` folder, put a copy of [config.json](https://github.com/alangrainger/immich-person-to-album/blob/main/data/config.json.example).
|
||||||
|
3. Edit the `config.json` file as required.
|
||||||
|
|
||||||
|
#### Inline configuration
|
||||||
|
|
||||||
|
Alternatively, you can add the configuration inline in your `docker-compose.yml` file like this:
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
services:
|
||||||
|
immich-person-to-album:
|
||||||
|
image: alangrainger/immich-person-to-album:latest
|
||||||
|
container_name: immich-person-to-album
|
||||||
|
restart: always
|
||||||
|
volumes:
|
||||||
|
- ./data:/data
|
||||||
|
environment:
|
||||||
|
CONFIG: |
|
||||||
|
{
|
||||||
|
"immichServer": "http://192.168.0.20:2283",
|
||||||
|
"schedule": "*/30 * * * *",
|
||||||
|
"users": [
|
||||||
|
{
|
||||||
|
"apiKey": "",
|
||||||
|
"personLinks": [
|
||||||
|
{
|
||||||
|
"description": "Photos of Joe",
|
||||||
|
"personId": "Joe's person ID",
|
||||||
|
"albumId": "Shared album ID"
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
]
|
||||||
|
}
|
||||||
|
```
|
||||||
|
|
||||||
|
## Acknowledgements
|
||||||
|
|
||||||
|
Thanks to https://github.com/ajb3932/immich-partner-sharing for the idea and for some of the readme text.
|
||||||
|
|||||||
@@ -3,7 +3,5 @@ services:
|
|||||||
image: alangrainger/immich-person-to-album:latest
|
image: alangrainger/immich-person-to-album:latest
|
||||||
container_name: immich-person-to-album
|
container_name: immich-person-to-album
|
||||||
restart: always
|
restart: always
|
||||||
ports:
|
|
||||||
- "3000:3000"
|
|
||||||
volumes:
|
volumes:
|
||||||
- ./data:/data
|
- ./data:/data
|
||||||
|
|||||||
Reference in New Issue
Block a user