# ytmdesktop/ytmdesktop

A Desktop App for YouTube Music

Repository: https://github.com/ytmdesktop/ytmdesktop
Canonical: https://ross.abutalabs.com/products/ytmdesktop
Homepage: https://ytmdesktop.github.io/
Language: TypeScript
License: GPL-3.0
License Family: copyleft
Topics: youtube, music, desktop, app, electron, node, javascript, scrobbler, electron-application, youtube-music, linux, windows, mac, youtube-player, music-player, youtube-music-player, discord
Last push: 2026-08-18T13:34:53+00:00

## Health v2 (maintenance only)
Score: 80/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 98, release rhythm 46, longevity 100
- inputs: {"age_days": 2875, "days_push": 15, "days_rel": 202, "gap_med": 91, "n_releases_24m": 6}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 6420, forks 601 (observed 2026-08-28T04:09:43.320614+00:00)

## What it is
An unofficial cross-platform desktop application for YouTube Music built with Electron and TypeScript. It wraps YouTube Music in a native desktop experience with extras like Last.fm scrobbling, Discord Rich Presence, custom shortcuts, sleep timer, and a companion server for third-party integrations.

## Use cases
- play youtube music in a desktop app
- scrobble youtube music listening to last.fm
- show what i'm listening to on discord
- control youtube music with global keyboard shortcuts
- set a sleep timer for music playback
- add custom css styling to youtube music
- get desktop notifications when the song changes

## When to choose
- you want a native desktop experience for YouTube Music on Windows, macOS, or Linux
- you want integrations like Last.fm scrobbling, Discord presence, or a companion API server
- you want features YouTube Music's web player lacks, like sleep timer, custom shortcuts, and volume boost

## When to avoid
- you only need YouTube Music in a browser tab without extra features
- you need an official, supported client
- you want offline playback or downloading of music, which this does not provide

## Facets
- artifact type: application
- maturity: active
- function: gui, audio-processing, plugin-system, developer-tools
- domain: media, desktop-applications, entertainment, cross-platform
- platform: windows, cross-platform
- tags: youtube-music, music-player, lastfm-scrobbling, discord-rich-presence, media-controls, unofficial-client, linux, macos, electron, desktop

## Member repositories
- ytmdesktop/ytmdesktop (main) score 80

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:43.320614+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:44:54.100778+00:00, confidence not recorded.
  - readme: https://github.com/ytmdesktop/ytmdesktop (fetched 2026-08-28T04:09:43.320614+00:00, sha 0012ba4f419f)
  - homepage: https://ytmdesktop.github.io/ (fetched 2026-08-29T08:41:56.433449+00:00, sha fa739d67df90)
- Data as of 2026-08-30T08:39:29.467469+00:00.