<!-- https://refryt.top/ -->

# YouTube Music, native.

A desktop client for Linux, Windows and macOS, written in Rust. No browser engine behind it: playback goes through mpv, and the app talks to YouTube through the same internal API the website uses.

[Download](https://github.com/gridoe/refryt/releases/latest) [See what it does](https://refryt.top/features.html)

Latest release [v0.2.0](https://github.com/gridoe/refryt/releases/latest) · GPL-3.0-or-later · Free and open source

**100–300 MB** typical memory use, depending on the session

**23 themes** plain CSS files you can edit, with transparency and blur

**Multiplatform** Linux, Windows (x64 and ARM64) and Apple Silicon Macs

## What it does

[All features](https://refryt.top/features.html)

### No browser inside

Rust and egui draw the interface, mpv plays the music. No Electron, no web view, nothing idling in the background.

### Up next, in two parts

The songs you queued stay apart from the radio YouTube adds after them. Steer it with Familiar, Discover, a decade or a genre.

### Synced lyrics

Line-by-line timing from LRCLIB, beside the cover in a fullscreen player with its own queue drawer.

### Themes are CSS files

23 to start from. Change three colours in a text file, save, and the app repaints.

### See-through, if you like

Window transparency with real background blur on KDE Plasma, niri, GNOME 51+, Windows and macOS.

### Music videos

Watch a song's music video in the app. Click to pause, double-click for fullscreen.

### Local files and offline

Your own folders as a browsable tree. With Premium, downloads with tags and cover art, and an offline mode.

### Your library, your order

Drag playlists into place, choose which Home sections come first, and see the songs you liked on every artist page.

## 23 themes, all plain CSS

Each theme is a CSS file in your config folder. Edit one and the app repaints; add one and it shows up in Settings. Window transparency and background blur work on KDE Plasma (Wayland), niri, GNOME 51+, Windows and macOS.

- Classic
- Catppuccin
- Nord
- Gruvbox
- Tokyo Night
- Dracula
- Rosé Pine
- Everforest
- Solarized
- Spotify

[Write your own theme](https://refryt.top/themes.html)

## Get refryt

[All install options](https://refryt.top/install.html)

### Linux

Flatpak, AppImage, or `refryt-bin` on the AUR.

[Install on Linux](https://refryt.top/install.html#linux)

### Windows

Installer, MSI, zip or Scoop. x64 and ARM64.

[Install on Windows](https://refryt.top/install.html#windows)

### macOS

Homebrew cask or a DMG, for Apple Silicon.

[Install on macOS](https://refryt.top/install.html#macos)

**refryt is not a piracy tool.** It hosts, shares and unlocks no content. Every song is streamed from YouTube under the account that is signed in.

- It is meant for use with YouTube Premium or YouTube Music Premium. Downloads only work for a Premium account and are for personal offline listening.
- refryt is unofficial and not affiliated with, endorsed by or sponsored by YouTube or Google. "YouTube" and "YouTube Music" are trademarks of Google LLC. It uses YouTube's undocumented internal API, and third-party clients fall outside YouTube's Terms of Service.
