Skip to content
Opsilo Deutsch

Support

Contact

Email support@pictures-today.com. We’ll get back to you as soon as we can.

These details help us answer:

Set up in three steps

  1. Install: download Opsilo from the Mac App Store and open it. From macOS 15 on, macOS asks on first launch whether the app may find devices on your local network; answer Allow.
  2. First-run setup:
    • your Immich server’s address on your home network, e.g. http://192.168.1.20:2283, and/or the address for the road, e.g. https://immich.example.com
    • the API key (see below)
    • the folder for originals: the default is “Movies › Opsilo”
  3. Optionally the share: Settings › Files › Share with Immich’s Storage › Choose Share… (see below).

Create an API key

  1. In Immich, click your profile picture at the top right › Account Settings › API Keys. The app opens this page for you too: Settings › Connection › Open Immich Account Settings.
  2. New API Key, name it e.g. “Opsilo”.
  3. Permissions: the easiest choice is all. For a narrower key, pick exactly these seven: asset.read, asset.view, asset.download, asset.statistics, album.read, person.read, person.statistics.
  4. Create, then copy the key right away; Immich shows it only once.
  5. In the app: Settings (⌘,) › Connection › paste it into API Key, click Save, then Check. Green means the key is valid and has every permission. If one is missing, the app names it.

The key is then stored in your Mac’s keychain.

Share with Immich’s storage

This is the folder that holds Immich’s library, upload and thumbs folders, not a folder you created yourself.

  1. In the Finder, choose Go › Connect to Server… (⌘K), enter your NAS address, e.g. smb://nas.local/immich, and tick Remember this password in my keychain.
  2. In the app: Settings › Files › Choose Share… and pick the folder that contains library, upload and thumbs, e.g. /Volumes/Immich.
  3. Done. From the next launch on, the app connects the share by itself as soon as your home network answers. The status bar briefly shows “Connecting share…”.

Set up Final Cut Pro

To keep Final Cut from making a copy: Final Cut Pro › Settings › Import › Files: Leave files in place.

Final Cut’s library then links to the original on the share. With “Copy to library storage location”, Final Cut copies every file you drag into the library.

The badges on the tiles

Badge Meaning
green drive Local: original on the share, ready to drag
green disk Downloaded: original in the cache on your Mac, ready to drag
teal arrow Downloading: the original is on its way from the server
grey cloud Remote: only on the server; selecting it downloads it
star favorite in Immich

If something doesn’t work

What you see What helps
No connection at home although Immich is running System Settings › Privacy & Security › Local Network (macOS 15 and later): turn on Opsilo.
“No server reachable” Check your network or VPN, then Settings › Connection › Check Connection, then ⌘R.
The key is rejected Settings › Connection › Check names the missing permission. Add it in Immich or create a new key with all.
Every tile shows the grey cloud The share isn’t mounted. Connect it once in the Finder and tick Remember this password in my keychain; from then on the app connects it by itself.
An item is missing on the road Sidebar › Cache shows what’s on your Mac. Before a trip, use Download for Offline Use.
On the road the app can’t reach the server If there’s an extra sign-in page in front of Immich, the app can’t get past it. On the road, connect over VPN into your home network.
⌘V in Final Cut inserts nothing Final Cut has to be in front with the timeline active: click into it once, then press ⌘V.

User guide

The full user guide is built into the app (Help › Opsilo – User Guide, ⌘?) and available here as PDF:

Version

1.0, the first release for the Mac App Store.

Frequently asked questions

You’ll find the answers on the home page.