jellytoast 0.1.4

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

Linux

• Ubuntu / Debian / Mint (22.04+ / 12+) — download the .deb from Releases, then sudo apt install ./jellytoast_*_amd64.deb
• AppImage (any distro, nothing to install) — download the .AppImage from Releases, chmod +x it, and run.
• AUR (Arch Linux) — coming soon.

macOS (Apple Silicon)

• Download the .dmg — a Developer-ID-signed, notarized app (Gatekeeper-clean, no right-click-to-open dance). Open it and drag jellytoast to Applications. (Apple Silicon / arm64; a universal build with Intel support is planned.)
• Mac App Store — coming soon.

Windows 10/11 (x64)

• Microsoft Store — one click, auto-updating, no SmartScreen warning.
• winget — winget install wolfgangwarehaus.jellytoast
• Installer or portable zip from Releases — the direct download is unsigned, so SmartScreen warns on first run; click More info → Run anyway (verify the SHA256 against SHA256SUMS).

Any OS

• PyPI: pipx install jellytoast

From source (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 ☕