GitHub - AtotheY/moosik: Open-source YouTube Music desktop player for Apple Silicon Mac and Windows x64, with searchable listening history and an editable queue. Built on Refryt.

Moosik

Moosik is an open-source YouTube Music desktop player. Listen along on Discord, let friends add songs to your queue, and find tracks in your listening history.

Download for Apple Silicon Mac · Windows x64 and Ubuntu 24.04 x86-64 packages

Install · Listening stats · Queue · Contribute · Report a bug

Screenshots

These macOS screenshots show signed-out browsing and synthetic listening stats. Screenshot details

Player

Listen along on Discord. Open Discord desktop and enable Discord Rich Presence and Host Listen along in Settings → Discord. Play a YouTube Music track. Friends can join from your profile, follow your playback in Moosik, and add songs to the shared queue. Setup guide
Queue and playlists. Move several upcoming tracks together, undo edits, or save the queue as a private playlist. Organize playlists in nested folders and shuffle an entire folder. Queue controls
Follow synced lyrics, use keyboard shortcuts, and customize the player’s theme, sidebars, and fullscreen view.

Listening history

Search local listening history by title, artist, or date. See listening time, skips and completed plays, add mood tags and ratings, or share a recap for a date range you choose. Export song stats as CSV, history as JSON, or back up the SQLite database.

Listening history guide · Stat definitions and limitations

Install

Download a package from the latest release or moosik.dev.

Platform	Package and status
macOS, Apple Silicon	DMG installer and signed in-app updates. See the release for macOS requirements.
Windows, x64	Experimental setup EXE and portable ZIP. Optional Spotify playback requires WebView2.
Ubuntu 24.04, x86-64	Experimental Debian package with a clean-install launch check.

On macOS, open the DMG and drag Moosik to Applications. First launch may require approval in System Settings → Privacy & Security. See in-app updates for signing and update details.

Interactive sign-in and playback on the experimental packages still need testing on real hardware.

Build from source

Install Rust 1.90 or newer and the platform dependencies in the build guide. Playback uses libmpv; yt-dlp provides fallback resolution and other media features.

git clone https://github.com/AtotheY/moosik.git
cd moosik
cargo run --locked --release -p moosik --bin moosik

Account and playlists

Browse YouTube Music signed out, or choose Sign in → Use my [browser] login for your library and playlists. Open sign-in window also works with protected browser profiles. YouTube Music downloads require a verified YouTube Premium or YouTube Music Premium membership.

YouTube playlist edits follow the playlist’s visibility settings. Save privately keeps songs and local files in a playlist on this computer. Keep session files and cookies private when sharing diagnostics.

Contribute

To test a feature on a Mac, run ./scripts/ui-session start --page library from the checkout you’re editing. It opens the full app on a private Linux desktop with sample music, so you can navigate, test playback and take screenshots while continuing to use your Mac. See the offscreen testing guide for setup, controls and cleanup.

Report a bug, suggest a feature, or help test a platform. Read CONTRIBUTING.md before starting a larger change. Planned work is in the roadmap.

Credits and license

gridoe and the original contributors: playback, API integration, and the original desktop interface.
Sonora and ytmusic-rs: direct stream URL resolution.
yt-dlp: fallback resolution.
youtui: ytmapi-rs and the rusty_ytdl fork used by the optional native resolver.
ytmdesktop: queue continuation.
Spotify's desktop app: shortcuts, selection behavior, and album, playlist, and artist page layouts.
LRCLIB: synced lyrics.
Theme palettes: Catppuccin, Nord, Gruvbox, Tokyo Night, Dracula, Rosé Pine, Everforest, Solarized and Spotify's own colours. Each file in crates/moosik/themes names its source.

Maintained by AtotheY. Licensed under GPL-3.0-or-later, including this fork's changes. Existing copyright notices and dependency licenses apply.

Moosik is an unofficial client, independent of Google and Spotify. YouTube and YouTube Music are trademarks of Google LLC. Changes to either service can affect browsing and playback. Use is subject to the applicable service terms.