jellytoast 0.1.0

A desktop music player for Jellyfin and Navidrome servers — bit-perfect mpv playback (Linux + Windows).

jellytoast

A desktop music player for Jellyfin and Navidrome servers —
bit-perfect playback, casting, mini-player, and offline downloads.

Features

• Desktop app for your self-hosted music — supports Jellyfin and Navidrome, with multiple libraries.
• Bit-perfect audio — FLAC / ALAC / OPUS / DSD playback via mpv.
• Cast anywhere — send music to Chromecast, AirPlay 2, Sonos, DLNA, or Snapcast. A built-in local relay can forward the stream for trickier setups, like Tailscale connections or fully offline playback.
• Offline mode — cache albums, playlists, or your whole library for offline playback.
• Floating mini player — compact and album-art views.
• Desktop features — media keys, a tray icon, optional notifications, and a start-at-login option.
• Frosted-glass look — real background blur on KDE and Windows, light and dark themes, and your own accent color.
• And more — synced lyrics, an audio visualizer, smart playlists, smart shuffle, a sleep timer, ListenBrainz scrobbling, tag editing (Jellyfin), and encrypted login storage.

Install

Platform	How
Ubuntu / Debian (22.04+ / 12+)	Download the .deb from Releases, then sudo apt install ./jellytoast_*_amd64.deb
Windows 10/11 (x64)	Installer or portable zip from Releases. The build is unsigned, so SmartScreen warns on first run — click More info → Run anyway (verify the download's SHA256 against SHA256SUMS).
From source (any OS)	Python 3.11+, Qt 6, libmpv — see below

Coming soon: AUR, Flathub, winget, and PyPI (pipx install jellytoast) are packaged and staged but not yet published — they land shortly after v0.1.0. Until then use the .deb, the Windows build, or from source. (Pip users can pipx install the wheel attached to the release today.)

From source (any platform with Python 3.11+, Qt 6, libmpv):

git clone https://github.com/wolfgangwarehaus/jellytoast.git
cd jellytoast
pip install -e .
jellytoast            # or: python3 -m jellytoast

Want to contribute? CONTRIBUTING.md has the dev setup, the architecture, and the conventions this codebase follows.

Documentation

Doc	What it is
docs/user_guide.md	Shortcuts, mini player, tray, casting, settings, themes & blur, troubleshooting
CONTRIBUTING.md	Dev setup, architecture & the conventions this codebase follows
docs/SPEC.md	What the app actually does today
docs/decisions.md	Architecture decision log (why, not just what)
docs/TODO.md	The backlog (P0–P4)
SECURITY.md	How to report a vulnerability
CHANGELOG.md	Dated history of what shipped

License

GPL-2.0-or-later. See LICENSE.

Support

Want to leave a tip? Ko-fi ☕