jellytoast 0.1.5

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, 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 — background blur on KDE, macOS, and Windows. Light and dark themes with a choice of accent color.
• And more — synced lyrics, an audio visualizer, smart playlists, smart shuffle, a sleep timer, ListenBrainz scrobbling, and tag editing (Jellyfin).

Install

Latest builds are on Releases.

• Linux — .deb · AppImage · AUR (soon)
• macOS — Apple Silicon · Intel · App Store (soon)
• Windows — Microsoft Store · .exe · winget install jellytoast
• Any OS — 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

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. See LICENSE.

Support

Want to leave a tip? Ko-fi ☕