Versions and changes
This page tells you which versions are current, where to read what changed, and how to tell the releases apart on GitHub.
Current versions
Section titled “Current versions”| Part | Version | What changed | Release tag |
|---|---|---|---|
| Android app (Musonic Mobile) | 2.4.0 | Changelog | mobile-v2.4.0 |
| Web player (Musonic Web) | 1.4.0 | Changelog | web-v1.4.0 |
| Musonic Server (with its console) | 1.3.0 | Changelog | server-v1.3.0 |
All the downloads are on the releases page. The newest release is at the top; each one shows its name (Musonic Web 1.2.0, Musonic Server 1.2.1…), its tag, its notes (Added, Changed, Fixed) and, at the bottom, its files. The column on the left lists the releases of the page.
How the releases are organised
Section titled “How the releases are organised”The app, the web player and the server live in the same repository but are released separately, each with its own version number and its own tag prefix.
| Tag | Release name | Files |
|---|---|---|
mobile-vX.Y.Z |
Musonic Mobile X.Y.Z | Musonic.apk, the Android app |
web-vX.Y.Z |
Musonic Web X.Y.Z | Musonic-Web.zip (to serve at the root of a website) and Musonic-Web-app.zip (installed by Musonic Server’s console, served at /app/) |
server-vX.Y.Z |
Musonic Server X.Y.Z | compose.yml, and the program for Linux x86 and ARM (musonic-server-…-linux-x86_64.tar.gz, …-aarch64.tar.gz) with its console next to it |
- The release marked “Latest” on GitHub is always the Android app. That way, the download link
releases/latest/download/Musonic.apkalways gives the newest app, even when a server or web release came out after it. - The server is also published as a Docker image,
ghcr.io/doodzdev/musonic-server, with the tagsX.Y.Z,X.Y,Xandlatest. For example, version 1.2.1 is tagged1.2.1,1.2,1andlatest. - The administration console has no release of its own: it ships inside each server release and Docker image.
- Before 2026-10-12, the app’s releases were tagged
vX.Y.Z; they were renamedmobile-vX.Y.Zthat day.
Reading a version number
Section titled “Reading a version number”Each part follows semantic versioning: MAJOR.MINOR.PATCH.
- PATCH (1.2.0 → 1.2.1): fixes only.
- MINOR (1.1.0 → 1.2.0): new features, still compatible with the previous version.
- MAJOR (1.x → 2.0): a large change, which may not work like the previous one: read its changelog before you update.
The changelogs follow the Keep a Changelog format: each version lists what was Added, Changed, Fixed and, when needed, Security fixes. When a feature of an app needs a recent server, the changelog says which server version.