Skip to content

About

YouTube Music client and Local player for Android With the twist of Many different backends and frontends

Resources

Security policy

Stars

187 stars

Watchers

4 watching

Forks

 
 

Latest commit

 

History

6,882 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Metrolist app icon

MetroFuse [KMP]

An offline music player for Android and desktop, with optional provider plugins

Latest release License Downloads

MetroFuse plays local music out of the box, with no account, internet connection or installed plugins required. New installations open Offline Home. Home, Search and Library use local music by default. Click the Home title to choose an enabled plugin frontend; selecting Offline restricts playback to local or downloaded audio. Audio provider priority remains in the playback menus. On Windows, the app scans your Music folder and lets you add other folders. On Android, use Library → Add → Scan local music or Settings → Storage → Local music, then allow audio access. Songs, albums, artists, playlists, likes and listening history stay on the device.

App builds, APKs, installers and app ZIPs never include provider plugins. Provider packages remain separate and require manual installation through Plugins.

Read the user guide for local music setup, plugin formats and installation, account sources, custom interfaces, audio quality and recovery.

When direct audio resolution fails, the shared host searches eligible enabled providers and applies the original MetroFuse matcher to title, artist and duration. It retries with each matched provider's own track ID, respecting the selected audio source and exclusions. Native JAR/APK and JavaScript MFP providers use the same matching flow. Search results are cached for 90 seconds and cleared when the host invalidates provider caches.

The core Home switcher lists Offline first, followed by enabled plugins declaring the home capability. Optional manifest home.title and home.icon fields set the source's label and packaged icon. Native JAR/APK plugins can implement HomePlugin; JavaScript MFP plugins register host.home(callback). Home content uses generic CARDS or ROWS_GRID shelves. Requests use the user's content locale, have a 15-second deadline, and keep a separate cache and retry state for each source. Removing or disabling the selected source switches Home to Offline.

Library follows the selected frontend too. Providers implementing LibraryProvider supply their account's songs, albums, artists and playlists through paginated requests. Results appear as pages load and refresh after sign-in, sign-out or switching sources. UI plugins use the same Library feed. A selected provider's Library excludes local files, local playlists, local scanning controls and automatic device collections. Offline Library contains the device's local, downloaded and cached music.

Metrofuse Lyrics is available on Android and desktop in the configurable lyrics sources. Its API at https://metrofuse-lyrics-worker.amax69420lol.workers.dev/lyrics looks up songs by title, artist and known duration. Word, line and plain responses use the existing shared lyrics renderer and cache; word and line timestamps retain their millisecond precision. Word spacing follows the full line text, preserving contiguous syllables and scripts that do not use spaces. Word lyrics saved by the earlier API converter refresh when online, preserving saved offsets and source selections. Existing source controls, lyric offsets, click-to-seek and other providers remain available.

Providers can also expose their liked-song pages and support song votes. YouTube Music's Liked Music list supplies existing likes, and like, unlike and dislike actions use the plugin's signed-in account. The host refreshes likes when accounts or frontends change and preserves local favorites.

The profile button and app Settings remain available for every source. The profile menu adds account and login actions when the selected source declares login. Native plugins own account screens through NativeLoginUi; JavaScript plugins contribute the SDK's browser screen through the ui callback in host.login(callbacks). Reusable platform WebViews and the Windows helper live in plugin-sdk. The YouTube Music plugin owns its Google navigation rules, login text and account verification. Existing form and WebLoginPlugin/web callbacks remain compatible. The host observes account status, delivers submitted credentials only to the current activation and stores accepted sessions encrypted under the plugin ID. Windows uses user-bound DPAPI; Android uses Keystore AES-GCM. Plugin credential persistence is currently unavailable on Linux and macOS. Account changes clear cached audio and metadata and refresh that source's Home. Native plugins run trusted code in the host process; cooperative cancellation cannot forcibly stop arbitrary blocking native code.

See the plugin authoring guide for MFP, JAR and APK development, Home sources and login. The JioSaavn plugin and YouTube Music plugin have separate source repositories. Download JAR/APK/MFP packages from each repository's Releases and import them through Plugins. Use the native YouTube Music package for InnerTubeX audio, including SABR. Its JavaScript MFP has limited direct audio support. These packages are not included or installed in the app by default.

MetroFuse is based on Metrolist KMP. Upstream attribution and licenses are retained below. Earlier platform guides remain available through links to their source revision.

