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 — это бесплатный клиент YouTube Music с открытым исходным кодом для Android: он стримит любую песню или видео из YouTube Music с воспроизведением в фоне, офлайн-загрузками, синхронизированными текстами песен и полным управлением медиатекой.
Как установить его на телефон?Скачайте APK с GitHub Releases (стабильные или ночные сборки) либо установите через Obtainium, IzzyOnDroid или OpenAPK.
Мне нужен аккаунт YouTube Music, чтобы пользоваться приложением?Начать слушать музыку можно сразу, без каких-либо настроек; вход в аккаунт YouTube Music — необязательная функция, которая синхронизирует песни, исполнителей, альбомы и плейлисты с вашей медиатекой.
Проект ещё активно развивается?Он находится в режиме поддержки: исправляются только ошибки и вносятся небольшие улучшения, а пулреквесты с новыми функциями или серьёзными изменениями приниматься не будут. Приложение не заброшено — обновления публикуются в их Discord.
Будет ли работать, если YouTube Music недоступен в моей стране?Нет — приложение ограничено по регионам: без VPN или прокси с подключением к поддерживаемому региону оно вообще не заработает.
Можно ли слушать музыку вместе с друзьями в реальном времени?Да, есть режим совместного прослушивания в реальном времени, а также скробблинг на Last.fm и безопасная интеграция с Discord Rich Presence.
Можно поменять внешний вид приложения?Да — светлую, тёмную, чёрную и динамическую темы, динамические цвета с 19 готовыми палитрами, дизайн Material 3 и виджет на главный экран.
Может ли Metrolist определить песню, которая играет рядом со мной?Да — в нём есть функция распознавания музыки на основе интеграции с API Shazam, добавленная сообществом.
Size
125 MB
Stars
13.6K
Age
3y
Commits · 90 Days