🪸 Coral

A reef of independent Docker modules that extend Jellyfin with modern UX.

Each one alive on its own — thriving together.

---

The Modules

Module	What it does	Status
🎬 Aurora	High-end cinematic Jellyfin frontend	🟢 In Progress
🎤 KAPOW!	Karaoke queue manager for bars & events	🟡 MVP Built
🌊 Tide	Torrent downloads with a calmer control surface	🟢 Shipping
📖 Fathom	Modern reading app from your NAS	⚪ Planned
📺 Marquee	Ambient now-playing display	⚪ Planned
🎶 Encore	Guest media request system	⚪ Planned
🗂️ Librarian	Smart media management layer	⚪ Planned

Shared Packages

Package	What it does
📦 create-coral	Scaffold a new Coral module from the official template
📦 @get-coral/jellyfin	TypeScript Jellyfin API client
📦 @get-coral/biome-config	Shared Biome configuration for Coral repositories
📦 @get-coral/tsconfig	Shared TypeScript configuration for Coral repositories

---

Three Rules

🐳 Docker native — Every module ships as a container. One Compose file, one command, running on your NAS.

🪸 Jellyfin as source of truth — Modules never share a database. Communication happens through the Jellyfin API.

🔓 MIT forever — No paid tier, no SaaS, no cloud dependency. Sponsor if it brings you value.

---

Get Started

# docker-compose.yml
services:
  kapow:
    image: ghcr.io/get-coral/kapow:latest
    ports: ["3000:3000"]
    environment:
      JELLYFIN_URL: http://your-nas:8096
      JELLYFIN_API_KEY: your_key
  db:
    image: postgres:alpine

---

Contributing

All modules are open to contributions. Each repo has its own CONTRIBUTING.md. Found a bug? Open an issue in the relevant module repo. Have a module idea? Start a discussion.

---

_{Built by @ElianCodes · Born at Comic Sans bar in Ghent 🍺}