Applicay Logo Applicay Software Development
PhotoPanel Manual

Using Photo Sources

A practical guide to Files, WebDAV, and Immich in PhotoPanel.

PhotoPanel Anleitung

Fotoquellen verwenden

Eine praktische Anleitung für Dateien, WebDAV und Immich in PhotoPanel.

Overview: where PhotoPanel can load photos from

PhotoPanel can still use albums from Apple Photos, but the current app version also lets you choose other places where your pictures live. Think of a photo source as the shelf PhotoPanel looks at before it starts the slideshow.

PhotoPanel photo source selection screen

Files

Best for local folders, iCloud Drive, SMB shares, USB sticks, SD cards, and external drives shown in the iOS Files app.

WebDAV

Best for NAS devices, Nextcloud, ownCloud, and other servers that expose folders over WebDAV.

Immich

Best if your photos are managed in a self-hosted Immich server and organized in Immich albums.

Important: Only Apple Photos supports Live Photos in PhotoPanel. Files, WebDAV, and Immich are treated as still-image sources. EXIF date and location can still be shown when the image file or server data contains that information.

Files app: local folders, iCloud Drive, SMB, and external drives

The Files source uses Apple’s standard Files picker. Anything that appears as a folder in the Files app can usually be selected: “On My iPad”, iCloud Drive, connected SMB file servers, USB sticks, SD cards, and external hard drives.

PhotoPanel Files source settings screen

  1. Prepare the folder in the Files app.

    Put your photos into one or more folders. Subfolders are fine: PhotoPanel scans selected folders recursively and ignores hidden files and app packages.

  2. Open PhotoPanel settings and choose Files.

    Long-press the slideshow, open the photo source selector, then choose Files.

  3. Tap “Select folders” and pick one or more folders.

    iOS asks you to grant access to those folders. PhotoPanel stores that permission as a secure bookmark so it can reopen the folder later.

  4. Start the slideshow.

    The first scan can take a moment, especially on slow cloud folders, USB drives, or network shares. After that, the normal slideshow controls work as usual.

Adding an SMB server to the Files app

SMB is the normal Windows-style file sharing protocol used by many NAS devices, Macs, PCs, and routers with attached storage. PhotoPanel does not connect to SMB directly; instead, you connect the SMB share in Apple’s Files app first, then select that folder in PhotoPanel.

  1. 1. Open Files. On iPhone or iPad, open the Files app and go to the Browse tab.
  2. 2. Open the menu. Tap the three-dot button and choose Connect to Server.
  3. 3. Enter the server address. Use an address such as smb://192.168.1.20 or smb://nas.local. If your server needs a share name, you may enter it as smb://nas.local/Photos.
  4. 4. Sign in. Choose Registered User if the share needs a username and password. Choose Guest only for shares that are intentionally public on your private network.
  5. 5. Select the share in PhotoPanel. After the server appears in Files, open PhotoPanel, choose Files, tap Select folders, browse to the SMB share, and pick the folder containing your pictures.

Tip: give your NAS a fixed IP address or stable local name. If the address changes, the Files app may lose the connection and PhotoPanel may ask you to select the folder again.

What works well

JPEG, PNG, HEIC, TIFF, WebP, GIF, BMP, and other file types that iOS reports as images. External drives are best formatted as APFS or ExFAT.

What to watch for

Cloud placeholders may need downloading before they can be displayed. If a folder disappears or iOS revokes access, select the folder again in PhotoPanel.

Apple’s Files app can connect to external storage, file servers, and cloud services. Apple explains those basics in the iPhone User Guide for files, servers, and external storage.

WebDAV: NAS, Nextcloud, and remote folders

WebDAV is a standard way to browse folders on a server over the network. It is useful when your photos are on a NAS, Nextcloud, ownCloud, or another server and you do not want to copy everything into Apple Photos.

PhotoPanel WebDAV settings for a Nextcloud server

  1. Find the WebDAV address.

    For Nextcloud it usually looks like https://cloud.example.com/remote.php/dav/files/USERNAME/. Nextcloud also shows the exact WebDAV URL in the file settings area.

  2. Enter server address, username, and password.

    PhotoPanel stores the password in the iOS Keychain. If your server supports app passwords, use one instead of your main account password.

  3. Test and save the connection.

    PhotoPanel sends a small WebDAV request to check that the server, credentials, and permissions work.

  4. Select folders on the server.

    Choose the folders PhotoPanel should use. The app loads images recursively from those selected folders and caches downloaded images for smoother playback.

Example: using a NAS as a WebDAV server

