YTM Hybrid

Native YouTube Music Desktop Client, built with Rust & GPUI 🚀

Download Releases »
Report Bug · Request Feature

---

Important

YTM Hybrid is not a piracy tool.

YTM Hybrid is not a platform for obtaining or sharing copyrighted material. We will not implement any functions that can be used to export decrypted streams, DRM licenses, content keys, or to convert protected streams into media files.

YTM Hybrid is not designed to circumvent subscriptions or other restrictions put in place by YouTube Music. If the service requires a valid subscription to play back tracks, so will YTM Hybrid.

Features aimed at ripping, downloading, distributing, or gaining access to protected streaming content are out of scope for the project.

Features

• YouTube Music streaming with native ytmusic-rs integration
• WebView authentication using SAPISID/3PAPISID cookies
• Gapless playback with audio normalization
• Shuffle mode and sleep timer
• Synced/karaoke lyrics with romanization support
• Scrobbling with LastFM, ListenBrainz, LibreFM, and Maloja
• Discord Rich Presence
• Customizable themes, fonts, icons, transparency, and blur effects
• Local file playback support
• Native performance with GPUI framework
• Cross-platform: macOS, Windows, Linux

Installation

Windows

Installer

Download and run the installer, or the ARM installer on Windows on ARM.

Portable

Download the latest windows-msvc.exe for your architecture from Releases.

Linux

Debian / Ubuntu / Linux Mint (.deb)

Download the .deb package from the latest release and install it via dpkg or your desktop software manager:

sudo dpkg -i ytm-hybrid_0.2.0-1_amd64.deb
sudo apt-get install -f  # Fix any missing dependencies if needed

Generic Tarball (.tar.gz)

Download the portable .tar.gz archive, extract it, make the binary executable, and run:

tar -xzf ytm-hybrid-v0.2.0-linux-x64.tar.gz
cd ytm-hybrid-v0.2.0-linux-x64
chmod +x ytm-hybrid
./ytm-hybrid

macOS

Note: Official pre-built macOS binaries (.dmg) are currently not available. macOS support is planned for future releases.

If you are building from source or running an unsigned local build, macOS Gatekeeper may quarantine the application. After installing or moving YTMHybrid.app to your Applications folder, clear the quarantine attribute by running:

xattr -dr com.apple.quarantine /Applications/YTMHybrid.app

## Building from Source

### Prerequisites

- Rust toolchain (edition 2024, resolver 3)
- C++ compiler (for Widevine support)
- Git

### Build Steps

```sh
git clone https://github.com/egehansimarikk/YtmHybridClient.git
cd YtmHybridClient
cargo build --release --package ytm-hybrid

The binary will be in target/release/ytm-hybrid (or ytm-hybrid.exe on Windows).

Nix

nix develop                    # or direnv allow
cargo run --locked --package ytm-hybrid

Credits

YTM Hybrid is built with the help of some incredible open-source projects, including:

• Zed — provides gpui, their native Rust rendering stack
• ytmusic-rs — YouTube Music API client library
• Sonora — the original multi-provider music client that inspired this project

License

Copyright (C) 2026 Egehan Şımarık.

YTM Hybrid is free software, released under the GNU General Public License version 3 or later.

YTM Hybrid is an unofficial client and is not affiliated with, endorsed by, or sponsored by YouTube or Google LLC.

The binary also embeds the Inter typeface (SIL Open Font License 1.1) and four interchangeable icon sets: Lucide (ISC), Iconoir (MIT), Remix Icon 4.8.0 (Apache 2.0) and the Solar Linear set (CC BY 4.0, by 480 Design). Each pack keeps its licence beside its files in assets/icons. THIRD-PARTY.md lists every bundled dependency.

Author

Created by Egehan Şımarık (Proje Lideri & Geliştirici)