You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This is a major upgrade. A one-time database migration runs on first
startup; back up your config directory before upgrading.
Editing tags writes to your comic files; the comics directory must be
mounted writable with write permission for tag editing to work.
Breaking Changes
Admin settings (SMTP, rate limits, browser page size, cover upload size)
moved from codex.toml into the Admin UI and are now editable without a
restart. Existing values are imported automatically on upgrade; those codex.toml sections are deprecated.
Custom covers are now managed in the web UI. Legacy filesystem covers
(in-library .codex-cover.* files and the covers-only library) migrate
automatically on first startup.
The browser and reader page URLs changed; bookmarks to specific pages may
need re-navigating from the home screen. OPDS apps reconnect on their own.
The HTTP API moved from /api/v3/ to /api/v4/.
Fixes
OPDS 1.2, 2.0, and OpenSearch feeds are now spec-compliant.
Folder covers respect favorites.
Critical ratings normalized to a consistent 0–5 scale.
The age-rating "As Tagged" panel hides when it has no entries.
Hovering a comic's tag icon no longer re-runs the on-demand tag importer
forever on comics with few or no embedded tags.
Browser refreshes more often when comics change. container restarts.
Features
Edit the tags on one or many comics directly in the browser — credits,
story arcs, identifiers, and more — written back to your comic files.
Online tagging: look up and apply metadata from online sources, with
interactive match prompts, rate-limit display, and per-source credentials
in the new Admin Tagging tab. Or tag a single comic directly by a known
Metron or Comic Vine issue id or URL, skipping the search.
Upload, replace, and remove custom covers for any group from the web UI,
plus a Custom Covers admin tab.
Back up and restore all user data — accounts, bookmarks, favorites,
settings, libraries — via a user_data.sqlite sidecar, the Admin Restore
tab, or codex restore_user_data. Snapshotted nightly.
Optional self-service password reset, and email verification for new
sign-ups (both require SMTP).
New user Profile dialog for self-service username, email, and API token
(moved here from the sidebar).
Database and user-data backups are now compressed, dated, and auto-pruned.
Redesigned admin panel has moves settings under relevant tabs.
Performance
Library imports are faster: forced re-imports run over 20x faster, fresh
imports almost 4x, and polls that find nothing changed are now nearly
instant — no more rewriting every comic, regenerating every cover, and
refreshing every browser on a no-op poll.
Browsing large libraries is faster: table, search, and sorted folder views
that could take minutes now load in about a second, metadata works on
collections of any size, and browsing stays responsive during imports.