Many NAS systems can publish one shared folder through WebDAV. The names differ by manufacturer, but the pattern is usually the same: enable WebDAV on the NAS, choose a port, give one user read access to the photo folder, then enter that address in PhotoPanel.

Inside your home network

Example address: https://192.168.1.20:5006/Photos/. Use this when the iPad and NAS are on the same Wi-Fi.

From outside your home

Example address: https://photos.example.com/Photos/. Use HTTPS through a VPN or reverse proxy; avoid exposing plain HTTP to the internet.

For PhotoPanel, create a dedicated NAS user with read-only access to the photo share when possible. That keeps the app simple to revoke and avoids giving it unnecessary access to private documents or backups.

HTTPS and certificates

Use HTTPS whenever possible. If your NAS uses a self-signed certificate, PhotoPanel asks before trusting it. If the certificate changes later, confirm it only if you know why it changed.

HTTP is for trusted networks only

Unencrypted HTTP can expose your password and photos on the network. Enable it only for a private network you control, or use a VPN/reverse proxy with HTTPS.

Nextcloud’s official WebDAV manual explains app passwords, URL formats, and common WebDAV clients: Accessing Nextcloud files using WebDAV.

Immich: albums from your self-hosted photo server

Immich is a self-hosted photo and video server. PhotoPanel connects to Immich with a server address and API key, reads your Immich albums, and downloads full-size images for the slideshow.

PhotoPanel Immich connection settings

  1. Create an API key in Immich.

    In the Immich web interface, create an API key for PhotoPanel. Give it the permissions album.read, asset.read, asset.view, and asset.download.

  2. Enter the Immich server address.

    You can enter the address with or without /api. PhotoPanel normalizes it automatically.

  3. Paste the API key and test the connection.

    The API key is stored in the iOS Keychain. A successful test shows the Immich version and how many albums were found.

  4. Select Immich albums.

    PhotoPanel lists your Immich albums, including shared albums when the API key can access them. Select the albums you want to use and save.

Good to know

PhotoPanel uses still images from Immich albums. Videos and Live Photos are not played as animated media through this source. Location and date information can appear when Immich provides it for the asset.

Immich documents API keys and permissions in its official API reference. The current API documentation is available at api.immich.app.

Troubleshooting and practical tips

No photos appear

Check that at least one folder or album is selected and enabled, that it contains supported image files, and that the server or drive is reachable.

First load is slow

Network folders and cloud services need time for the first scan. Keep the app open until the first images appear.

A folder is no longer accessible

For Files folders, select the folder again. For WebDAV and Immich, test the connection and check password/API-key permissions.

Certificate warning

Confirm only certificates you recognize. A certificate change can be normal after renewal, but it can also indicate the wrong server.

Überblick: woher PhotoPanel Fotos laden kann

PhotoPanel kann weiterhin Alben aus Apple Fotos verwenden. In der aktuellen App-Version kannst du aber auch andere Orte auswählen, an denen deine Bilder liegen. Eine Fotoquelle ist sozusagen das Regal, in dem PhotoPanel vor dem Start der Diashow nach Bildern schaut.

PhotoPanel Auswahl der Fotoquelle

Dateien

Gut für lokale Ordner, iCloud Drive, SMB-Freigaben, USB-Sticks, SD-Karten und externe Laufwerke, die in der Dateien-App sichtbar sind.

WebDAV

Gut für NAS-Systeme, Nextcloud, ownCloud und andere Server, die Ordner per WebDAV bereitstellen.

Immich

Gut, wenn deine Fotos in einem selbst betriebenen Immich-Server liegen und dort in Alben organisiert sind.

Wichtig: Live Photos unterstützt PhotoPanel nur über Apple Fotos. Dateien, WebDAV und Immich werden als Quellen für Standbilder verwendet. EXIF-Datum und Standort können trotzdem angezeigt werden, wenn die Bilddatei oder der Server diese Informationen liefert.

Dateien-App: lokale Ordner, iCloud Drive, SMB und externe Laufwerke

Die Quelle „Dateien“ nutzt Apples normalen Ordner-Auswahldialog. Alles, was in der Dateien-App als Ordner erscheint, kann in der Regel gewählt werden: „Auf meinem iPad“, iCloud Drive, verbundene SMB-Dateiserver, USB-Sticks, SD-Karten und externe Festplatten.

