A fast, native player for YouTube Music.
Slint, Qt and libmpv instead of Electron: a track starts about 0.4 s after the click.
Download · Building · Documentation · Contributing · License
Quince is an alternative to Pear Desktop and the web app. There is no Electron and no yt-dlp. A track starts about 0.4 s after the click, and playing uses about 270 MiB of memory on the author's machine, against about 800 MiB for Pear Desktop.
Unofficial, not affiliated with Google or YouTube.
- C++23 with Qt 6 core (network, database, player logic) and a Slint interface.
- Playback through libmpv, gapless or with a crossfade, with equalizer, compressor and speed.
- YouTube Music's internal API is called directly (ytmusicapi's way), with yt-dlp's challenge solver running in QuickJS-ng.
- Home, Explore, search, album, artist and playlist pages, queue, multi-select, library and history when signed in.
- Time-synced lyrics from LRCLIB, Megalobiz, YouTube Music and Genius, with romanization of Japanese, Korean and Chinese.
- Video mode, visualizer and mini player.
- Downloads as Opus, M4A or MP3 with tags and cover.
- Sign-in through the web view of the system, a browser's cookies or a cookies.txt file. A real sign-in was tested on Linux only.
- Media controls: MPRIS on Linux, SystemMediaTransportControls on Windows and Now Playing on macOS. The last two are written but have not been seen on a real Windows PC or Mac.
- Discord Rich Presence, tray icon, notifications, English and German.
The user guide (install notes, sign-in, shortcuts, troubleshooting) is in docs/guide.md.
Downloads are on the releases page.
| System | Download | |
|---|---|---|
| Windows (64-bit) | Windows zip | Portable: unzip anywhere and run quince.exe in the Quince folder. |
| macOS (Apple Silicon) | macOS zip | Unzip and move Quince.app to Applications. |
| macOS with Homebrew | see the guide | Builds from source with Homebrew's Qt and mpv. |
| Arch Linux, EndeavourOS | Arch tarball | Files under usr/, built against Arch's libraries of the release day. No AUR package yet. |
| Other Linux | build from source |
Requirements on Arch Linux and EndeavourOS:
sudo pacman -S --needed cmake ninja rust qt6-base qt6-tools webkitgtk-6.0 icu mpv ffmpeg fontconfig libglvnd
Build and run:
git clone https://github.com/Blackwolf1337/quince.git
cd quince
cmake -S . -B build -G Ninja -DCMAKE_BUILD_TYPE=RelWithDebInfo
cmake --build build
./build/quince
docs/building.md has the full requirements, the install step, the Windows and macOS builds and the translations.
| User guide | install notes, sign-in, shortcuts, troubleshooting |
| Features | every feature and option in detail |
| Usage | command line, global shortcuts, mini player on Hyprland, sign-in details, files |
| Building | requirements, build, install, Windows and macOS builds |
| Platforms | what is tested on which system |
| Maintenance | updating the solver and the parser, development tools |
| Architecture | how streaming works and the source layout |
| Credits | credits and licenses of the parts Quince uses |
Bug reports, ideas and pull requests are welcome. Read CONTRIBUTING.md and the Code of Conduct first.
Report security problems privately, as described in SECURITY.md, never in a public issue.
Quince builds on Slint, Qt, mpv, ytmusicapi, yt-dlp (challenge solver), QuickJS-ng, Inter, MeCab with IPADIC, ICU, LRCLIB, Megalobiz, Genius and SponsorBlock. The full list with licenses is in docs/credits.md.
Quince is licensed under GPL-3.0-or-later (see LICENSE). The bundled parts keep their own licenses, as listed in docs/credits.md. The Windows and macOS downloads contain GPL builds of mpv and FFmpeg.
