Native YouTube Music Desktop Client, built with Rust & GPUI 🚀
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.
- YouTube Music streaming with native ytmusic-rs integration
- WebView authentication using SAPISID/3PAPISID cookies
- Advanced Spatial Audio Modes: Acoustic stage profiles including Subtle (Meier), Studio (Monitors), Front Stage (HRTF), 3D Surround (Wide), and 3D Concert Hall
- Custom Equalizer Presets: Integrated tuning profiles for Harman IEM, Phonk, and Hip-Hop
- 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
- Multi-Language Support: Comprehensive localization (.ftl) for English, Turkish, German, Spanish, French, Italian, Indonesian, Japanese, Russian, Ukrainian, Polish, Czech, Portuguese (Brazil), Simplified Chinese, and Albanian
- Customizable themes, fonts, icons, transparency, and blur effects
- Local file playback support
- Native performance with GPUI framework
- Cross-platform: macOS, Windows, Linux
Download and run the Inno Setup Installer.
Download the standalone ytm-hybrid.exe from Releases and run it directly without installation.
Download ytm-hybrid-v0.4.3-windows-x64.zip, extract it, and run with included scripts.
Download both ytm-hybrid-v0.4.3-windows-x64.msix and install-msix.bat into the same folder, then double-click install-msix.bat to automatically trust the self-signed certificate and install the app. (Note: Make sure your Windows system clock is synced if you encounter a certificate time error.)
Download the .deb package from the latest release and install it via dpkg or your desktop software manager:
sudo dpkg -i ytm-hybrid_0.4.3-1_amd64.deb
sudo apt-get install -f # Fix any missing dependencies if neededDownload the portable .tar.gz archive, extract it, make the binary executable, and run:
tar -xzf ytm-hybrid-v0.4.3-linux-x64.tar.gz
cd ytm-hybrid-v0.4.3-linux-x64
chmod +x install.sh
./install.sh # Use ./install.sh --uninstall to removeDownload the .dmg installer (YTM-Hybrid-v0.4.3-x64.dmg) from Releases, open it, and drag YTM Hybrid into your Applications folder.
Since the application is not notarized with an Apple Developer certificate, macOS Gatekeeper may block the first launch. You can bypass this by Right-clicking → Open on the app, or by clearing the quarantine attribute in Terminal:
xattr -dr com.apple.quarantine "/Applications/YTM Hybrid.app"- Rust toolchain (edition 2024, resolver 3)
- C++ compiler (for Widevine support)
- Git
git clone https://github.com/egehansimarikk/YtmHybridClient.git
cd YtmHybridClient
cargo build --release --package ytm-hybridThe binary will be in target/release/ytm-hybrid (or ytm-hybrid.exe on Windows).
nix develop # or direnv allow
cargo run --locked --package ytm-hybridYTM 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
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.
Created by Egehan Şımarık (Proje Lideri & Geliştirici)