Fathom

Fathom is the Coral reading room. It connects to Jellyfin and turns reading libraries into a cleaner browsing experience with a featured shelf, recent additions, library browsing, collection browsing, and rich title details with metadata.

Version

Current version: 0.1.0
GHCR image: ghcr.io/get-coral/fathom

A cover-first interface designed for a calm, focused reading experience.

What It Is

Fathom provides:

Featured shelf - Curated reading selections
Recent additions - New books, manga, comics
Library browsing - Organized by collections
Collection browsing - Group related content
Title detail - Complete metadata and contributor information
Local connection - SQLite-backed Jellyfin settings, with .env support

Supported Media

Books (EPUB, PDF, etc.)
Manga
Comics
Audiobooks and more

Getting Started

Prerequisites

Node.js 18+
pnpm (or npm/yarn)
Running Jellyfin server with reading library

Installation

Clone the repository:

git clone https://github.com/Get-Coral/fathom.git
cd fathom

Install dependencies:

pnpm install

Configure environment variables:

JELLYFIN_URL=http://your-server:8096
JELLYFIN_API_KEY=your-api-key
JELLYFIN_USER_ID=your-user-id

Connection details can also be configured in the web UI on first run, and will be stored locally in SQLite.

Start the development server:

pnpm dev

Fathom runs on http://localhost:3000

Configuration

Fathom supports the same connection model as other Coral modules.

Environment Variables

JELLYFIN_URL=http://your-server:8096
JELLYFIN_API_KEY=your-api-key
JELLYFIN_USER_ID=your-user-id

If these are not set, Fathom will open a setup screen on first run and store the connection details locally.

Local Storage

Connection settings are stored in SQLite at ./data/fathom.sqlite for a self-hosted setup without external database requirements.

Features

Browse

View all reading libraries
Browse by collection
Search across your library
Filter by media type

Discover

Featured and highlighted titles
Recent additions
Curated collections
Recommendation algorithms

Reading Management

Track reading progress
Mark as favorites
Create personal collections
Rating and reviews

Library Metadata

Full book information
Contributors and authors
Descriptions and summaries
Cover art and thumbnails

Development

Fathom is built with:

TanStack Start
React 19
Tailwind CSS v4
Jellyfin API

Project Structure

src/routes/ - Page components
src/components/ - Reusable UI components
src/lib/ - Utilities and helpers
src/data/ - Data directory for SQLite

Deployment

Deploy Fathom to:

Vercel
Docker
Self-hosted servers

For production:

pnpm build
pnpm preview

Learn More

Jellyfin API Client - Building custom reading interfaces
Contributing - Extend Fathom

Repository

Get-Coral/fathom on GitHub