forked from FrederikBaerentsen/ComicOPDS
2.0 KiB
2.0 KiB
📱 Clients
Supported Clients
| App | Downloads | Search | Streaming |
|---|---|---|---|
| Panels (iOS) | ✔️ | ✔️ | ✔️ |
| KyBook 3 (iOS) | ✔️ | ✔️ | ❌ |
| Cantook (iOS) | ✔️ | ❌ | ❌ |
| Marvin 3 (iOS) | ✔️ | ❌ | ❌ |
| Chunky (iOS) | ✔️ | ❌ | ❌ |
Panels for iOS
- Open Panels → Library → Connect Service → OPDS
- URL: Your OPDS root (e.g.,
https://comics.example.com/) - Username/Password: If you enabled Basic Auth
- Panels will display covers and use your folder structure for browsing
Client-Specific Notes
- Some clients work better with smaller
PAGE_SIZE(e.g., 25 instead of 50) - Page streaming (PSE 1.1) requires client support
- Thumbnail quality may vary between clients
Notes on Clients and HTTPS
Most OPDS clients (Panels, Marvin, Thorium, Chunky, etc.) work fine over plain http:// when you are on your local network or connected with a standard VPN (e.g. WireGuard, OpenVPN).
⚠️ iOS requirement: When connecting outside your local network, iOS apps typically require https://.
This is because of Apple's App Transport Security (ATS) rules, which block insecure external requests.
- If you use a traditional VPN, you can usually keep using
http://on the VPN tunnel. - If you use Tailscale, be aware that iOS does not treat Tailscale connections as a "real VPN" and still enforces HTTPS.
- The solution is to set up a valid HTTPS certificate (e.g. via Let's Encrypt) and reverse proxy (Traefik, Nginx, Caddy, etc.).
👉 This project does not provide networking or HTTPS setup guides, but be aware that if you plan to access ComicOPDS outside your LAN (or via Tailscale on iOS), you'll need to serve it over HTTPS.