gitwtfhub

wtf is yt-music-unofficial?

justhenix/yt-music-unofficial — explained in plain English

Analysis updated 2026-05-18

27RustAudience · generalComplexity · 2/5LicenseSetup · easy

TL;DR

An unofficial Windows desktop app that runs YouTube Music in its own window, with ad blocking and Discord Rich Presence showing your current track.

Mindmap

mindmap
  root((yt-music-unofficial))
    What it does
      Dedicated YT Music window
      Blocks ads and trackers
      Discord Rich Presence
    Tech stack
      Rust
      Tauri
      WebView2
    Use cases
      Desktop music app
      Show now playing on Discord
      Global media shortcuts
    Audience
      Windows users
      Discord users
    Security
      Restricted navigation
      No IPC to remote page

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run YouTube Music as a standalone Windows app instead of a browser tab.

REASON 2

Show your currently playing song on Discord through Rich Presence.

REASON 3

Block ads and tracking requests while listening to YouTube Music.

REASON 4

Control playback with global keyboard shortcuts and a system tray icon.

What's in the stack?

RustTauriWebView2Node.js

How it stacks up

justhenix/yt-music-unofficialhellanglez/zsparkhome-operations/kopiur
Stars272727
LanguageRustRustRust
Setup difficultyeasyhardhard
Complexity2/54/54/5
Audiencegeneraldeveloperops devops

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

Windows only, requires the Microsoft Edge WebView2 Runtime and the Discord desktop client for Rich Presence.

MIT license: free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

Wtf does this do

yt-music-unofficial is an unofficial Windows desktop app for YouTube Music. It is built with Tauri, a framework that wraps a website inside its own native window, and it uses Microsoft's WebView2 component to display the page. Instead of keeping YouTube Music stuck in a browser tab, this app gives it a dedicated window, keeps the user's normal YouTube login session, blocks common ad and tracking requests, and shows the currently playing track as Discord Rich Presence so friends can see what is playing. The app is Windows only and is not affiliated with YouTube, Google, Discord, Microsoft, or Tauri. It ships as an NSIS installer, with an MSI package also available on the releases page. Once installed, it supports global keyboard shortcuts for previous, play or pause, next, reload, and zoom, along with a system tray icon for quick controls. Users can toggle Discord Rich Presence and ad blocking, reload or clear the cache, reset the session, and choose to close to the tray, launch at startup, or start minimized. External links open in the normal default browser instead of inside the app. On the technical side, the ad blocking works through native request filtering rather than a browser extension, and it reports how many requests it has blocked. Discord Rich Presence data is passed to the app through a document title bridge rather than by giving the remote YouTube Music page any direct access to the app's internal functions, and page navigation is limited to YouTube Music and the expected Google or YouTube sign in pages. The app includes a hidden self test mode developers can use to confirm the ad blocker is wired up correctly. Building the project from source requires Node.js, npm, the Rust toolchain with Cargo, and the Windows WebView2 Runtime, after which a couple of npm commands produce the installable bundle. The README also notes that Windows may label the app's media playback as an unknown app in the system media controls, which it describes as a limitation of WebView2 and Tauri rather than a bug in this project, since track information and media buttons keep working normally. The project is released under the MIT license, and third party dependency credits are listed in a separate notices file.

Yoink these prompts

Prompt 1
Walk me through installing yt-music-unofficial on Windows using the NSIS installer.
Prompt 2
Help me build yt-music-unofficial from source with Node.js and the Rust toolchain.
Prompt 3
Explain how to set a custom Discord application ID for yt-music-unofficial's Rich Presence.
Prompt 4
Show me the keyboard shortcuts yt-music-unofficial supports for controlling playback.

Frequently asked questions

wtf is yt-music-unofficial?

An unofficial Windows desktop app that runs YouTube Music in its own window, with ad blocking and Discord Rich Presence showing your current track.

What language is yt-music-unofficial written in?

Mainly Rust. The stack also includes Rust, Tauri, WebView2.

What license does yt-music-unofficial use?

MIT license: free to use, modify, and distribute, including commercially, as long as you keep the copyright notice.

How hard is yt-music-unofficial to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is yt-music-unofficial for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.