A fast, native-feeling desktop client for YouTube Music.
Built with Tauri, React and TypeScript for Windows, macOS and Linux.
Important
Zuno is an independent, unofficial project. It is not affiliated with, authorized by, sponsored by, or endorsed by YouTube or Google.
Zuno brings YouTube Music to the desktop as a focused application rather than a browser tab. There is no official YouTube Music desktop client, so the goal here is a polished one that feels native on each platform and stays fast with large libraries.
If you find it useful, starring the repo genuinely helps.
| Dark | Light |
 |
 |
Collapsed sidebar — the library rail stays reachable while the content column takes the width.
| Feature | Description |
|---|---|
| Multiple tabs | Each tab keeps its own queue, volume and player state — start an album in one, browse in another, and the first keeps playing |
| Offline downloads | Save a song, a selection, or a whole album or playlist, with its own quality setting and a size cap you control |
| Mini player | A morphing capsule that appears when you tab away; drag it anywhere, hover to expand |
| Synced lyrics | Real-time synced lyrics, not available on the official web client |
| Like & dislike | Rate from the row, the player or the right-click menu; ratings sync to your YouTube Music account |
| Batch actions | Shift/ctrl-select rows, then queue, download, add to a playlist or remove them together |
| Queue control | Collapses to an artwork rail — end the queue here, build a queue from here, shuffle, clear |
| Recommendations | Personalised suggestions plus a "surprise me" shuffle |
| Local files | Folders from your own machine sit alongside your library, with a tag editor for fixing metadata |
| Discord & Last.fm | Rich Presence and scrobbling, each toggleable straight from the toolbar |
| Account support | Sign in for your library and playlists, and switch between channels on the same account |
| Desktop integration | Media keys, minimise to tray, launch at login, remembered window position, rebindable shortcuts |
| Light & dark themes | Follows the OS by default, or pin either one — plus a reduced-motion mode |
| Caching | Playlists, lyrics and artwork are cached, so revisits are instant |
| Auto-updates | Signed updates install themselves; no manual re-download |
Grab the newest installer from the latest release for Windows, macOS or Linux.
- Windows — primary supported platform.
- macOS — supported.
- Linux — supported.
On some Wayland desktops the AppImage can open a blank grey window with an EGL error. If that happens, try:
LD_PRELOAD=/usr/lib/libwayland-client.so ./Zuno_<version>_amd64.AppImageIf playback or window controls still fail, open the app log from Settings → Library → Application log and attach it to an issue. The desktop environment, display server and distro all help a lot for Linux bugs.
macOS may show a Keychain prompt. Zuno stores one encryption key in its own Keychain entry, and your YouTube Music session is encrypted with that key before being written to the app data directory. Choosing Always Allow avoids repeated prompts.
If you do not intend to sign in to YouTube Music, you can decline it.
- Node.js LTS and npm
- Rust and Cargo
- C++ build tools (MSVC on Windows)
- Microsoft Edge WebView2 Runtime (Windows)
The Tauri CLI ships in the project's dev dependencies — no global install needed.
npm install
npm run tauri dev
npm run tauri buildThe docs/ folder documents the codebase:
docs/architecture.md— system overview and module mapdocs/frontend.md— React structure, styling tokens, icon conventionsdocs/backend.md— Rust commands and the IPC surface
Contributions are welcome. Fork the repo, branch, test locally, and open a pull request describing what changed and why. For larger changes, open an issue first so the approach can be discussed.
By contributing you agree to the Contributor License Agreement.
Zuno is a fork of JustAnotherMusicClient by 2latemc, used under the Apache 2.0 licence. The original project did the hard groundwork of getting YouTube Music working on the desktop.
If you want to support the original author, they accept donations on Ko-fi.
Zuno provides no downloading functionality. It is a client for audio listening, with theming and interface additions.
Zuno interacts with YouTube and YouTube Music. Access to those services remains governed by their own terms, policies, availability and regional restrictions.
Zuno does not host or claim ownership of music, videos, artwork, metadata, or any other content supplied by third parties. Rights in that content remain with their respective owners.
The project is not intended to circumvent access controls, geographic restrictions, advertising, paid service requirements, or content licensing, nor to enable unauthorised downloading, copying, redistribution or public performance of third-party content.
YouTube and YouTube Music are trademarks of Google LLC. All other trademarks are the property of their respective owners. References to third-party products describe compatibility and integration only.