Skip to content
Blackwolf1337Public

About

A fast, native player for YouTube Music. Slint, Qt and libmpv instead of Electron.

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Quince logo

Quince

A fast, native player for YouTube Music.
Slint, Qt and libmpv instead of Electron: a track starts about 0.4 s after the click.

Latest release Linux, Windows, macOS License GPL-3.0-or-later

Download · Building · Documentation · Contributing · License

The Now Playing view with time-synced lyrics

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.

Features

  • 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.

Download

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

Building

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.

Documentation

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

Contributing

Bug reports, ideas and pull requests are welcome. Read CONTRIBUTING.md and the Code of Conduct first.

Security

Report security problems privately, as described in SECURITY.md, never in a public issue.

Credits

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.

License

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.

About

A fast, native player for YouTube Music. Slint, Qt and libmpv instead of Electron.

Resources

Code of conduct

Contributing

Security policy

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages