# Metrolist

> Free, open-source YouTube Music client for Android, iOS, Windows, macOS, and Linux. No ads, background play, synced lyrics, offline downloads, and casting.

Metrolist is built with Kotlin Multiplatform. Source code: https://github.com/MetrolistGroup/Metrolist (GPL-3.0).

Source: https://metrolist.cc/

## Features

- **Ad-free listening:** Stream songs and videos from YouTube Music without ads.
- **Synchronized lyrics:** Follow synchronized lyrics with word-by-word timing, translation, and romanization where available.
- **Listen Together:** Create a room, suggest songs, and keep playback synchronized.
- **Casting:** Send playback to Chromecast, DLNA, and FCast devices directly from the player.
- **Offline listening:** Download songs or cache them as you listen for playback without a connection.
- **Audio controls:** Use skip silence, a sleep timer, audio normalization, tempo and pitch controls, and an equalizer.

## Platforms and installation

Download builds from https://github.com/MetrolistGroup/Metrolist/releases/latest.

### Android

Android 7 and newer. Package: APK. Architectures: Universal.

1. Download the APK for your device.
2. Allow installs from this source when Android asks.
3. Open the APK and follow the installation prompt.

### iOS

iOS 17 and newer. Package: IPA. Architectures: iPhone & iPad.

1. Download the unsigned IPA.
2. Open it in AltStore, SideStore, or Sideloadly.
3. Follow your sideloading app’s prompts to sign and install Metrolist.

### Linux

Most modern distributions. Package: AppImage. Architectures: x64, ARM64.

1. Download the AppImage for your architecture.
2. Make the file executable.
3. Run it directly or add it to your application menu.

### macOS

macOS 15 and newer · Apple silicon and Intel. Package: DMG. Architectures: Apple silicon, Intel.

1. Download and open the DMG for your Mac.
2. Drag Metrolist into Applications.
3. Open Metrolist from Applications and approve the first launch.

### Windows

Windows 10 and newer. Package: Installer or portable ZIP. Architectures: x64, ARM64.

1. Download the EXE installer or portable ZIP for your architecture.
2. For the EXE, run the installer and follow the prompts, then launch Metrolist from the Start menu.
3. For the ZIP, extract it to a folder and run Metrolist from the extracted folder.
