README.md
August 9, 2026 · View on GitHub
Note
We hit 1000 Stars, thanks for your continued support ♥️
I've never imagined that a personal project for my one use would become that large :)
Additionally v1.0 has been released, completed rewritten services and updated UI. stay tuned for new planned features ♥️
Youtube Music for Desktop (ytmdesktop2)
Beautiful Youtube Music desktop app with customizations for users and developers.
Features
Last.fm
Scrobble and update Now Playing while you listen.
Tray view
Compact now-playing popup from the system tray.
Lyrics
Timed lyrics in the player (Better Lyrics, Unison, LRCLIB).
Discord Rich Presence
Show the current track in Discord.
Themes
Bundled or custom SCSS/CSS for the YouTube Music UI.
OBS overlays
First-party now-playing browser sources. Enable API, open Settings -> OBS, copy URL into an OBS Browser Source (default port 13091).
http://127.0.0.1:13091/embed/now-playing
Shared links (ytmd://)
Open tracks, playlists, and channels in the app (ytmd:// or swap https:// on music.youtube.com URLs).
Stream Deck
- Enable API + require authorization
- Install the Stream Deck plugin
- Authorize from a YTMDesktop2 action
More detail in apps/docs/content/docs/features.
Project setup
Monorepo (pnpm). App: apps/ytmdesktop2. Stream Deck: packages/streamdeck.
# gh required for github packages (Venipa/xosms)
gh auth refresh -s read:packages
pnpm install
pnpm dev
Inspiration
ytmdesktop and th-ch / Pear Desktop inspired a lot of my own work on this project: ideas, approaches, and the wider desktop YouTube Music space. Also Last.fm, Better Lyrics, and LRCLIB. Grateful they exist.
Contributors