ArchiveTune - GitLite

KO | EN

gitlite — search

#video #vue #react-native #developer-tools #artificial-intelligence #ui #golang #hacktoberfest #anthropic #java

ArchiveTune

(★ 4,890)

🌸 The Cutest Music Player With Support Local File and Youtube Music for Android!

File Explorer

ZIP Download

- - bug_report.yml
  - config.yml
  - feature_request.yml
- - build.yml
  - build_pull_request.yml
  - deploy_artifacts.py
  - header.yml
  - notify_telegram.py
  - notify_user.yml
  - release.yml
- copilot-instructions.md
- FUNDING.yml
- pull_request_template.md
- README.md
- .gitignore
- build.gradle.kts
- lint.xml
- persistent-debug.keystore
- proguard-rules.pro
- Announcement.json
- badge_doyo.png
- badge_github.png
- badge_part.png
- badge_unclouded.png
- buymeacoffee.png
- ic_launcher-playstore.png
- IzzyOnDroidButtonBorder.svg
- tribe.png
- build.gradle.kts
- build.gradle.kts
- - gradle-wrapper.jar
  - gradle-wrapper.properties
- gradle-daemon-jvm.properties
- libs.versions.toml
- .gitignore
- build.gradle.kts
- build.gradle.kts
- build.gradle.kts
.editorconfig
.gitignore
.gitmodules
ArchiveTuneKoiverseServer.txt
build.gradle.kts
CODE_OF_CONDUCT.md
CONTRIBUTING.md
core
DataServer.txt
detekt.yml
div
div.blyrics--active
gradle.properties
gradlew
gradlew.bat
IconPack
Koiverse.jks
Koiverse.jks.base64
LICENSE
lint.xml
lyrics
morideobfuscator
moriextractor
PRIVACY.md
README.md
README_JA.md
renovate.json
settings.gradle.kts

# Installation Guide

android

Prerequisites

Android SDK API 24+
JDK 17+

Setup Steps

./gradlew assembleDebug

Build the debug APK using Gradle.

Key Commands

./gradlew assembleDebug

Builds a debug APK for development and testing.

./gradlew assembleRelease

Builds a release APK for production.

A VPN may be required if YouTube Music is not supported in your region.

# Use via CDN

jsDelivr

jsDelivr serves any public GitHub repository as a CDN with zero setup. Pick a version and a file to get a ready-to-paste link and snippet.

Version

File

Link

Example

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

<div align="center">

<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/icon.png" width="160" height="160" alt="ArchiveTune Logo" style="border-radius: 22%">

<h1>ArchiveTune</h1>

<p align="center">
    <a href="README.md">
      <img src="https://img.shields.io/badge/🇺🇸%20English-6366f1?style=for-the-badge&labelColor=1e1e2e" />
    </a>
    <a href="README_JA.md">
      <img src="https://img.shields.io/badge/🇯🇵%20日本語-6366f1?style=for-the-badge&labelColor=1e1e2e" />
    </a>
  </p>

<p align="center">
    <strong>Redefining the YouTube Music Experience on Android.</strong>
    <br />
    <em>It’s high-performance, privacy-focused, and packed with features for people who really care about their experience.</em>
  </p>

<p align="center">
    <a href="https://archivetune.koiiverse.cloud"><b>Official Website</b></a> •
    <a href="#features"><b>Features</b></a> •
    <a href="https://archivetune.koiiverse.cloud/privacy"><b>Privacy</b></a> •
    <a href="#download-now"><b>Download</b></a> •
    <a href="#screenshots"><b>Screenshots</b></a> •
    <a href="https://github.com/rukamori/ArchiveTune/issues/new/choose"><b>Support</b></a>
  </p>

