MetrolistGroup

MetrolistGroup/Metrolist

YouTube Music client for Android

View on GitHub Website / Demo Back to listing

13.5kstars 1.1kforks 100+contributors Kotlin

README.md

View on GitHub

# Metrolist

### YouTube Music client for Android

<br/>

[![Latest release](https://img.shields.io/github/v/release/MetrolistGroup/Metrolist?style=for-the-badge&labelColor=0d1117)](https://github.com/MetrolistGroup/Metrolist/releases)
[![License](https://img.shields.io/github/license/MetrolistGroup/metrolist?style=for-the-badge&labelColor=0d1117)](https://github.com/MetrolistGroup/Metrolist/blob/main/LICENSE)
[![Downloads](https://img.shields.io/github/downloads/MetrolistGroup/Metrolist/total?style=for-the-badge&labelColor=0d1117)](https://github.com/MetrolistGroup/Metrolist/releases)

<br/>

[![Discord](https://img.shields.io/badge/Discord-%235865F2.svg?style=for-the-badge&logo=discord&logoColor=white&labelColor=0d1117)](https://dsc.gg/metrolist)
[![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white&labelColor=0d1117)](https://t.me/metrolistapp)

<br/>

[**Download**](#download-now) · [**Features**](#features) · [**Translate**](#translations) · [**FAQ**](#faq) · [**Support**](#support-the-project)

</div>

> [!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.

---

<h1><a id="screenshots"></a>Screenshots</h1>

</div>

---

<h1><a id="features"></a>Features</h1>

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

</td>
    <td width="50%" valign="top">

#### Audio
- Audio normalization
- Tempo & pitch control
- Equalizer
- Crossfade

</td>
  </tr>
  <tr>
    <td width="50%" valign="top">

#### Lyrics & Discovery
- Live synced lyrics
- AI-powered lyrics translation
- Personalized quick picks
- Search songs, albums, artists, videos, and playlists

</td>
    <td width="50%" valign="top">

#### 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

</td>
  </tr>
  <tr>
    <td width="50%" valign="top">

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

</td>
    <td width="50%" valign="top">

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

</td>
  </tr>
</table>

</div>

---

<h1><a id="download-now"></a>Download Now</h1>

<h2>Stable Release</h2>

<table>
  <tr>
    <th align="center">Obtainium</th>
    <th align="center">IzzyOnDroid</th>
  </tr>
  <tr>
    <td align="center">
      <a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/MetrolistGroup/Metrolist/">
        <img src="assets/badges/obtainium.svg" alt="Add Metrolist to Obtainium" height="100">
      </a>
    </td>
    <td align="center">
      <a href="https://apt.izzysoft.de/fdroid/index/apk/com.metrolist.music">
        <img src="assets/badges/izzyondroid.svg" alt="Get Metrolist on IzzyOnDroid" height="100">
      </a>
    </td>
  </tr>
  <tr>
    <th align="center">OpenAPK</th>
    <th align="center">GitHub</th>
  </tr>
  <tr>
    <td align="center">
      <a href="https://www.openapk.net/metrolist/com.metrolist.music/">
        <img src="assets/badges/openapk.svg" alt="Get Metrolist on OpenAPK" height="100">
      </a>
    </td>
    <td align="center">
      <a href="https://github.com/MetrolistGroup/Metrolist/releases/latest/download/Metrolist.apk">
        <img src="assets/badges/github-stable.svg" alt="Get the stable Metrolist release on GitHub" height="100">
      </a>
    </td>
  </tr>
</table>

<h2>Nightly Build</h2>

<table>
  <tr>
    <th align="center">GitHub</th>
  </tr>
  <tr>
    <td align="center">
      <a href="https://github.com/MetrolistGroup/Metrolist/releases/download/nightly/Metrolist-with-Google-Cast.apk">
        <img src="assets/badges/github-nightly.svg" alt="Get the Metrolist nightly build on GitHub" height="120">
      </a>
    </td>
  </tr>
</table>

</div>

---

<h3>Got questions? Check out our <a href="https://metrolist.cc/#faq">FAQ page</a> for answers to the most common ones.</h3>

</div>

---

<h1><a id="translations"></a>Translations</h1>

[![Translation status](https://img.shields.io/weblate/progress/metrolist?style=for-the-badge&labelColor=0d1117)](https://hosted.weblate.org/engage/metrolist/)

<h3>We use Weblate to translate Metrolist. <a href="https://hosted.weblate.org/projects/Metrolist/">Help us bring Metrolist to more people!</a></h3>

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

</div>

---

<h1><a id="support-the-project"></a>Support the Project</h1>

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

#### Monero (XMR)

```text
44XjSELSWcgJTZiCKzjpCQWyXhokrH9RqH3rpp35FkSKi57T25hniHWHQNhLeXyFn3DDYqufmfRB1iEtENerZpJc7xJCcqt
```

#### Buy Me a Coffee

</div>

---

<h1>Special Thanks</h1>

<h3>Metrolist stands on the shoulders of incredible open-source work.</h3>

<h3>Main Inspirations</h3>

<table>
  <thead>
    <tr>
      <th align="center">Project</th>
      <th align="center">Authors</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td align="center"><strong>InnerTune</strong></td>
      <td align="center"><a href="https://github.com/z-huang">Zion Huang</a> · <a href="https://github.com/Malopieds">Malopieds</a></td>
    </tr>
    <tr>
      <td align="center"><strong>OuterTune</strong></td>
      <td align="center"><a href="https://github.com/DD3Boh">Davide Garberi</a> · <a href="https://github.com/mikooomich">Michael Zh</a></td>
    </tr>
  </tbody>
</table>

<h3>Libraries & Integrations</h3>

<table>
  <thead>
    <tr>
      <th align="center">Project</th>
      <th align="center">Contribution</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td align="center"><a href="https://better-lyrics.boidu.dev"><strong>Better Lyrics</strong></a></td>
      <td>Time-synced lyrics with word-by-word highlighting & YouTube Music integration</td>
    </tr>
    <tr>
      <td align="center"><a href="https://github.com/MetrolistGroup/metroserver"><strong>metroserver</strong></a></td>
      <td>Listen-together real-time backend</td>
    </tr>
    <tr>
      <td align="center"><a href="https://github.com/aleksey-saenko/MusicRecognizer"><strong>MusicRecognizer</strong></a></td>
      <td>Music recognition feature & Shazam API integration</td>
    </tr>
    <tr>
      <td align="center"><a href="https://github.com/ZemerTeam/zemer-cipher"><strong>zemer-cipher</strong></a></td>
      <td>YouTube cipher deobfuscation and PoToken generation</td>
    </tr>
    <tr>
      <td align="center"><a href="https://www.blacksmith.sh"><strong>Blacksmith</strong></a></td>
      <td>High-performance GitHub Actions runners powering our CI</td>
    </tr>
  </tbody>
</table>

<br/>

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

</div>

---

<h1>Contributors</h1>

<h3>This project wouldn't exist without these amazing people!</h3>

</div>

---

<h1>Disclaimer</h1>

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.

</div>

---

<br/>

**Made with ❤️ by [Mo Agamy](https://github.com/mostafaalagamy)**

**This project stands with Palestine 🇵🇸**

</div>

Repository info

Default branch: main
Latest version: v13.7.0
Created: 2023-08-11
Last activity: 2026-10-08
License: GPL-3.0
Open issues: 393
Watchers: 127

Contributors

mostafaalagamy

1k contributions

nyxiereal

227 contributions

weblate

213 contributions

renovate[bot]

150 contributions

Mickael81

97 contributions