Skip to main content

Connect ComicVerse to Komga

ComicVerse is a free Komga client for iPhone and iPad. Add your server once and your whole Komga library is browsable, streamable, and downloadable from your device.

Before You Start​

You'll need ComicVerse on iPhone (iOS 17.6+) or iPad (iPadOS 17.6+), a running Komga server your device can reach, and your Komga email address and password. If you're connecting from outside your network, expose the server over HTTPS through a reverse proxy or a VPN first.

Add the Server​

You need your server's address, not its catalog URL. ComicVerse looks for the catalog itself.

  1. Open the Library tab, tap +, then Web Server
  2. Tap + to add a server
  3. Type the address you reach Komga on, such as comics.example.com. Include a port or base URL if you've set one. Komga's own default port is 25600
  4. Enter your Komga email address and password
  5. Tap Connect. ComicVerse finds the catalog and shows you what it can do with the server
  6. Tap Add This Server

Leave the name field blank and ComicVerse uses the name Komga reports for itself.

A full catalog URL still works

Already have https://comics.example.com/opds/v1.2/catalog written down? Paste it. ComicVerse tries what you typed before it goes looking. The bare address is just less to get wrong.

Komga publishes both /opds/v2/catalog and /opds/v1.2/catalog, and ComicVerse takes v2 when it can. The v2 catalog carries a page-by-page reading order and a reading-progress link, so streaming and progress sync both work straight away.

Browse and Read​

Tap the server to browse its catalog by library, series, and collection. On any comic, tap Stream (▶) to read it straight from the server, or Download (↓) to save it to your library for offline reading. The search field queries Komga itself, so it covers the whole library and not just what's loaded.

Pages arrive as you turn them, so a large comic starts instantly and nothing is written to your device. Komga supports streaming on both its catalogs: the v2 catalog lists each page directly, and the v1.2 catalog advertises the OPDS Page Streaming Extension.

Troubleshooting​

No catalog found at that address. Open https://<your-address>/opds/v1.2/catalog in Safari on the same device. If it prompts for credentials and then shows XML, the server is fine and the sign-in details are the problem. If it doesn't load at all, the address is wrong or the server isn't reachable from your device.

It won't connect over plain HTTP. ComicVerse only talks to servers over HTTPS. Put Komga behind a reverse proxy with a certificate, or reach it over a VPN.

It connects but the catalog is empty. Check that your Komga account has access to at least one library. Komga's per-user library restrictions apply to OPDS too.

Streaming won't start but downloads work. Check that your reverse proxy isn't rewriting the catalog feed and dropping the page-streaming links.

More fixes in the Troubleshooting guide.

See Also​