<div align="center">
    <img src="https://img.shields.io/github/v/release/rukamori/ArchiveTune?style=for-the-badge&color=6366f1&labelColor=1e1e2e&logo=github" alt="Latest Version" />
    <img src="https://img.shields.io/github/downloads/rukamori/ArchiveTune/total?style=for-the-badge&color=6366f1&labelColor=1e1e2e&logo=github" alt="Downloads" />
    <img src="https://img.shields.io/github/stars/rukamori/ArchiveTune?style=for-the-badge&color=6366f1&labelColor=1e1e2e&logo=github" alt="Stars" />
    <img src="https://img.shields.io/github/license/rukamori/ArchiveTune?style=for-the-badge&color=6366f1&labelColor=1e1e2e" alt="License" />
    <img src="https://img.shields.io/badge/Architecture-MVVM-6366f1?style=for-the-badge&labelColor=1e1e2e&logo=kotlin" alt="MVVM Architecture" />
    <img src="https://img.shields.io/badge/Language-Kotlin-7f52ff?style=for-the-badge&logo=kotlin&color=6366f1&labelColor=1e1e2e" alt="Kotlin Language" />
    <img src="https://img.shields.io/badge/Toolkit-Jetpack_Compose-4285f4?style=for-the-badge&logo=jetpack-compose&color=6366f1&labelColor=1e1e2e" alt="Jetpack Compose Toolkit" />
    <img src="https://img.shields.io/badge/Design-Material_3-000000?style=for-the-badge&logo=material-design&color=6366f1&labelColor=1e1e2e" alt="Material Design 3" />
    <a href="https://www.virustotal.com/gui/file/176bea37aff02a606d04ff0a61478fabdb0bd079f9e97319645452af420e5d84/detection/f-176bea37aff02a606d04ff0a61478fabdb0bd079f9e97319645452af420e5d84-1778840479" target="_blank"><img src="https://img.shields.io/badge/VirusTotal-SAFE-green?style=for-the-badge&logo=virustotal&logoColor=white&labelColor=1e1e2e&color=5865F2" alt="VirusTotal" /></a>
    <a href="https://t.me/ArchiveTuneGC"><img src="https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white" alt="Telegram" /></a>
    <a href="https://discord.gg/XF2fpb9rTq"><img src="https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white" alt="Discord" /></a>
  </div>
  
  <br />

<a href="https://trendshift.io/repositories/17521" target="_blank">
    <img src="https://trendshift.io/api/badge/repositories/17521" alt="ArchiveTune | Trendshift" style="width: 250px; height: 55px;" width="250" height="55"/>
  </a>
</div>

<hr />

> [!WARNING]
**Forks are not supported in any way.**  
We do not provide support, maintenance, troubleshooting, or assistance for any forked version of this project.
If you choose to use a fork, you do so at your own risk.

**ArchiveTune** isn’t just another generic YouTube Music wrapper. It’s a fully custom-built player made from the ground up, because we think your music should stay private, look clean, and work exactly the way you expect. If you care about sound quality and want something that actually feels good to use, this is it.

---

> [!IMPORTANT]  
> **Geographic Availability:** If YouTube Music is not supported in your region, a VPN or proxy set to a supported region is required for initial data fetching.

---

## 📸 Showcase

<div align="center">

<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_1.jpg" alt="Browse" width="30%" />
<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_2.jpg" alt="Live Lyrics" width="30%" />
<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_3.jpg" alt="Theme Customization" width="30%" />
<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_4.jpg" alt="Live Statistics" width="30%" />
<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_5.jpg" alt="Artist" width="30%" />
<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_6.jpg" alt="Album" width="30%" />
<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_7.jpg" alt="Player" width="30%" />
<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_8.jpg" alt="Settings" width="30%" />
<img src="https://github.com/rukamori/ArchiveTune/blob/main/fastlane/metadata/android/en-US/images/phoneScreenshots/screenshot_9.jpg" alt="Settings" width="30%" />

</div>

---

## ✨ Features

<div align="center">

