MyAnimeList

MyAnimeList is a small self-hosted anime tracker and playback app. It keeps the catalog, watchlist, progress tracking, and player in one place, backed by a single SQLite database and a single Go server.

Most of the UI is rendered on the server. HTMX handles lightweight updates like search, pagination, and watchlist changes, while TypeScript is kept for the parts that need real browser state: the video player, command palette, theme handling, and skip segment editor. The app also includes local users, API tokens, subtitle support, playlist rewriting, provider integrations, migrations, and startup data fixes.

Running

Requires Go 1.25+, Bun, just, and a C compiler for SQLite.

bun install
just build
go run ./cmd/user <username> <password>
just dev

The app starts on http://localhost:3000 by default. Configuration comes from environment variables, and a local .env file is loaded automatically. The most useful options are PORT, DATABASE_FILE, PLAYBACK_PROXY_SECRET, EPISODE_AVAILABILITY_MODE, and ANIMESCHEDULE_API_TOKEN.

Development

The codebase is split between Go feature packages, external integrations, server-rendered templates, and a small frontend asset pipeline. cmd/server starts the web app, cmd/user contains local admin tools, internal holds the application modules, integrations holds provider clients, and templates, static, and dist contain the UI.

The common development commands are in the justfile.

just fmt
just test
just lint-go
just lint-ts
just typecheck
just build

Run the full local check with:

just check

License

MIT. See LICENSE.