Skip to content

Latest commit

 

History

45 Commits

Folders and files

Repository files navigation

YTM Hybrid Logo

YTM Hybrid

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

Download Releases »
Report Bug · Request Feature

License: GPL-3.0 Version 0.4.3 Made with Rust


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

Installation

Windows

Setup Installer (Recommended)

Download and run the Inno Setup Installer.

Portable Executable

Download the standalone ytm-hybrid.exe from Releases and run it directly without installation.

Automated ZIP Archive

Download ytm-hybrid-v0.4.3-windows-x64.zip, extract it, and run with included scripts.

MSIX Package

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

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.4.3-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.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 remove

macOS

Download 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"

Building from Source

Prerequisites

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

Build Steps

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)

Releases

Packages

Used by

Contributors

Languages