<table>
  <tr>
    <td width="50%" valign="top">
      <div align="left">
        <h3>Playback</h3>
        <ul>
          <li>Multiple account support with quick switching</li>
          <li>Ad-free playback with background listening</li>
          <li>Your playlists, liked songs, and subscriptions appear after sign-in</li>
          <li>Support local file and local song playback
          <li>Fast startup and lightweight performance</li>
          <li>Built for a private, uninterrupted listening experience</li>
        </ul>
      </div>
    </td>
    <td width="50%" valign="top">
      <div align="left">
        <h3>Audio</h3>
        <ul>
          <li>EBU R128 loudness normalization</li>
          <li>Tempo, pitch, and playback speed controls</li>
          <li>Crossfade between tracks</li>
          <li>System equalizer and spatial audio integration</li>
        </ul>
      </div>
    </td>
  </tr>
  <tr>
    <td width="50%" valign="top">
      <div align="left">
        <h3>Lyrics &amp; Discovery</h3>
        <ul>
          <li>Live synced lyrics</li>
          <li>Lyrics translation, AI Lyrics translation and romanization</li>
          <li>Music recognition for songs around you</li>
          <li>Listening statistics whenever you want them</li>
        </ul>
      </div>
    </td>
    <td width="50%" valign="top">
      <div align="left">
        <h3>Sync &amp; Social</h3>
        <ul>
          <li>Import playlist from spotify</li>
          <li>YouTube Music account integration</li>
          <li>Last.fm scrobbling</li>
          <li>ListenBrainz history sync</li>
          <li>Discord rich presence support</li>
        </ul>
      </div>
    </td>
  </tr>
  <tr>
    <td width="50%" valign="top">
      <div align="left">
        <h3>Interface</h3>
        <ul>
          <li>Material 3 design language</li>
          <li>Album-art powered dynamic colors</li>
          <li>Up to 9 different player styles</li>
          <li>Up to 8 different player background styles</li>
          <li>Responsive layouts for different screen sizes</li>
          <li>Clean browsing, player, artist, album, and lyrics views</li>
        </ul>
      </div>
    </td>
    <td width="50%" valign="top">
      <div align="left">
        <h3>Customization</h3>
        <ul>
          <li>Deep playback and interface settings</li>
          <li>Dynamic color theming options</li>
          <li>Gesture customization</li>
          <li>Animation and layout tuning</li>
          <li>Flexible controls to shape the app around your workflow</li>
        </ul>
      </div>
    </td>
  </tr>
</table>

</div>

---

## 📥 Download Now

<div align="center">

<h2>Stable Release</h2>

<table>
  <thead>
    <tr>
      <th align="center">Obtainium</th>
      <th align="center">IzzyOnDroid</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td align="center">
        <a href="https://apps.obtainium.imranr.dev/redirect?r=obtainium://add/https://github.com/rukamori/ArchiveTune/">
          <img src="https://github.com/ImranR98/Obtainium/blob/main/assets/graphics/badge_obtainium.png" height="50" alt="Get ArchiveTune on Obtainium">
        </a>
      </td>
      <td align="center">
        <a href="https://apt.izzysoft.de/fdroid/index/apk/moe.rukamori.archivetune">
          <img src="https://raw.githubusercontent.com/rukamori/ArchiveTune/757d5932832e1da27ced56de98c5ad1275cf0db1/assets/IzzyOnDroidButtonBorder.svg" height="50" alt="Get ArchiveTune on IzzyOnDroid">
        </a>
      </td>
    </tr>
    <tr>
      <th align="center" colspan="2">GitHub</th>
    </tr>
    <tr>
      <td align="center" colspan="2">
        <a href="https://github.com/rukamori/ArchiveTune/releases/latest">
          <img src="https://raw.githubusercontent.com/rukamori/ArchiveTune/refs/heads/main/assets/badge_github.png" height="50" alt="Get ArchiveTune on GitHub">
        </a>
      </td>
    </tr>
    <tr>
      <th align="center">OpenAPK</th>
      <th align="center">Unclouded</th>
    </tr>
    <tr>
      <td align="center">
        <a href="https://www.openapk.net/archivetune/moe.rukamori.archivetune/">
          <img src="https://www.openapk.net/images/openapk-badge.png" height="75" alt="Get ArchiveTune on OpenAPK">
        </a>
      </td>
      <td align="center">
        <a href="https://unclouded.app/apps/archivetune/">
          <img src="https://raw.githubusercontent.com/rukamori/ArchiveTune/refs/heads/dev/assets/badge_unclouded.png" height="50" alt="Get ArchiveTune on Unclouded">
        </a>
      </td>
    </tr>
  </tbody>
</table>

<h2>Nightly Build</h2>

