# Immich Album Downloader

This Python script downloads all assets (photos/videos) from a specific album in your [Immich](https://github.com/immich-app/immich) instance, using its API. It supports resuming by skipping files that already exist locally.

## Features

- Downloads all assets from a specified album
- Uses pagination to handle large albums
- Skips already-downloaded files
- Can be automated with `systemd` services and timers

## Requirements
You can install dependencies with:

```bash
pip install requests
```
or you can use your system's package manager.

## Environment Variables

| Variable               | Description                            |
|------------------------|----------------------------------------|
| `IMMICH_API_KEY`       | Your Immich API key                    |
| `IMMICH_INSTANCE_URL`  | Immich instance URL (e.g. `https://your-instance/api`) |
| `IMMICH_ALBUM_ID`      | The ID of the album to download        |
| `IMMICH_DOWNLOAD_PATH` | Directory to save downloaded assets    |

## Configuration

1. Copy the files:

```bash
sudo mkdir /opt/immich-album-downloader
sudo cp main.py /opt/immich-album-downloader/main.py
sudo cp .env.template /opt/immich-album-downloader/.env
```

2. Modify `/opt/immich-album-downloader/.env` accordingly
---

## Running the script automatically

Create a service file at `/etc/systemd/user/immich-album-downloader.service`:

```ini
[Unit]
Description=Immich Album Downloader
After=network.target

[Service]
Type=simple
EnvironmentFile=/opt/immich-album-downloader/.env
ExecStart=/usr/bin/python3 /opt/immich-album-downloader/main.py
Restart=no

[Install]
WantedBy=default.target
```

Enable and start the service (only if you don't configure the timer below):

```bash
systemctl --user daemon-reload
systemctl --user enable --now immich-album-downloader.service
```

---

### Running the script periodically

To run the download periodically, create `/etc/systemd/user/immich-album-downloader.timer`:

```ini
[Unit]
Description=Download an Immich album periodically

[Timer]
OnBootSec=15m
OnUnitActiveSec=6h

[Install]
WantedBy=timers.target
```

Enable the timer:

```bash
systemctl --user enable --now immich-album-downloader.timer
```

This will trigger the album download 15 minutes after boot and then every 6 hours.

---