jellytoast wolfgangwarehaus

audio-player chromecast jellyfin music navidrome subsonic

Use this command to install jellytoast:

winget install --id=wolfgangwarehaus.jellytoast -e

jellytoast is a desktop music player for Jellyfin, Navidrome and other Subsonic-compatible servers: bit-perfect playback via mpv, offline downloads, Chromecast/AirPlay/DLNA/Sonos/Snapcast casting, system media keys, scrobbling, smart playlists, and a frosted-glass UI.

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, or DLNA. Local relay for offline or Tailscale casting.
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 & theming — background blur on KDE, macOS, and Windows, plus a full theme picker: light/dark, built-in color presets (Catppuccin, Dracula, Nord, Gruvbox, …), import any base16 scheme, or follow your system accent (and your pywal wallpaper palette on Linux).
And more — synced lyrics, an audio visualizer, smart playlists, smart shuffle, a sleep timer, ListenBrainz scrobbling, and tag editing (Jellyfin).

Screenshots

<a href="docs/screenshots/webp/library.webp"><img src="docs/screenshots/webp/library.webp" /></a><b>Library</b> — browse albums, artists, and songs
<a href="docs/screenshots/webp/now-playing.webp"><img src="docs/screenshots/webp/now-playing.webp" /></a><b>Now playing</b> — synced lyrics + audio visualizer


<a href="docs/screenshots/webp/theme-picker.webp"><img src="docs/screenshots/webp/theme-picker.webp" /></a><b>Theming</b> — presets, base16 import, follow system accent
<a href="docs/screenshots/webp/mini-expanded.webp"><img src="docs/screenshots/webp/mini-expanded.webp" /></a><b>Mini player</b> — compact and album-art views

Install

Latest builds are on Releases.

Linux
- AppImage
- .deb
- Flatpak
- AUR — yay -S jellytoast
macOS
- App Store
- .dmg (universal — Apple Silicon + Intel, macOS 15+)
Windows
- Microsoft Store
- .exe (one installer — x64 + ARM64)
- winget install jellytoast
Any OS
- pipx install jellytoast (needs libmpv installed, like from-source)

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

git clone https://github.com/wolfgangwarehaus/jellytoast.git
cd jellytoast &amp;&amp; pip install -e .
jellytoast

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

Documentation

user_guide.md — how to use every feature
CONTRIBUTING.md — dev setup, architecture & conventions
SPEC.md — what the app actually does today
SECURITY.md — how to report a vulnerability
CHANGELOG.md — what changed in each release

License

GPL-2.0-or-later, with an App Store distribution exception so store builds stay unambiguously legal. See LICENSE and LICENSING.md.

Support

Want to leave a tip? Ko-fi ☕