<table>
  <thead>
    <tr>
      <th align="center">GitHub Actions</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <td align="center">
        <a href="https://nightly.link/rukamori/ArchiveTune/workflows/build/dev/app-gms-mobile-universal-release">
          <img src="https://raw.githubusercontent.com/rukamori/ArchiveTune/refs/heads/main/assets/badge_github.png" height="50" alt="Download the latest ArchiveTune nightly build">
        </a>
      </td>
    </tr>
  </tbody>
</table>
</div>

> [!WARNING]  
> **Notes:** The trusted download source is listed above; we are not responsible for any risks you may encounter from downloading from other sources.

## ❓ Need Help or Have Questions?
Join Our Telegram Channels or Discord Servers for Support and Discussion.

[![Telegram](https://img.shields.io/badge/Telegram-2CA5E0?style=for-the-badge&logo=telegram&logoColor=white)](https://t.me/ArchiveTuneGC)
[![Discord](https://img.shields.io/badge/Discord-5865F2?style=for-the-badge&logo=discord&logoColor=white)](https://discord.gg/XF2fpb9rTq)

---

## 🌍 Globalization

ArchiveTune belongs to everyone. Help us localize the experience for your region.

[![Static Badge](https://img.shields.io/badge/translate-help?style=for-the-badge&logo=weblate&labelColor=grey)](https://translate.codeberg.org/engage/archivetune/)

<div align="center">
  <a href="https://translate.codeberg.org/engage/archivetune/">
    <img src="https://translate.codeberg.org/widget/archivetune/horizontal-blue.svg" alt="Translation status" />
  </a>
</div>

### ✨ Project Contributors
<a href="https://github.com/rukamori/ArchiveTune/graphs/contributors">
  <img src="https://contrib.rocks/image?repo=rukamori/ArchiveTune&columns=6" />
</a>

### 🛠️ Development & Engineering
Interested in building the project or contributing? ArchiveTune is built on a high-performance Kotlin stack.
<a href="CONTRIBUTING.md"><b>Read the Build & Contribution Guide →</b></a>

---

### Open-Source Acknowledgments

ArchiveTune is made possible by the work of many open-source projects and communities:

- **Metrolist** by [Mostafa Alagamy](https://github.com/mostafaalagamy/Metrolist) for the base framework.
- **SimpMusic** by [maxrave-dev](https://github.com/maxrave-dev/SimpMusic) for the lyrics API provider.
- [BetterLyrics](https://better-lyrics.boidu.dev/) for word-by-word lyrics, unison and artwork provider support.
- [Material Color Utilities](https://github.com/material-foundation/material-color-utilities)
- [Read You](https://github.com/Ashinch/ReadYou) and [Seal](https://github.com/JunkFood02/Seal) for UI component inspiration.
- Translators, beta testers, contributors, and community members who continue to support the project.

---

## ⚖️ Legal Disclaimer

ArchiveTune is an independent third-party client.
- Not affiliated with Google LLC or YouTube.
- Does not bypass YouTube's technical protections.
- Users are encouraged to support artists by purchasing music via official channels.

## ⚖️ License, Copyright, and Trademark Notice

ArchiveTune is licensed under the **GNU General Public License v3.0 (GPLv3)**.

You may copy, modify, and redistribute the source code, including commercially, provided that you comply with the GPLv3. This includes preserving applicable copyright and license notices, clearly identifying modified versions, and providing the corresponding source code when required.

Copyright © Rukamori and the ArchiveTune contributors for their respective original contributions.

The **ArchiveTune™** name, logo, application icon, and official branding are not licensed under the GPLv3. Unofficial forks must not present themselves as official ArchiveTune releases or imply endorsement by the ArchiveTune maintainers.

See the [`LICENSE`](LICENSE) file for the complete GPLv3 terms.

---

<div align="center">
  <img src="https://raw.githubusercontent.com/rukamori/ArchiveTune/refs/heads/dev/fastlane/metadata/android/en-US/images/ArchiveTuneFull.png" alt="ArchiveTune Banner" style="width: 100%; max-width: 500px;">
  <p><b>If ArchiveTune elevated your music experience, please consider giving us a ⭐</b></p>
  <br />
  <img src="https://raw.githubusercontent.com/rukamori/ArchiveTune/refs/heads/dev/assets/badge_part.png" alt="ArchiveTune Banner" style="width: 180px">
</div>