CI powered by Blacksmith Discord Telegram

Warning

The use of Metrolist to access YouTube Music may violate YouTube's Terms of Service.

You use Metrolist at your own risk. You are solely responsible for any consequences. Metrolist's contributors are not liable for damages, claims or actions against your account. We have received no reports of bans or restrictions for using Metrolist, but that does not guarantee your account's safety.

YouTube Music is region-restricted. If the service is unavailable in your region, you need a VPN or proxy in a supported region to use the app. Changing your DNS can bypass some blocks.

Features

  • YouTube Music playback with or without signing in
  • Android 7+, iOS 17+, Windows 10+, macOS 15+ and Linux support
  • Material 3 Expressive design
  • Discord Rich Presence and scrobbling through Last.fm and ListenBrainz
  • No ads
  • Listen Together for shared playback online
  • Casting to Google Cast, F-Cast and SONOS devices, and over DLNA (Android and desktop)
  • Backup and playlist imports from 30+ clients and 6 services
  • Music recognition through Shazam
  • Lyrics with translation and romanization
  • Translations in over 15 languages
  • Video playback (Android and desktop)
  • Content filters for AI-generated content, explicit-only playback and SFW-only playback
  • Canvas from Apple Music, Spotify and YouTube Music
  • Desktop Canvas fullscreen with a feathered video/blur split, Apple-style lyrics and the regular player controls
  • Audio format badge with the source codec, original bit depth, exact sample rate and bitrate; hover for values in Hz and bit/s. Unknown fields stay hidden, and container averages are labelled separately.
  • Player, thumbnail, miniplayer and background styles
  • Custom fonts and app icons

Tip

See the FAQ for common questions.


Download now

Install Metrolist KMP: Android, iOS, Windows, macOS or Linux. Check KMP download availability before choosing a package.

Choose a KMP release for your device

Windows

Windows 10+ · pick your chip

x64 · installer and portable

Download the Windows installer (.exe)

Download the portable Windows x64 package (.zip)

ARM64 · portable only

Download the portable Windows ARM64 package (.zip)

macOS

macOS 15+ · pick your chip

Download Metrolist for macOS on Apple silicon (.dmg)

Download Metrolist for macOS on Intel (.dmg)

Unsigned app, you need to trust it first

iOS

iPhone & iPad · iOS 17+

Download the iOS IPA package

AltStore, SideStore, TrollStore or Sideloadly

Android

Android 7+

Download the stable Android APK

Linux

glibc · pick your chip

x86_64 · AppImage or packages

Download the x86_64 Linux AppImage

Get the AUR PKGBUILD for Metrolist

Get the Nix flake

ARM64 · AppImage only

Download the ARM64 Linux AppImage

Android stores

The app already has a built-in updater.

Add the Metrolist KMP repository to Obtainium

Find Metrolist in the IzzyOnDroid F-Droid repository

Find the Metrolist APK on OpenAPK


Support the project

Metrolist is free and open-source. Donations support its development.

Sponsor nyxiereal Buy Me a Coffee Sponsor l6t9 Sponsor adrielggmotion

Donate Monero to Mostafa Alagamy

Monero QR code

44XjSELSWcgJTZiCKzjpCQWyXhokrH9RqH3rpp35FkSKi57T25hniHWHQNhLeXyFn3DDYqufmfRB1iEtENerZpJc7xJCcqt

Special thanks

Metrolist uses these projects and services.

Project Contribution
MusicRecognizer Music recognition through the Shazam API
InnerTubeX YouTube streaming engine, developed with help from ZemerTeam
Lyprio Lyrics provider
metroserver Listen Together real-time synchronization backend
Blacksmith GitHub Actions runners for CI

Translations

Translation status

We use Weblate to translate Metrolist. Contribute a translation.

Translation status

Contributors

To contribute code, start with the developer docs.

Contributors

Warning

Legal disclaimer

This project is not affiliated with, funded, authorized or endorsed by YouTube, Google LLC, MetroList MLS, or their affiliates and subsidiaries.

All trademarks, service marks, and intellectual property rights referenced in this project belong to their respective owners.


Developed by the Metrolist development team

This project stands with Palestine 🇵🇸

About

YouTube Music client and Local player for Android With the twist of Many different backends and frontends

Resources

Security policy

Stars

187 stars

Watchers

4 watching

Forks

Releases

Packages

Used by

Contributors

Languages