ArchiveTune - GitLite

KO | EN

gitlite — search

#bash #chatgpt #golang #agents #framework #api #go #gemini #android #ai

ArchiveTune

(★ 4,890)

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

파일 탐색기

ZIP 다운로드

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

# 설치 가이드

android

사전 준비물

Android SDK API 24+
JDK 17+

설치 및 실행 절차

./gradlew assembleDebug

Gradle을 사용하여 디버그 APK를 빌드합니다.

핵심 명령어

./gradlew assembleDebug

개발 및 테스트를 위한 디버그 APK를 빌드합니다.

./gradlew assembleRelease

배포를 위한 릴리스 APK를 빌드합니다.

유튜브 뮤직 지역 제한이 있는 경우 VPN 설정이 필요할 수 있습니다.

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

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