by vivajAcoustics
An overview with pictures: https://mescon.github.io/mscOS/
mscOS ("music OS") turns a small computer, or a streamer whose maker no longer updates it, into a bit-perfect network music player for a USB DAC. It brings Spotify Lossless, Roon, HQPlayer and UPnP to hardware you already own, and it is set up and watched from a web panel on your phone, in Swedish or English.
- Bit-perfect, and it shows it. The panel measures what actually reaches the DAC: 16 or 24 bit, lossless or not, dropouts, the DAC's own clock. Every stage from the source to the DAC has a lamp, for every source.
- Sources as modules. One at a time uses the DAC:
- Spotify Lossless (Soloist, with your own developer key),
- Spotify Connect without a key (go-librespot, 320 kbit/s),
- Roon Bridge, with Roon's library, search and transport in the panel,
- HQPlayer NAA,
- a UPnP and OpenHome renderer (MPD with upmpdcli): Qobuz, Tidal and your own files from apps such as mconnect and BubbleUPnP.
- Your music in the panel. Search Spotify or Roon, open an artist and see every album in the order it came out, with the tracks under each. Signed in with Spotify you get your playlists, saved albums and liked tracks, in folders of your own, and a heart on what plays. Every artist and album name leads to its page, and every page has an address you can keep.
- About the music. Notes on the song, the album and the artist that is playing, who plays on it, and lyrics that follow the music, from Wikipedia, MusicBrainz, Discogs, Last.fm and LRCLIB (a module, off by default: the device then asks those services about what plays).
- Your equipment as modules. Amplifier volume and inputs over the network (Mark Levinson Nº585/585.5), an Arcam AV receiver, alerts to your phone (ntfy, Home Assistant), a listening diary (ListenBrainz), native DSD for C-Media CM6632A DACs, and modules of your own. The core needs none of them: any USB DAC works.
- A quiet machine. One CPU core for audio and the DAC's USB traffic, no frequency scaling, nothing unscheduled while music plays. The panel lists each measure and checks it live.
- No keys, no player binaries included. Players are downloaded on the device from their publishers. Keys and accounts are your own, and the panel walks you through getting each one.
- An app on your phone without an app store. The panel is a web app: add it to the home screen and it opens like any other app.
| The first-start guide | Modules |
|---|---|
![]() |
![]() |
It is Debian 13 with the mscOS packages on top, built into images with the Armbian framework. It started on a SOtM sMS-200ultra, which is still the only board it has been tested on; see status.
See docs/INSTALL.md. In short: write the image to an SD card, start the
device on wired network, open http://mscos.local and follow the guide. The panel then
lists what is left: the players to fetch, the keys to enter (each with its steps), and
how to put the panel on your phone's home screen. On an existing Debian 13 or Armbian
system, install the packages instead.
| State | |
|---|---|
| SOtM sMS-200, sMS-200ultra (Allwinner A20) | in daily use, installed from a checkout; the image (image/build.sh sotm) builds and its contents are checked, but it has not yet been started on a device |
| x86-64 PCs | the image builds and starts in a virtual machine: first boot, board profile, kernel arguments, the guide and the list of what is left after it (last tried with the build of 2026-11-14), and installing and starting a source from the panel; not yet tested on hardware or with a DAC |
| Raspberry Pi 4/5 | the image (image/build.sh rpi) builds and its contents are checked (packages, kernel with the DSD driver, board profile, first-boot setup); not yet started on a device |
| Other arm64 boards with UEFI | the image (image/build.sh arm64) builds and its contents are checked; the board profile is chosen at first boot. Not yet started on a device |
| Spotify Lossless (Soloist), Roon Bridge | in daily use on the SOtM |
| Roon: what plays, the library and search in the panel (Roon's extension API) | in use on the SOtM against a Roon server: approved there, shows what plays, browses and searches |
| Spotify in the panel: search, artist and album pages, the listener's library, liking a track | search, pages and the library in use on the SOtM with a signed-in account; liking and saving not yet tried against Spotify |
| Signing in with Spotify where the panel has no HTTPS | the steps and the checks verified on a new installation; not yet completed against Spotify |
| Spotify Connect (go-librespot) | playback, transport, and the Spotify slider driving the amplifier verified on the SOtM |
| HQPlayer NAA | install, start and source switching verified on the SOtM; playback not yet tested |
| UPnP renderer | installed on the SOtM; the module's code verified against MPD and upmpdcli in a container (a track sent as an app would, with a null output); not yet played through a DAC |
| Native DSD for CM6632A | in use as a kernel patch (6.18); the DKMS package builds the driver for Debian 13's own kernel (6.12), not yet tried with a DAC on that kernel |
| Panel in Swedish and English | complete |
| A new installation from the packages | installs in an empty Debian 13 container; the guide, the list of what is left to do after it, and entering keys checked there |
| Modules of your own, the module catalogue | installing, updating and removing verified on the SOtM against a test catalogue |
| Alerts through ntfy | a test alert delivered to a real ntfy topic from a new installation |
| Updating mscOS from the panel | written; not yet tested against a published release |
Planned: Squeezelite, AirPlay. Tidal Connect and Qobuz Connect are only offered to certified manufacturers and are not part of mscOS. See docs/PLATFORM-PLAN.md (Swedish) for the reasoning.
| Path | What |
|---|---|
web/ |
the panel: backend/ (Python, aiohttp) and static/ (a PWA without a build step) |
modules/ |
one directory per module: sources (with the script that downloads the player on the device), amplifiers, alerts, integrations. Contributing a module |
core/ |
system setup (mscos-setup), board detection, boot-time tuning, PipeWire configuration |
boards/ |
board profiles: what differs between boards (audio core, interrupts, sensors) |
kernel/ |
kernel configuration and the native-DSD patch (mscos-dsd/, also as DKMS) |
packaging/ |
builds the Debian packages: mscos-core, mscos-panel, mscos-dsd-dkms, mscos |
image/ |
builds images with the Armbian framework |
docs/ |
install, modules, and in Swedish: optimizations, DSD, compared with ROCK |
packaging/build.sh # the .deb packages -> packaging/out/
image/build.sh sotm # an image (sotm | rpi | pc | arm64)
MSCOS_HOST=root@<device> web/deploy.sh # this checkout onto a device, at the packages' paths
tools/i18n-keys.py web/static web/static/i18n/en.json # texts missing from a translation
tools/test.sh # the tests, in a container with the panel's dependencies
tools/module-index.py # rebuild the module catalogue after changing a moduleSwedish is the source language of the panel: texts are written in Swedish in the code and
web/static/i18n/<language>.json maps them to another language. To add a language, copy
en.json, translate the values and add the language to LANGS in web/static/i18n.js and
web/backend/i18n.py.
A module is a directory in modules/; see modules/README.md for how to contribute one and docs/MODULES.md for what a module can do. tools/module-index.py rebuilds the catalogue the panel browses.
- No secrets and nothing from anyone's own installation: no keys, addresses or host
names. Site settings live in
/etc/mscos/site.envon the device, secrets in/etc/mscos/panel.envand/etc/soloist.env. - No player binaries and no keys are redistributed. Spotify's Soloist key is personal and Soloist may not be redistributed; Signalyst's NAA daemon and Roon Bridge are proprietary. Their install scripts download them from the publisher onto the user's device.
- The panel is made for the local network. Without an HTTPS reverse proxy in front of it, the password crosses the LAN in clear text; do not expose it to the internet.
MIT, see LICENSE. The kernel patch and module in kernel/ are
GPL-2.0-or-later. The fonts (Jost, Cormorant) are under the SIL Open Font License.
Spotify, Roon, HQPlayer, Mark Levinson, Arcam and SOtM are trademarks of their owners;
mscOS is not affiliated with or endorsed by any of them.


