milmil

Self-hosted anime media server
_{Media library management, seasonal calendar, trending anime, danmaku playback}

English | 日本語 | 한국어 | 简体中文 | 繁體中文（台灣） | 粵語

Features • Screenshots • macOS App • Quick Start • Deployment • Configuration • Development • Contributing • License

_{Home — Featured carousel, today's schedule, trending rankings}

_{Discover — Trending now, genre filters, top of the season}

_{Schedule — Seasonal anime organized by day and airtime}

_{Anime detail — Episode list, character info, YouTube trailer}

_{Watch — Player with danmaku overlay and external source picker}

_{Home — shelves, today's schedule and trending}

_{Player — mpv playback with the danmaku bar and episode rail}

.dmg` from the [latest release](https://github.com/milmil-dev/milmil/releases/latest). > [!NOTE] > The app is ad-hoc signed and not notarized, so macOS blocks the first launch. Right-click **milmil.app** and choose **Open** (then **System Settings › Privacy & Security › Open Anyway** if macOS still refuses), or clear the flag yourself with `xattr -d com.apple.quarantine /Applications/milmil.app`. Homebrew's `--no-quarantine` was removed in Homebrew 6. ### Requirements - **macOS 15 (Sequoia)** or later - **Apple Silicon** only — there is no Intel build - A reachable milmil server (0.1.20 or later) Full guide: [macOS App](https://milmil.vercel.app/en/docs/getting-started/macos). --- ## Features ### Library Management - **Multi-source storage** — local filesystem, SMB, SFTP, and 40+ cloud backends via rclone - **Automatic scanning** — configurable scan intervals with FFmpeg metadata extraction - **File matching** — multi-provider anime identification (DandanPlay hash, Bangumi, TMDB, AniList) - **Episode resolution** — automatic episode metadata enrichment from multiple sources ### Discovery - **Seasonal calendar** — new anime releases by day of week - **Trending** — popular anime rankings from Bangumi - **Search** — full-text search across anime databases - **Genre & tag browsing** — filter by genre, year, season, format, and score ### Playback - **Direct streaming** — byte-range requests for compatible formats - **Container remuxing** — MKV to MP4 without transcoding - **HLS transcoding** — FFmpeg-based adaptive streaming with session caching - **Danmaku** — bullet comment overlay from 弹弹play开放弹幕网络（DandanPlay） - **Subtitle support** — embedded and external subtitle tracks - **Watch progress** — automatic position saving and resume - **External player support** — connect Infuse, VLC, Kodi, and mpv via Jellyfin-compatible API with LAN auto-discovery ### Downloads - **Built-in torrent client** — anacrolix/torrent with configurable seeding - **HTTP downloads** — direct file downloads with resume support - **RSS auto-download** — subscribe to anime with regex filters, resolution/subgroup preferences - **Torrent search** — aggregated search across Nyaa, DMHY, Mikan, Bangumi.moe, ACG.rip - **Post-download pipeline** — automatic scan, match, and resolve on completion ### Collection - **Watch status** — planning, watching, completed, paused, dropped - **User ratings** — personal scoring system - **Recent history** — continue watching from where you left off - **Bangumi & AniList sync** — OAuth-based list synchronization ### System - **PWA** — installable progressive web app with offline support - **i18n** — English, Japanese, Korean, Simplified Chinese, Traditional Chinese (TW/HK) - **Notifications** — real-time WebSocket push for download/scan events - **Two-factor auth** — TOTP-based 2FA - **Settings export/import** — full configuration backup --- ## Tech Stack | Layer | Technology | |-------|-----------| | Backend | Go 1.27, Echo v5, SQLite / PostgreSQL | | Frontend | React 19, TanStack Router, Tailwind CSS v4 | | State | Zustand (UI), TanStack Query (server) | | Bundler | Vite 8, Bun | | Styling | Tailwind CSS v4, shadcn/ui, Hugeicons | | Animation | Motion (Framer Motion) | | i18n | Lingui v5 | | Video | Video.js, FFmpeg | | PWA | Serwist | | Cache | Redis (optional, in-memory fallback) | | Testing | Vitest, Playwright, Go testing | | Linting | Vite+ (Oxlint/Oxfmt), Lefthook, Commitlint | | macOS client | Swift 6, SwiftUI, libmpv (MPVKit), Core Animation | --- ## Quick Start **Docker (recommended):** ```bash git clone https://github.com/milmil-dev/milmil.git cd milmil cp .env.example .env cp api/.env.example api/.env # Set JWT_SECRET in api/.env (required, 32+ chars) openssl rand -hex 32 docker compose up -d ``` Then open [http://localhost:3000](http://localhost:3000) and run the setup wizard. Full install guide: [docs-site/content/docs/getting-started/installation.mdx](docs-site/content/docs/getting-started/installation.mdx). **From source** (Go 1.27+, Bun 1.3+, FFmpeg): ```bash make setup make dev ``` API runs at `http://localhost:8080`, frontend at `http://localhost:5173`. --- ## Deployment See [docs-site/content/docs/getting-started/docker.mdx](docs-site/content/docs/getting-started/docker.mdx) for env variables, compose profiles (`--profile postgres`), volumes, and reverse-proxy setup. --- ## Configuration ### Environment Variables | Variable | Default | Description | |----------|---------|-------------| | `DATABASE_URL` | `sqlite://data/milmil.db` | Database connection string | | `REDIS_URL` | — | Redis URL (optional in dev) | | `JWT_SECRET` | — | JWT signing key (min 32 chars, required) | | `MILMIL_ENCRYPTION_KEY` | — | AES-256 key for storage credentials | | `API_PORT` | `8080` | API server port | | `DATA_DIR` | `./data` | Downloads and transcode cache | | `TORRENT_LISTEN_PORT` | `42069` | Torrent DHT/peer port | | `SEED_RATIO` | `1.0` | Torrent seed ratio target | | `SEED_TIME_MINUTES` | `60` | Torrent seed duration | | `DANDANPLAY_APP_ID` | — | DandanPlay API credentials | | `DANDANPLAY_APP_SECRET` | — | DandanPlay API credentials | | `DEBUG` | `0` | Enable debug logging | ### External Integrations (Optional) | Service | Purpose | Setup | |---------|---------|-------| | **Bangumi** | Anime metadata, OAuth sync | Settings > Integrations | | **AniList** | Alternative metadata, OAuth sync | Settings > Integrations | | **弹弹play开放弹幕网络（DandanPlay）** | File matching, danmaku comments | Environment variables or Settings | | **TMDB** | TV show cross-referencing | Settings > Integrations | --- ## Development ### Project Structure ``` milmil/ api/ # Go backend cmd/server/ # Entry point internal/ api/ # HTTP handlers + router auth/ # JWT + 2FA cache/ # Redis / in-memory config/ # Environment config db/ # Database setup + migrations downloader/ # Torrent + HTTP engine ffmpeg/ # Transcoding integration/ # Bangumi, AniList, DandanPlay, TMDB matcher/ # Multi-provider anime matcher metadata/ # Metadata enrichment notification/ # Event notifications resolver/ # Episode resolver rss/ # RSS feed parsing scanner/ # Library file scanner storage/ # SMB/SFTP/local providers store/ # SQLc generated queries torrent/ # Torrent search providers worker/ # Background jobs ws/ # WebSocket hub migrations/ # SQL migrations web/ # React frontend src/ components/ # UI components hooks/ # Custom hooks lib/ # API clients, utilities locales/ # i18n translations (6 languages) pages/ # Page components routes/ # TanStack Router definitions store/ # Zustand stores styles/ # Global CSS + theme e2e/ # Playwright tests ``` ### Commands ```bash # Development make dev # Start both servers with hot reload make dev-api # API only (with air) make dev-web # Frontend only (with Vite) # Build make build # Production frontend build # Testing make test # Run all tests (Go + frontend) cd web && bun run test:run # Frontend unit tests cd web && bun run test:e2e # Playwright E2E tests # Quality make lint # Go vet + vp lint (Oxlint) cd web && bun run check:all # Typecheck + lint + format + test # i18n cd web && bun run i18n:extract # Extract translation strings cd web && bun run i18n:compile # Compile translations ``` ### Database - **Development:** SQLite (zero config) - **Production:** PostgreSQL 16+ - **Migrations:** auto-applied on startup via golang-migrate - **Queries:** SQL-first with sqlc code generation --- ## Supported Languages - English - Japanese (ja) - Korean (ko) - Simplified Chinese (zh-CN) - Traditional Chinese — Taiwan (zh-TW) - Traditional Chinese — Hong Kong (zh-HK) --- ## Contributing Contributions of all kinds are welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines. - Bug reports and feature requests: [GitHub Issues](https://github.com/milmil-dev/milmil/issues) - Code contributions: Fork → Create branch → Submit Pull Request --- ## Acknowledgements milmil is built on the shoulders of these excellent open-source projects and services: - [Bangumi](https://bangumi.tv) — Anime metadata and community - [AniList](https://anilist.co) — Anime tracking and metadata - [弹弹play开放弹幕网络（DandanPlay）](https://www.dandanplay.com) — Danmaku comments and file matching - [Seanime](https://github.com/5rahim/seanime) — Design inspiration --- ## Star History --- ## License milmil is licensed under the [GNU Affero General Public License v3.0](LICENSE). This means you are free to use, modify, and distribute milmil, but if you run a modified version as a network service, you must make the source code available to users of that service.