PhotoPanel Einstellungen für die Dateien-Quelle

  1. Bereite den Ordner in der Dateien-App vor.

    Lege deine Fotos in einen oder mehrere Ordner. Unterordner sind in Ordnung: PhotoPanel durchsucht ausgewählte Ordner rekursiv und ignoriert versteckte Dateien und App-Pakete.

  2. Öffne die PhotoPanel-Einstellungen und wähle Dateien.

    Drücke länger auf die Diashow, öffne die Auswahl der Fotoquelle und wähle Dateien.

  3. Tippe auf „Ordner auswählen“ und wähle einen oder mehrere Ordner.

    iOS fragt nach Zugriff auf diese Ordner. PhotoPanel speichert diese Berechtigung als sicheres Lesezeichen, damit der Ordner später wieder geöffnet werden kann.

  4. Starte die Diashow.

    Der erste Scan kann etwas dauern, besonders bei Cloud-Ordnern, USB-Laufwerken oder Netzwerkfreigaben. Danach funktionieren die normalen Diashow-Funktionen wie gewohnt.

Einen SMB-Server in die Dateien-App einbinden

SMB ist die klassische Windows-Dateifreigabe, die auch viele NAS-Systeme, Macs, PCs und Router mit angeschlossenem Speicher verwenden. PhotoPanel verbindet sich nicht direkt mit SMB; stattdessen bindest du die SMB-Freigabe zuerst in Apples Dateien-App ein und wählst diesen Ordner danach in PhotoPanel aus.

  1. 1. Dateien öffnen. Öffne auf iPhone oder iPad die App Dateien und wechsle zum Tab Durchsuchen.
  2. 2. Menü öffnen. Tippe auf die Taste mit den drei Punkten und wähle Mit Server verbinden.
  3. 3. Serveradresse eingeben. Verwende zum Beispiel smb://192.168.1.20 oder smb://nas.local. Wenn eine Freigabe direkt angegeben werden soll, kann die Adresse auch so aussehen: smb://nas.local/Fotos.
  4. 4. Anmelden. Wähle Registrierter Benutzer, wenn Benutzername und Passwort nötig sind. Gast solltest du nur für Freigaben verwenden, die in deinem privaten Netzwerk bewusst öffentlich sind.
  5. 5. Freigabe in PhotoPanel auswählen. Sobald der Server in Dateien sichtbar ist, öffne PhotoPanel, wähle Dateien, tippe auf Ordner auswählen, navigiere zur SMB-Freigabe und wähle den Fotoordner.

Tipp: Gib deinem NAS eine feste IP-Adresse oder einen stabilen lokalen Namen. Wenn sich die Adresse ändert, kann die Dateien-App die Verbindung verlieren und PhotoPanel muss den Ordner möglicherweise erneut auswählen lassen.

Was gut funktioniert

JPEG, PNG, HEIC, TIFF, WebP, GIF, BMP und andere Dateitypen, die iOS als Bilder erkennt. Externe Laufwerke sind mit APFS oder ExFAT meist am unkompliziertesten.

Worauf du achten solltest

Cloud-Platzhalter müssen eventuell erst geladen werden. Wenn ein Ordner verschwindet oder iOS den Zugriff verliert, wähle den Ordner in PhotoPanel erneut aus.

Apples Dateien-App kann externe Speicher, Dateiserver und Cloud-Dienste einbinden. Apple erklärt die Grundlagen im iPhone-Handbuch zu Dateien, Servern und externem Speicher.

WebDAV: NAS, Nextcloud und entfernte Ordner

WebDAV ist ein Standard, mit dem Ordner auf einem Server über das Netzwerk durchstöbert werden können. Das ist praktisch, wenn deine Fotos auf einem NAS, in Nextcloud, ownCloud oder auf einem anderen Server liegen und du nicht alles in Apple Fotos kopieren möchtest.

PhotoPanel WebDAV-Einstellungen für einen Nextcloud-Server

  1. Finde die WebDAV-Adresse.

    Bei Nextcloud sieht sie oft so aus: https://cloud.example.com/remote.php/dav/files/BENUTZERNAME/. Nextcloud zeigt die genaue WebDAV-URL auch in den Datei-Einstellungen an.

  2. Trage Serveradresse, Benutzername und Passwort ein.

    PhotoPanel speichert das Passwort im iOS-Schlüsselbund. Wenn dein Server App-Passwörter unterstützt, verwende lieber ein App-Passwort statt deines Hauptpassworts.

  3. Teste und speichere die Verbindung.

    PhotoPanel sendet eine kleine WebDAV-Anfrage, um Server, Zugangsdaten und Berechtigungen zu prüfen.

  4. Wähle Ordner auf dem Server aus.

    Wähle die Ordner, die PhotoPanel verwenden soll. Die App lädt Bilder rekursiv aus diesen Ordnern und puffert heruntergeladene Bilder für eine flüssigere Wiedergabe.

