Skip to content
mesconPublic

About

mscOS: bit-perfect music OS for network streamers and small computers. Spotify Lossless, Roon, HQPlayer, UPnP and native DSD to any USB DAC, with a panel that measures what reaches it.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Latest commit

 

History

188 Commits

Folders and files

Repository files navigation

mscOS

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 signal chain in the panel: sample rate, bit depth and gain as measured, and a lamp per stage

The first-start guide Modules
The guide's third step: naming the DAC and the streamer The Modules view on a new installation

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.

Install

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.

Status

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.

Layout

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

Development

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 module

Swedish 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.

Rules for this repository

  • No secrets and nothing from anyone's own installation: no keys, addresses or host names. Site settings live in /etc/mscos/site.env on the device, secrets in /etc/mscos/panel.env and /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.

License

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.

About

mscOS: bit-perfect music OS for network streamers and small computers. Spotify Lossless, Roon, HQPlayer, UPnP and native DSD to any USB DAC, with a panel that measures what reaches it.

Topics

Resources

Stars

0 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages