Open-source project
yappologistic/Spun avatar
yappologistic/Spun

Spun: a music player whose controls are a CD, a record or a tape

A CD-shaped music player for Linux, with local playback and Cider integration.

480 stars21 forksC++NOASSERTION

At a glance

What is it?
A Qt6 and C++ player for Linux that renders your library as a DM15-inspired CD deck, a turntable, a CP13 cassette or a TP-7 recorder, with Jellyfin, Navidrome, Subsonic and Cider sitting behind it. It is source-available under PolyForm Noncommercial rather than open source, and there is no packaged installer.
Who is it for?
Adopt Spun if you want a local-first Linux music player with a hardware skin you can genuinely operate, and you are willing to build from source against Qt 6.8 and TagLib 2.0. Do not adopt it for commercial redistribution or as a drop-in package, because there is no packaged installer, there are no GitHub releases, and the licence is PolyForm Noncommercial 1.0.0 rather than an OSI-approved one.
Can I use it commercially?
Check first. The repository uses a licence we do not classify automatically, so read its LICENSE file before any commercial use.
Is it still maintained?
Yes. The repository last received commits 60 days ago.
What is it written in?
Mainly C++, according to GitHub's language statistics.

Answers come from the project's GitHub data, last synced on November 15, 2026, and from our analysis. They are not legal advice.

From daily snapshots

Star history

  • yappologistic/Spun480 ★ · +80
Star history
Repository2026-09-212026-11-15
yappologistic/Spun400480

80 Stars in the last 55 days, measured from the daily GitHub snapshot. Compare with other projects

Editorial analysis

Four media skins over one set of playback controls

The medium is a presentation choice, not a different player. You pick CD, vinyl, cassette or TP-7 in More then Preferences, and all four share the same playback controls, album details, lyrics and Mini mode. That is the honest way to describe what this project does, because the striking part is the industrial design rather than the audio path. The CD is a DM15 R2R-inspired aluminium deck with a glass lid, live display, transport buttons, shuffle and repeat selectors and a volume knob. Vinyl is a record with grooves and Relaxed, 33 and a third, or 45 RPM rotation, where you drag the needle to seek and play. Cassette comes in Clear, Smoke and Cream tapes inside a CP13-inspired portable player. The interface follows Material Design 3, and optional 3D adds depth plus lighting that follows Noctalia's wallpaper palette. The four look different; the queue underneath does not.

The 500 RPM setting changes nothing you can hear

This is the detail that tells you how the hardware metaphors are built. On the CD deck, Stop pauses and returns to the start rather than only stopping, and the lid latch pauses playback before the lid opens, so opening the lid is a real state transition rather than decoration. Gentle rotation and the optional 500 RPM setting affect the visual speed only. In other words the fastest-looking speed on the deck does not correspond to any playback rate, and the documentation says so rather than leaving you to work it out. The 3D deck can be dragged to rotate and double-clicked to reset. On cassette, the top buttons seek ten seconds backward or forward, and pressing Stop a second time opens the door, with the reels turning counterclockwise in forward playback and reversing while rewinding. On vinyl, the 3D turntable has a cue lever that lifts and lowers the needle to pause or play. Each mechanism is wired to something real, and each one also has a purely cosmetic counterpart.

Playback can work while the Cider API is still unreachable

Here is the failure that will waste an afternoon if you do not know it in advance. Spun connects to Cider's local API on port 10767, but basic playback controls go through Linux's media-player interface, so working playback alone does not confirm API access. You can have tracks streaming, the transport responding, and no search, no browsing and no full queue, because the media-player interface does not carry any of that. The fix is a separate three-step path: enable Cider's local API, open Spun's Queue and choose Connect to Cider, then approve Spun inside Cider, after which Spun remembers the connection. Older Cider versions need an app token instead, created under Settings then Connectivity then Manage External Application Access, with playback, queue, library and audio access granted before you paste it into Spun. Available actions depend on your Cider version and permissions, and Cider must stay running for any of it. Jellyfin, Navidrome and Subsonic sit alongside this as separate local sources.

The desktop launcher stores a path to the build folder

There is no packaged installer, so the build is the install, and the tree is small enough to read: `src/` for C++, `qml/` for the interface, `assets/`, `helper/`, `scripts/`, `tests/`, `CMakeLists.txt` and a Nix `flake.nix` with `flake.lock`.

bash
git clone https://github.com/yappologistic/Spun.git
cd Spun
./scripts/build.sh -DBUILD_TESTING=OFF
./scripts/install-launcher.sh

Two consequences follow from those four lines. Testing is switched off in the documented build, which is a sensible default for someone cloning to try it and the wrong one for anyone about to patch the source. And `./scripts/install-launcher.sh` writes a launcher that points at the folder you built in, so moving or deleting that folder breaks the entry in your application menu; the fix is to run the script again from the new location. While developing you can bypass the launcher entirely with `./scripts/run.sh` from inside the folder. 3D is included whenever Qt Quick 3D is present, and `-DSPUN_ENABLE_3D=OFF` builds without it, which is also the fallback on distributions where the Quick 3D package is missing.

Ubuntu needs a Qt you build yourself

Arch and CachyOS get a single command, and Fedora gets its equivalent package list, both naming qt6-base, the declarative and multimedia modules, svg, wayland, taglib and qt6-quick3d. Ubuntu 22.04 and 24.04 are the awkward case, because the default repositories do not provide the required Qt 6.8+ and TagLib 2.0+. You install the ordinary build tools first:

bash
sudo apt install build-essential git cmake ninja-build pkg-config python3 libutfcpp-dev zlib1g-dev libgl1-mesa-dev libxkbcommon-dev libxcb-cursor0

`libutfcpp-dev` supplies TagLib's UTF-8 dependency and `libxcb-cursor0` is required by Qt's X11 platform plugin, so both are load-bearing rather than optional. Then you point CMake at a newer Qt than the distribution's:

bash
./scripts/build.sh -DBUILD_TESTING=OFF -DCMAKE_PREFIX_PATH=/path/to/Qt/gcc_64

If TagLib went into a custom prefix, its `lib/pkgconfig` has to be on `PKG_CONFIG_PATH` first, and `pkg-config --modversion taglib` must report 2.0 or newer before you start. The stated floor everywhere else is a C++20 compiler, CMake 3.22+, Ninja, pkg-config, Python 3, Qt 6.8+ with Quick Controls, Multimedia and SVG, and TagLib 2.0+ development files.

PolyForm Noncommercial is not an open-source licence

The project describes itself as source-available under PolyForm Noncommercial 1.0.0, with personal and other permitted noncommercial use free, and states in plain words that this is not an OSI-approved open-source licence. That distinction is not pedantry here, because the most complete install path is the Nix one and the licence is the reason it needs a flag:

bash
NIXPKGS_ALLOW_UNFREE=1 nix run --impure .
# Build without launching:
NIXPKGS_ALLOW_UNFREE=1 nix build --impure .
# Development tools:
nix develop

The opt-in and `--impure` are there because the licence is noncommercial, which means Nix classifies it as unfree. The flake supports x86_64 and aarch64 Linux and bundles both Wayland and X11 plugins without forcing a display backend. Worth noting for anyone auditing the repository itself: the root carries `LICENSE`, `NOTICE` and a `licenses/` directory, while the repository's own licence metadata records no identifier, so the README statement and the files are the only sources to go on.

Symlinks in an imported folder are ignored on purpose

The local library handling has small decisions that were thought about. Adding tracks means choosing Local and pressing +, or dropping files and folders onto the window; More then Add music folder walks artist and album subfolders. Imports show progress, skip songs already sitting in the queue, and can be cancelled without leaving a partial import behind. Directory symlinks inside the folder are not followed, which is a defensible choice against import loops and a surprising one if your library is built from links to a larger archive. Your files are never copied or modified. More then Play demo plays the included original soundcheck, which is the fastest way to hear the transport sounds without configuring anything. The other limitation is environmental rather than logical: Spun is developed on CachyOS with Hyprland and Noctalia, and the documentation says desktop integration can vary elsewhere. The last push to main was on 2026-09-16, and there are no GitHub releases, so there is no tagged build to pin against.

Editorial conclusion

Adopt Spun if you want a local-first Linux music player with a hardware skin you can genuinely operate, and you are willing to build from source against Qt 6.8 and TagLib 2.0. Do not adopt it for commercial redistribution or as a drop-in package, because there is no packaged installer, there are no GitHub releases, and the licence is PolyForm Noncommercial 1.0.0 rather than an OSI-approved one. Verify first that Cider's local API answers on port 10767, since basic playback runs through the Linux media-player interface and will look entirely healthy even while search, browsing and the queue are unreachable.

Frequently asked questions

How do I install Spun on Linux?

There is no packaged installer, so you build it. Run `git clone https://github.com/yappologistic/Spun.git`, then `cd Spun`, `./scripts/build.sh -DBUILD_TESTING=OFF` and `./scripts/install-launcher.sh`. On Nix you can instead run `NIXPKGS_ALLOW_UNFREE=1 nix run --impure .`.

Why does Spun playback work but the queue does not?

Basic playback controls use Linux's media-player interface, so working playback does not confirm Cider API access. Search, browsing and the full queue need Spun connected to Cider's local API on port 10767, which you enable in Cider and then approve from Spun's Queue.

What licence is Spun released under?

PolyForm Noncommercial 1.0.0, and the README states plainly that it is not an OSI-approved open-source licence. Personal and other permitted noncommercial use is free. Because the licence is noncommercial, the Nix install requires `NIXPKGS_ALLOW_UNFREE=1` and `--impure`.

Can I build Spun on Ubuntu 22.04 or 24.04?

Yes, but the default repositories do not provide the required Qt 6.8+ and TagLib 2.0+. You build TagLib 2.x separately and pass `-DCMAKE_PREFIX_PATH=/path/to/Qt/gcc_64` to the build so CMake finds the newer Qt, and `pkg-config --modversion taglib` must report 2.0 or newer.

What music sources can Spun play besides local files?

It can browse YouTube Music anonymously, connect to Jellyfin, Navidrome or Subsonic, and control Apple Music through Cider. For Cider, sign in there first, choose Cider in Spun, and keep Cider running since it handles authentication and streaming.

Official sources

  1. Issues
  2. README
  3. yappologistic/Spun on GitHub
Add this badge to your README

If you maintain this project, the badge below links readers to this analysis and shows its maintenance status from the daily GitHub snapshot. Paste the markdown into your README; add ?metric=license or ?metric=stars to the image URL for a different field.

Add this badge to your README

markdown
[![Hysen Labs](https://hysenlabs.com/badge/yappologistic-spun.svg)](https://hysenlabs.com/projects/yappologistic-spun)

Star history chart for your README

markdown
[![Star history](https://hysenlabs.com/chart/yappologistic-spun.svg)](https://hysenlabs.com/projects/yappologistic-spun)

Was this useful?