Ἁρμονία (Harmonia): "the fitting together of disparate parts"
Unified self-hosted media platform. Rust monorepo with a server binary intended to replace the *arr stack as a full media lifecycle manager.
Single Tokio/Axum/SQLite server with 21 workspace crates under crates/.
crates/theatron/desktop is an excluded Dioxus desktop package; canonical
STATE.md tracks that desktop port as the remaining Phase 3.5 scope.
| Layer | Crates | Purpose |
|---|---|---|
| Core | aggelmata, apotheke, horismos | Shared types, SQLite storage, configuration |
| Auth | exousia | JWT authentication, argon2 password hashing |
| Media ops | kathodos, komide, epignosis, kritike | Import/rename, library scanning, metadata enrichment, quality verification |
| Acquisition | eksetasis, ergasia, syntaxis, aitesis | Torznab search, download execution, queue orchestration, household requests |
| Serving | paroche, syndesmos, syndesis, prostheke | HTTP streaming, external integrations (Plex, Last.fm, Tidal), QUIC renderer transport, subtitles |
| Audio | akouo-core | Bit-perfect decode, DSP (EQ, crossfeed, ReplayGain), native audio output |
| UI | theatron-core | Dioxus desktop types and API client |
| Binary | archon | harmonia CLI for serve, db, play, render, migrate, and local mcp modes |
| Convert | harmonia-convert | Ebook format conversion (Calibre, kepubify, pandoc) |
- Shipped / wired to routes: auth, library scan/import (kathodos), feed scheduler (komide), torrent download engine (ergasia), queue orchestration (syntaxis), HTTP/OpenSubsonic API (paroche), external integrations (syndesmos), QUIC renderer transport (syndesis), audio pipeline (akouo-core), post-download import (
archon::ImportAdapter- a completed download lands in the library for music/movie/book wants; audiobook/comic/podcast/tv_series wants have no library type yet and are deferred, #612). - Initialized, adapter-backed or fallback-only at HTTP layer: the live
servepath wires adapter structs for search, download execution, queue management, requests, external integrations, subtitles, and renderer registry. It still uses 2 null placeholders for metadata resolution and curation. The fallback/testAppState::with_stubspath defines 9Null*service implementations.
For current planning, blockers, and phase status, see the canonical project state maintained with the internal planning records.
Linux (Debian/Ubuntu): the akouo-core audio pipeline pulls cpal -> alsa-sys, which needs the ALSA development headers at build time. Install before the first cargo check:
sudo apt-get install --no-install-recommends libasound2-dev pkg-configmacOS builds out of the box against CoreAudio.
cargo check --workspace
cargo test --workspace
cargo clippy --workspace --all-targets -- -D warnings- CLAUDE.md: repo conventions and standards links (canonical standards live in kanon
crates/basanos/standards/) - docs/lexicon.md: Project name registry
AGPL-3.0-or-later. See NOTICE for supplemental terms.