Privacy-first, self-hosted music server written in Go.
  • Go 69.3%
  • TypeScript 29.8%
  • Java 0.3%
  • CSS 0.2%
  • JavaScript 0.2%
  • Other 0.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
tgiachi 11077f40e1
All checks were successful
release / release (push) Successful in 36s
release / base (push) Has been skipped
release / image (amd64) (push) Has been skipped
release / image (arm64) (push) Has been skipped
release / manifest (push) Has been skipped
docs: split the README into pages under docs/
The README had grown to about 500 lines. It now holds the intro, a quick
start and an index, and the rest lives in docs/.

- docs: add docs/README.md as the index of all pages
- docs: move install, configuration, demo, providers, OpenSubsonic, API,
  security and backups, web app, Android app and development/releases
  to their own pages, text unchanged
- docs: split the feature list into five pages under docs/features/
- docs: rewrite internal anchors as links between the new pages
- chore: add docs to .dockerignore, next to README.md
2026-11-17 14:50:52 +01:00
.forgejo/workflows feat: publish the Docker image for ARM as well 2026-11-16 14:33:41 +01:00
android feat(android): add an Android app 2026-11-17 10:41:39 +01:00
cmd/sondad Merge pull request 'Release by itself at every merge' (#38) from ci/semantic-release into main 2026-11-16 12:09:16 +00:00
docs docs: split the README into pages under docs/ 2026-11-17 14:50:52 +01:00
internal feat: scan the libraries by themselves when their music changed 2026-11-16 13:05:09 +01:00
migrations feat: the radio stations are in the apps only when the person asks 2026-11-16 12:33:09 +01:00
web feat(web): talk to the Android app 2026-11-17 10:41:39 +01:00
.dockerignore docs: split the README into pages under docs/ 2026-11-17 14:50:52 +01:00
.gitignore feat: embed the built web app in sondad behind the webui build tag 2026-11-12 15:56:34 +01:00
.releaserc.json ci: release by itself at every merge, with semantic-release 2026-11-16 13:07:17 +01:00
CHANGELOG.md chore(release): 0.5.0 [skip ci] 2026-11-17 09:42:59 +00:00
compose.yaml docs: the Docker image is published 2026-11-16 12:51:50 +01:00
Dockerfile feat: publish the Docker image for ARM as well 2026-11-16 14:33:41 +01:00
go.mod chore: move the module path to git.kmalloc.org/squid/sonda 2026-11-15 17:30:29 +01:00
go.sum feat: the seek bar shows the waveform of the track 2026-11-13 17:35:00 +01:00
Makefile ci: release by itself at every merge, with semantic-release 2026-11-16 13:07:17 +01:00
README.md docs: split the README into pages under docs/ 2026-11-17 14:50:52 +01:00
sonda.example.toml feat: scan the libraries by themselves when their music changed 2026-11-16 13:05:09 +01:00

Sonda

This repository has moved. Development continues at git.kmalloc.org/squid/sonda; this Codeberg mirror is archived and read-only.

Sonda is a privacy-first, self-hosted music server written in Go. It streams the music you already own, from your own disks, and keeps everything it knows about you on your own machine.

It is a single executable, one database (SQLite by default, PostgreSQL if you prefer) and the folders that hold your music. There is no Redis, no message broker and no cloud account.

Status: early. The local-playback part works end to end: accounts, libraries, scanning, search, and streaming with HTTP Range. Suggestions of new artists work too (Discover). Other apps can connect over OpenSubsonic (see Other apps), and the web client in web/, which sondad serves, is young (see What is not there yet and Web app). The API may still change.

Quick start

With Docker (the image is on the registry of git.kmalloc.org, for amd64 and arm64):

(umask 077; echo "SONDA_JWT_SECRET=$(openssl rand -hex 32)" > sonda.env)   # once: keep this file
docker run -d --name sonda --restart unless-stopped --stop-timeout 15 \
  -p 127.0.0.1:8080:8080 \
  --env-file sonda.env \
  -v sonda-data:/data \
  -v "$HOME/Music":/music:ro \
  git.kmalloc.org/squid/sonda:latest

Open http://127.0.0.1:8080, create the first account (it becomes the admin), then add a library with the path /music. To build from source, or for Compose, see Install.

Documentation

The full API is also described in OpenAPI and served by Sonda itself at /api/docs/.

Third-party code

Audio tags are read with go.senan.xyz/taglib, which embeds TagLib compiled to WebAssembly and is licensed under the LGPL 2.1. The Swagger UI assets come from github.com/swaggest/swgui (Apache-2.0), which embeds Swagger UI (Apache-2.0). The other dependencies are listed in go.mod. The Milkdrop pictures of the player are drawn by butterchurn and butterchurn-presets (both MIT), bundled in the web app. The shape of a song is found with github.com/hajimehoshi/go-mp3 (Apache-2.0) and github.com/eaburns/flac (MIT), two decoders written in Go.