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 是一款免费开源的 Android YouTube Music 客户端:可以在线播放 YouTube Music 上的任意歌曲或视频,支持后台播放、离线下载、同步歌词,以及完整的音乐库管理。
怎么把它装到手机上?从 GitHub Releases 下载 APK(有稳定版和 nightly 版),或者通过 Obtainium、IzzyOnDroid、OpenAPK 安装。
必须要有 YouTube Music 账号才能用吗?不用任何设置就可以直接在线播放;登录 YouTube Music 账号是可选功能,作用是把歌曲、歌手、专辑和播放列表同步到你的音乐库。
这个项目还在积极开发吗?项目已进入维护模式:只修复 bug 和做小的改进,不再接受新增功能或大改动的 PR。应用没有停更——更新会发布在他们的 Discord 上。
如果我的国家用不了 YouTube Music,它还能用吗?不能——这个应用有地区限制:不用 VPN 或代理连接到受支持的地区,它完全无法使用。
能和朋友一起实时听歌吗?可以,有实时一起听的模式,另外还支持 Last.fm scrobbling,以及安全的 Discord Rich Presence 集成。
能改变应用的外观吗?可以——有浅色、深色、纯黑和动态四种主题模式,包含 19 套预设配色方案的动态取色,采用 Material 3 设计,还有桌面小部件。
Metrolist 能识别我身边正在播放的歌曲吗?可以——它有听歌识曲功能,基于 Shazam API 集成实现,由社区贡献。
Size
125 MB
Stars
13.6K
Age
3y
Commits · 90 Days