explaingit

metrolistgroup/metrolist

9,305KotlinAudience · generalComplexity · 2/5Setup · easy

TLDR

A free Android app that streams YouTube Music with features the official app lacks, including offline downloads, background play with screen off, an equalizer, and real-time synced lyrics.

Mindmap

mindmap
  root((Metrolist))
    Features
      Offline downloads
      Background play
      Equalizer
      Synced lyrics
    Social
      Group listening
      Playlist import
    Distribution
      GitHub Releases
      IzzyOnDroid
      Obtainium
    Tech
      Kotlin
      Android
      Rust WebAssembly
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Download YouTube Music songs for offline listening on Android without needing the official premium subscription.

USE CASE 2

Listen with real-time synced lyrics and AI-assisted translation in languages you're learning.

USE CASE 3

Share a listening session with friends so you hear the same music in real time.

USE CASE 4

Use an equalizer, tempo controls, and audio normalization that the official YouTube Music app does not offer.

Tech stack

KotlinAndroidMaterial 3RustWebAssembly

Getting it running

Difficulty · easy Time to first run · 5min

YouTube Music must be available in your country, otherwise a VPN connected to a supported region is required.

Free and open-source, the project accepts optional donations but the app itself costs nothing.

In plain English

Metrolist is a free, open-source Android app that lets you stream music from YouTube Music with more features and flexibility than the official app. It is built in Kotlin, the standard language for modern Android development, and uses Google's Material 3 design system, so it looks like a polished, native Android app. The main draw is the combination of features the official YouTube Music app does not offer or limits. These include downloading songs for offline playback, background audio with screen off, an equalizer, tempo and pitch controls, audio normalization, and real-time synced lyrics with AI-assisted translation. You can also listen simultaneously with friends in real-time, manage local playlists alongside your YouTube Music library, and import playlists from other sources. You do not need to install it from the Google Play Store. The app is distributed as an APK file through GitHub Releases and a few alternative app repositories, including IzzyOnDroid and Obtainium. There is also a nightly build channel for people who want the latest features before they are formally released. One important limitation noted in the README: YouTube Music must be available in your country for the app to work. If it is not, you would need a VPN connected to a supported region. The project is free to use and accepts donations via cryptocurrency and a Buy Me a Coffee link. It credits earlier open-source music players as its main inspiration. Community translation is managed through Weblate, and the project has active Discord and Telegram communities for support and announcements.

Copy-paste prompts

Prompt 1
I want to install Metrolist on my Android phone without using the Play Store. Where do I get the APK and how do I enable installing apps from unknown sources?
Prompt 2
Help me set up offline downloads in Metrolist so I can listen to my YouTube Music playlists without an internet connection.
Prompt 3
I want to use Metrolist's group listening feature to listen to music with a friend at the same time, how do I start a session and invite someone?
Prompt 4
I live in a country where YouTube Music is not available. Can I use Metrolist with a VPN, and how do I configure it to connect to a supported region?
Open on GitHub → Explain another repo

← metrolistgroup on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.