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

_{Library — browse albums, artists, and songs}	_{Now playing — synced lyrics + audio visualizer}
_{Theming — presets, base16 import, follow system accent}	_{Mini player — 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 && 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 ☕

Metadata

Release files for jellytoast 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for jellytoast 0.2.2
File	Size	Uploaded
jellytoast-0.2.2.tar.gz	1.7 MB	Oct 8, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for jellytoast 0.2.2
File	Interpreter	ABI	Platform	Reset
jellytoast-0.2.2-py3-none-any.whl 1.3 MB Oct 8, 2026	Python 3	none	any	Details

Total release size: 3.0 MB

Release files / jellytoast-0.2.2.tar.gz

Download URL	jellytoast-0.2.2.tar.gz
Size	1.7 MB
Tags	Source
SHA-256 checksum How to use checksums	`783870beffc81883d96d3854410a3263fe9b911dd5bb36a02c6fe9f96b8402b3`
BLAKE2b-256 checksum How to use checksums	`0a6cd038777d731d73f183e153ac2f8cf78ec7fd56e0dad5153d2d31c3dd84fe`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/wolfgangwarehaus/jellytoast
Publishing commit: github.com/wolfgangwarehaus/jellytoast/tree/2706d5b4f7ebc94916a6ea6550b693c83ac0dace

Workflow

Publishing configuration: github.com/wolfgangwarehaus/jellytoast/blob/2706d5b4f7ebc94916a6ea6550b693c83ac0dace/.github/workflows/pypi-publish.yml
Publishing logs: github.com/wolfgangwarehaus/jellytoast/actions/runs/37846086687/attempts/1

Artifact

Subject: jellytoast-0.2.2.tar.gz
SHA-256 checksum: 783870beffc81883d96d3854410a3263fe9b911dd5bb36a02c6fe9f96b8402b3 Verifying attestations

Release files / jellytoast-0.2.2-py3-none-any.whl

Download URL	jellytoast-0.2.2-py3-none-any.whl
Size	1.3 MB
Tags	Python 3
SHA-256 checksum How to use checksums	`e29a8ceb2d8460fd8c97a7949e8631ec50079e59a1b64a1271521407fb717ce9`
BLAKE2b-256 checksum How to use checksums	`d1aa1284941860efa7dfe0e280adaabc6713019bacb24d12344e45c7c151cedc`
Upload date	Oct 8, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.13`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/wolfgangwarehaus/jellytoast
Publishing commit: github.com/wolfgangwarehaus/jellytoast/tree/2706d5b4f7ebc94916a6ea6550b693c83ac0dace

Workflow

Publishing configuration: github.com/wolfgangwarehaus/jellytoast/blob/2706d5b4f7ebc94916a6ea6550b693c83ac0dace/.github/workflows/pypi-publish.yml
Publishing logs: github.com/wolfgangwarehaus/jellytoast/actions/runs/37846086687/attempts/1

Artifact

Subject: jellytoast-0.2.2-py3-none-any.whl
SHA-256 checksum: e29a8ceb2d8460fd8c97a7949e8631ec50079e59a1b64a1271521407fb717ce9 Verifying attestations