Beispiel: ein NAS als WebDAV-Server verwenden

Viele NAS-Systeme können einen freigegebenen Ordner per WebDAV bereitstellen. Die Bezeichnungen unterscheiden sich je nach Hersteller, das Prinzip ist aber meistens gleich: WebDAV auf dem NAS aktivieren, Port festlegen, einem Benutzer Leserechte auf den Fotoordner geben und diese Adresse in PhotoPanel eintragen.

Im Heimnetz

Beispieladresse: https://192.168.1.20:5006/Fotos/. Das passt, wenn iPad und NAS im selben WLAN sind.

Von unterwegs

Beispieladresse: https://fotos.example.com/Fotos/. Verwende HTTPS über VPN oder Reverse Proxy; unverschlüsseltes HTTP sollte nicht aus dem Internet erreichbar sein.

Lege für PhotoPanel nach Möglichkeit einen eigenen NAS-Benutzer mit reinem Lesezugriff auf die Fotofreigabe an. So lässt sich der Zugriff leicht wieder entziehen und die App erhält keinen unnötigen Zugriff auf private Dokumente oder Backups.

HTTPS und Zertifikate

Verwende möglichst HTTPS. Wenn dein NAS ein selbstsigniertes Zertifikat nutzt, fragt PhotoPanel vor dem Vertrauen nach. Wenn sich das Zertifikat später ändert, bestätige es nur, wenn du den Grund kennst.

HTTP nur in vertrauenswürdigen Netzwerken

Unverschlüsseltes HTTP kann Passwort und Fotos im Netzwerk offenlegen. Aktiviere es nur in einem privaten Netzwerk, das du kontrollierst, oder nutze VPN bzw. einen Reverse Proxy mit HTTPS.

Das offizielle Nextcloud-Handbuch erklärt App-Passwörter, URL-Formate und typische WebDAV-Clients: Nextcloud-Dateien über WebDAV verwenden.

Immich: Alben von deinem eigenen Fotoserver

Immich ist ein selbst betriebener Foto- und Videoserver. PhotoPanel verbindet sich mit Serveradresse und API-Key, liest deine Immich-Alben und lädt die Bilder in voller Größe für die Diashow.

PhotoPanel Immich-Verbindungseinstellungen

  1. Erstelle in Immich einen API-Key.

    Erstelle in der Immich-Weboberfläche einen API-Key für PhotoPanel. Gib ihm die Berechtigungen album.read, asset.read, asset.view und asset.download.

  2. Trage die Immich-Serveradresse ein.

    Du kannst die Adresse mit oder ohne /api eingeben. PhotoPanel normalisiert sie automatisch.

  3. Füge den API-Key ein und teste die Verbindung.

    Der API-Key wird im iOS-Schlüsselbund gespeichert. Ein erfolgreicher Test zeigt die Immich-Version und wie viele Alben gefunden wurden.

  4. Wähle Immich-Alben aus.

    PhotoPanel listet deine Immich-Alben auf, inklusive geteilter Alben, wenn der API-Key darauf zugreifen darf. Wähle die gewünschten Alben aus und speichere.

Gut zu wissen

PhotoPanel verwendet aus Immich-Alben Standbilder. Videos und Live Photos werden über diese Quelle nicht als animierte Medien abgespielt. Standort und Datum können erscheinen, wenn Immich diese Daten für das Bild liefert.

Immich dokumentiert API-Keys und Berechtigungen in der offiziellen API-Referenz. Die aktuelle API-Dokumentation findest du unter api.immich.app.

Fehlersuche und praktische Tipps

Es erscheinen keine Fotos

Prüfe, ob mindestens ein Ordner oder Album ausgewählt und aktiviert ist, ob unterstützte Bilddateien enthalten sind und ob Server oder Laufwerk erreichbar sind.

Der erste Ladevorgang ist langsam

Netzwerkordner und Cloud-Dienste brauchen beim ersten Scan Zeit. Lass die App geöffnet, bis die ersten Bilder erscheinen.

Ein Ordner ist nicht mehr erreichbar

Bei Dateien-Ordnern wähle den Ordner erneut aus. Bei WebDAV und Immich teste die Verbindung und prüfe Passwort bzw. API-Key-Berechtigungen.

Zertifikatswarnung

Bestätige nur Zertifikate, die du wiedererkennst. Eine Änderung kann nach einer Erneuerung normal sein, kann aber auch auf einen falschen Server hinweisen.