Metrolist README

The project's README from github.com/MetrolistGroup/Metrolist. As one markdown file: README.md.

Metrolist app icon

Metrolist

YouTube Music client for Android


CI powered by Blacksmith

Latest release License Downloads


Discord Telegram


Download · Features · Translate · FAQ · Support

[!WARNING]

MAINTENANCE MODE

Metrolist is currently in maintenance mode. This means we will only be fixing bugs and making minor improvements. Please do not submit PRs for new features or major changes, as they will not be accepted.
The app is NOT dead, please stay tuned for updates on our discord (found above).

[!WARNING] Regional Restriction - If YouTube Music is unavailable in your region, this app will not work without a VPN or proxy connecting to a supported region.

Screenshots

Home screen Artist screen Recognize music screen Listen together screen Player screen Player lyrics screen

Features

Playback

  • Stream any song or video from YouTube Music
  • Background playback
  • Download & cache for offline use
  • Skip silence
  • Sleep timer

Audio

  • Audio normalization
  • Tempo & pitch control
  • Equalizer
  • Crossfade

Lyrics & Discovery

  • Live synced lyrics
  • AI-powered lyrics translation
  • Personalized quick picks
  • Search songs, albums, artists, videos, and playlists

Library & Account

  • Full library management
  • Local playlists
  • Import playlists
  • Reorder songs in playlist or queue
  • YouTube Music account login
  • Sync songs, artists, albums, and playlists

Social

  • Listen together with friends in real-time
  • Last.fm integration for scrobbling
  • Safe Discord Rich Presence

Interface

  • Home screen widget
  • Light / Dark / Black / Dynamic theme modes
  • Dynamic color + 19 preset color palettes
  • Built with Material 3

Download Now

Stable Release

Obtainium IzzyOnDroid
Add Metrolist to Obtainium Get Metrolist on IzzyOnDroid
OpenAPK GitHub
Get Metrolist on OpenAPK Get the stable Metrolist release on GitHub

Nightly Build

GitHub
Get the Metrolist nightly build on GitHub

FAQ

Got questions? Check out our FAQ page for answers to the most common ones.

Translations

Translation status

We use Weblate to translate Metrolist. Help us bring Metrolist to more people!

Translation status

Thank you! Every translation makes Metrolist a little more accessible to someone, somewhere in the world.

Support the Project

Metrolist is free and open-source. If it brings you joy, consider supporting its development!

Monero (XMR)

Monero QR code 
44XjSELSWcgJTZiCKzjpCQWyXhokrH9RqH3rpp35FkSKi57T25hniHWHQNhLeXyFn3DDYqufmfRB1iEtENerZpJc7xJCcqt

Buy Me a Coffee

Buy Me a Coffee

Special Thanks

Metrolist stands on the shoulders of incredible open-source work.

Main Inspirations

Project Authors
InnerTune Zion Huang · Malopieds
OuterTune Davide Garberi · Michael Zh

Libraries & Integrations

Project Contribution
Better Lyrics Time-synced lyrics with word-by-word highlighting & YouTube Music integration
metroserver Listen-together real-time backend
MusicRecognizer Music recognition feature & Shazam API integration
zemer-cipher YouTube cipher deobfuscation and PoToken generation
Blacksmith High-performance GitHub Actions runners powering our CI

CI powered by Blacksmith

We also thank the entire open-source community! For every library, tool, and API that powers this project.

Contributors

This project wouldn't exist without these amazing people!

Contributors

Disclaimer

This project is not affiliated with, funded, authorized, endorsed by, or in any way associated with YouTube, Google LLC, Metrolist Group LLC, or any of their affiliates and subsidiaries.

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


Made with ❤️ by Mo Agamy

This project stands with Palestine 🇵🇸

Metrolist (MetrolistGroup/Metrolist)

Searching Database…

13.6K ·GitHub
Metrolist
What is this?Metrolist is a free and open-source YouTube Music client for Android: it streams any song or video from YouTube Music with background playback, offline downloads, synced lyrics, and full library management.
How do I install it on my phone?Grab the APK from GitHub Releases (stable or nightly builds), or install through Obtainium, IzzyOnDroid, or OpenAPK.
Do I need a YouTube Music account to use it?You can start streaming without any setup; logging into your YouTube Music account is an optional feature that syncs songs, artists, albums, and playlists with your library.
Is the project still actively developed?It is in maintenance mode: only bug fixes and minor improvements are being made, and PRs adding new features or major changes will not be accepted. The app is not dead — updates are posted on their Discord.
Will it work if YouTube Music is not available in my country?No — the app is region-restricted: without a VPN or proxy connecting to a supported region, it will not work at all.
Can I listen together with friends in real time?Yes, there is a real-time listen-together mode, plus Last.fm scrobbling and a safe Discord Rich Presence integration.
Can I change how the app looks?Yes — Light, Dark, Black and Dynamic theme modes, dynamic color with 19 preset palettes, Material 3 design, and a home screen widget.
Can Metrolist identify a song that is playing around me?Yes — it has a music recognition feature powered by a Shazam API integration, contributed by the community.
What are similar projects?ArchiveTune, LastWave-Native, vivi-music, Echo-Music, Levyra-deepsound, BitChord, YumaPlayer, SimpMusic
Which topics is it in?ytmusic, lyrics, newpipe, material-ui, youtube-music, kotlin-android, material3, jetpack-compose, music-player, material-design, foss, discord
Creator
MetrolistGroup
Size
125 MB
Stars
13.6K
Updated
CommitOct 08Releasev13.7.0Sep 07
Age
3y
Commits · 90 Days