Carti Music

Personal Playboi Carti-inspired Android music app forked from Metrolist

Carti Music is a personal Android music app experiment built on top of the open-source Metrolist codebase. The goal is to keep the original music functionality intact while transforming the first-run experience, home screen, player atmosphere, random discovery, visuals, and repository delivery into a darker Carti-centered product.

APK from Actions · Original Metrolist · License

---

What Changed

This fork keeps the Metrolist foundation and changes the product direction into a personal Carti-first music experience.

Area	Changes
Visual identity	Dark editorial interface with black/red palette, Opium-inspired atmosphere, gothic mark, red glow, analog grain, aura layers, and cinematic motion.
Home screen	Reworked into a Carti experience surface with era hero, visual archive, discography map, track wall, catalog cards, and Carti-focused actions.
Random action	The random/roulette experience is locked to Playboi Carti results instead of generic recommendations.
Discovery behavior	Other artists are still reachable through search, but the default home experience avoids generic artist/album recommendation blocks.
Player atmosphere	Added Carti-styled chrome/backdrop treatment, stronger dark-mode mood, visual motion layers, and a more immersive player feel.
Assets	Imported Carti era imagery from the local art folder into Android drawable resources for the hero, gallery, archive, covers, and Spotify-code visuals.
App icon	Reworked launcher visuals around an aggressive I AM MUSIC-inspired mark and dark red identity.
CI/CD	Added a GitHub Actions workflow that runs tests, lint, builds the FOSS debug APK, and uploads the APK artifact.

---

Visual Direction

The README and app now present the fork as a Carti-centered music client:

• I AM MUSIC / Opium mood: black base, red aura, monochrome luxury, sharp contrast.
• Whole Lotta Red energy: aggressive red highlights, darker visual rhythm, distorted editorial feeling.
• SoundCloud / early-era archive: raw covers, underground tape references, VHS-like visual language.
• Metrolist functionality: playback, cache, library, search, lyrics, account support, queues, and Android integrations remain based on the upstream app.

---

Core Features Preserved From Metrolist

• YouTube Music streaming support.
• Background playback.
• Download and cache support.
• Search for songs, videos, albums, artists, and playlists.
• Synced lyrics and lyrics tooling from the upstream project.
• Local playlists, library management, queues, and playback controls.
• Material 3 Android foundation with Kotlin and Jetpack Compose.
• Existing Metrolist service, player, library, and account architecture.

---

Build And APK

This repository is set up so GitHub can build the app instead of forcing a heavy local Android build.

GitHub Actions

The main workflow is:

.github/workflows/carti_android_ci.yml

It runs:

• unit tests;
• Android lint;
• FOSS debug APK build;
• APK artifact upload.

To get the APK:

1. Open Carti Android CI.
2. Open the latest successful workflow run.
3. Download the carti-foss-debug-apk artifact.
4. Extract the ZIP and install the generated debug APK.

Local Build

If you want to build locally:

./gradlew :app:assembleFossDebug

Expected debug APK location:

app/build/outputs/apk/foss/debug/

---

Repository Metadata

Suggested GitHub repository metadata:

Name: carti-music
Description: Personal Android music client forked from Metrolist with a Playboi Carti-inspired dark UI, Carti-first home experience, custom visuals, and CI-built APKs.
Homepage: https://github.com/teuzowebdeveloper9/carti-music

Suggested topics:

android
kotlin
jetpack-compose
material3
music-player
youtube-music
metrolist
playboi-carti
carti
opium-aesthetic
android-app
github-actions
personal-fork

---

Tech Stack

• Kotlin
• Android
• Jetpack Compose
• Material 3
• Gradle
• GitHub Actions
• Metrolist/InnerTube music client foundation

---

Upstream Credit

This project is a personal fork of Metrolist, a third-party YouTube Music client for Android. The core app foundation, playback architecture, YouTube Music integration, library behavior, and many original features come from the Metrolist project and its contributors.

Important upstream links:

• Original repository: https://github.com/MetrolistGroup/Metrolist
• Original license: GNU GPLv3
• Original project authors and contributors are credited through the upstream repository history.

---

Disclaimer

This is a personal, unofficial fork for private/experimental use.

This project is not affiliated with, funded, authorized, endorsed by, or associated with Playboi Carti, Opium, YouTube, Google LLC, Metrolist Group LLC, or any of their affiliates and subsidiaries.

All trademarks, artist names, album names, service marks, images, and intellectual property referenced in this project belong to their respective owners.