samo-server

Samo-server is a self-hosted audio server that treats music, audiobooks, podcasts, and radio as first-class domains sharing a single library, queue, and playback history. It is not a wrapper around existing solutions like Navidrome or Audiobookshelf. Deployment is handled via a single Docker Compose command. A web-based setup wizard at port 6969 guides initial configuration, including admin account creation and library folder setup. Media directories are mounted read-only by default to protect against scanner bugs, with an option to enable a writable music directory for the "Keep in Library" feature. The server uses host networking to support LAN autodiscovery via UDP port 7360, allowing companion Android and desktop clients to find the server automatically. The bundled PostgreSQL database runs without a network listener or password, communicating over a shared Unix socket. Core capabilities include scanning local media folders using bundled ffmpeg, managing podcast RSS feeds and internet radio streams, and running 24/7 custom radio channels programmed from the user's library. The server streams original files, serves artwork, records playback history, and optionally scrobbles to Last.fm. It exposes a native /api/v1 interface and a read-only Subsonic adapter.