Komic Deep Links

Komic registers the komic:// URL scheme on iPhone and iPad. You can use it from widgets, Shortcuts, Safari, notes, webpages, or your own tooling to jump into supported parts of the app.

Public Deep Links

These routes are meant for navigation inside Komic:

Route	Opens
komic://book/{bookId}	A specific book
komic://series/{seriesId}	A specific series
komic://authors/{role}/{name}	An author filter, such as writer or penciller
komic://metadata/{kind}/{value}	A metadata filter
komic://collections/{collectionId}	A collection
komic://readlists/{readListId}	A read list

All public routes also accept an optional server query item when you have more than one server configured in Komic.

Server Selection

Use ?server= to target a specific configured server. Komic accepts any of these values:

• The configured server name
• The configured server URL
• The configured server host, such as komga.example.com

Examples:

• komic://book/12345?server=https%3A%2F%2Fkomga.example.com
• komic://series/abc123?server=My%20Komga

Supported Metadata Kinds

kind must be one of:

• publisher
• character
• location
• team

Examples

• komic://book/12345
• komic://series/abc123
• komic://authors/writer/John%20Doe
• komic://metadata/publisher/Image%20Comics
• komic://collections/a1b2c3
• komic://readlists/d4e5f6

Where IDs Come From

Book, series, collection, and read list links use the same IDs returned by your Komga or Kavita server APIs. Komic does not invent a second identifier format for deep links.

This is the practical mapping:

• bookId: a server book ID
• seriesId: a server series ID
• collectionId: a server collection ID
• readListId: a server read list ID
• role, name, kind, and value: the metadata values shown by Komic

Notes

• Komic must be installed for komic:// links to open.
• If server matches multiple configured servers, Komic will ignore the match instead of guessing.
• If a link points to content that no longer exists on the active server, Komic will fail to open it.