# Codex

> Codex is a self-hosted, open-source comic archive browser and reader supporting CBZ, CBR, CB7, CBT, PDF with OPDS, OIDC, and advanced library management.

- **Category:** Comics
- **Licence:** GPL-3.0
- **Latest version:** v2.5.7
- **Open source:** oss
- **Languages:** JavaScript, Python, Vue
- **Platforms:** Docker Compose
- **Tags:** PDF, Opds, OIDC, Home Assistant, Docker, Self Hosted, Comic reader, Cbz, Cbr, Cb7, Cbt, Comic Browser

## Description

Codex is a self-hosted web application for browsing and reading comic archives. It supports multiple formats and automatically imports new files added to your library folders. The interface lets you explore comics by publisher, series, volume, folder structure, or story arcs, with full-text search and flexible filtering. You can edit metadata tags directly in the browser, which writes changes back to the original files, and fetch metadata from online databases with interactive matching. The reader works on any screen size with configurable layouts and reading directions, and remembers your position and preferences per user. Access can be open or require accounts, with private libraries limited to specific groups and optional age gates. For authentication, it offers built-in accounts, OIDC integration with providers like Authentik and Authelia, and reverse-proxy header authentication. It also speaks OPDS 1 and 2 for e-reader apps, logs failed logins for fail2ban, and runs on modest hardware. Licensed under GPLv3, it installs via Docker, Docker Compose, Home Assistant, or a native Python package.

## Links

- [Homepage](https://github.com/ajslater/codex)
- [Website](https://codex-comic-reader.readthedocs.io)
- [Docker](ghcr.io/ajslater/codex)
- [Demo](https://demo.codex-reader.app/)
- [GitHub Repository](https://github.com/ajslater/codex)
- [Docker Images](https://github.com/ajslater/codex/pkgs/container/codex)
- [PyPI Package](https://pypi.org/project/codex/)
- [Discord Community](https://discord.gg/CU5kKxv7kg)
- [NEWS/Changelog](https://codex-comic-reader.readthedocs.io/NEWS/)

---
Source: https://selfhost.directory/project/codex