Mydia

Your personal media companion, built with Phoenix LiveView

A modern, self-hosted media management platform for tracking, organizing, and monitoring your movies and TV shows.

Warning: Mydia is in early development (0.x.x). Expect breaking changes. Report issues or request features.

Quick Start

1. Generate secrets:

openssl rand -base64 48  # SECRET_KEY_BASE
openssl rand -base64 48  # GUARDIAN_SECRET_KEY

2. Create docker-compose.yml:

services:
  mydia:
    image: ghcr.io/getmydia/mydia:latest
    container_name: mydia
    environment:
      - PUID=1000
      - PGID=1000
      - TZ=America/New_York
      - SECRET_KEY_BASE=your-secret-key-base-here
      - GUARDIAN_SECRET_KEY=your-guardian-secret-key-here
      - PHX_HOST=localhost
      - MOVIES_PATH=/media/library/movies
      - TV_PATH=/media/library/tv
    volumes:
      - ./config:/config
      - /path/to/media:/media
    ports:
      - 4000:4000
    restart: unless-stopped

3. Start and access:

docker compose up -d

Open http://localhost:4000 and create your admin account.

Features

• Unified Media Management - Movies + TV shows with TMDB/TVDB metadata
• Automated Downloads - Quality profiles, smart release ranking
• Download Clients - qBittorrent, Transmission, rqbit, SABnzbd, NZBGet, debrid providers
• Indexers - Prowlarr, Jackett, built-in Cardigann (experimental)
• Multi-User - Admin/guest roles with request workflow
• SSO - Local auth + OIDC/OpenID Connect
• Import Lists - Sync from TMDB watchlists, popular, trending (experimental)
• Real-Time UI - Phoenix LiveView with instant updates

Mydia Player

A cross-platform app that streams your library from anywhere over an encrypted peer-to-peer connection. No port forwarding, no VPN.

Platform	Get it	Notes
Android	Download APK	Allow installs from unknown sources
iOS	Join the TestFlight beta	Needs the TestFlight app
macOS	Download .dmg	Notarized, updates itself
Windows	Download installer	Per-user install, unsigned build
Linux	Flatpak or .tar.gz	Flatpak recommended
Web	Served by your own Mydia server at /player	Nothing to install

All platforms and install instructions

Documentation

Full documentation available at docs.mydia.dev

• Tutorials - get Mydia running from scratch
• How-to guides - install, connect clients and indexers, deploy
• Reference - environment variables, configuration, database, API
• Explanation - how Mydia works and why
• Contributing - development setup

Screenshots

Movies	TV Shows	Calendar

Contributing

./dev up -d              # Start development environment
./dev mix ecto.migrate   # Run migrations
./dev mix test           # Run tests
./dev mix precommit      # Run all checks

See the Development Guide for details.

Documentation

Docs are built with MkDocs and Material for MkDocs. Requires uv.

uv sync --project docs            # Install dependencies
uv run --project docs mkdocs serve   # Serve at http://localhost:8000
uv run --project docs mkdocs build   # Build static site to /site

License

Built with Elixir & Phoenix