Skip to content

michei69/OpenTune

Β 
Β 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

OpenTune

OpenTune Banner

Advanced YouTube Music Client with Material Design 3 for Android

Latest Release License Android Stars Forks

EspaΓ±ol


Table of Contents


Overview

OpenTune is an open-source YouTube Music client specifically designed for Android devices. It delivers a superior user experience with a modern interface implementing Material Design 3, offering advanced functionalities to explore, play, and manage musical content without the limitations of the official application.

Key Benefits

  • Ad-free Experience: Enjoy uninterrupted music streaming
  • Enhanced Performance: Optimized for smooth playback and navigation
  • Privacy-focused: No data collection or tracking
  • Customizable Interface: Personalize your music experience
  • Offline Capabilities: Download and play music without internet connection

Note: OpenTune is an independent project and is not affiliated, sponsored, or endorsed by YouTube or Google.


Technology Stack

Frontend Backend Development Tools
Kotlin Python Android Studio
Jetpack Compose TensorFlow Gradle
Material Design 3 Git

Key Features

Core Functionality

Feature Description
🎡 Ad-free Playback Enjoy music without any advertising interruptions
πŸ”„ Background Playback Continue listening while using other applications
πŸ” Advanced Search Quickly find songs, videos, albums, and playlists
πŸ‘€ Account Integration Sign in to sync preferences and collections
πŸ“š Library Management Organize and fully manage your music collection
πŸ“± Offline Mode Download content for offline listening

Audio Enhancement

Feature Description
🎀 Synchronized Lyrics View perfectly synchronized song lyrics
⚑ Smart Silence Skip Automatically skip segments without audio
πŸ”Š Volume Normalization Balance sound levels between different tracks
πŸŽ›οΈ Tempo & Pitch Control Adjust playback speed and pitch to preferences

Personalization & Integration

Feature Description
🎨 Dynamic Theming Interface adapts to album artwork colors
🌐 Multi-language Support Available in numerous languages for global users
πŸš— Android Auto Compatible Integration with vehicle infotainment systems
🎯 Material Design 3 Design aligned with Google's latest design guidelines
πŸ–ΌοΈ Artwork Export Save high-resolution album images

Documentation

For detailed information about configuration, advanced features, and usage guides, consult our official documentation:

Documentation


Installation

System Requirements

Component Minimum Requirement
Operating System Android 6.0 (Marshmallow) or higher
Storage Space 10 MB available
Network Internet connection for streaming
RAM 2 GB recommended

Installation Methods

Option 1: GitHub Releases (Recommended)

  1. Navigate to the Releases section on GitHub
  2. Download the APK file from the latest stable version
  3. Enable "Install from unknown sources" in your device's security settings
  4. Open the downloaded APK file to complete installation

Option 2: Official Website

  1. Visit the official OpenTune website
  2. Select the download option for Android
  3. Follow the installation instructions provided

Option 3: F-Droid

F-Droid

Option 4: OpenApk

OpenApk

Security Notice: For security reasons, it is recommended to obtain the application exclusively through the official channels mentioned above. Avoid downloading APKs from unverified sources.


Building from Source

Prerequisites

Tool Recommended Version Purpose
Gradle 7.5 or higher Build automation
Kotlin 1.7 or higher Programming language
Android Studio 2022.1 or higher IDE and development environment
JDK 11 or higher Java runtime environment
Android SDK API level 33 (Android 13) Android development tools

Environment Setup

# Clone the repository
git clone https://github.com/michei69/OpenTune.git

# Navigate to project directory
cd OpenTune

# Update submodules (if any)
git submodule update --init --recursive

Build Methods

Android Studio Build

  1. Open Android Studio
  2. Select "Open an existing Android Studio project"
  3. Navigate and select the OpenTune directory
  4. Wait for project synchronization and indexing
  5. Select Build β†’ Build Bundle(s) / APK(s) β†’ Build APK(s)

Command Line Build

# Build production release
./gradlew assembleRelease

# Build debug version
./gradlew assembleDebug

# Full build with tests
./gradlew build

# Run unit tests
./gradlew test

# Clean build
./gradlew clean

Note: Compiled APK files will be located in the app/build/outputs/apk/ directory.


Contributing

Code of Conduct

All participants in this project must adhere to our code of conduct that promotes an inclusive, respectful, and constructive environment. Please review the complete Code of Conduct before contributing.

Translation

Help translate OpenTune into your language or improve existing translations:

POEditor

Community Channels

Telegram Chat Telegram Updates

Development Workflow

  1. Issue Review: Check open issues or create a new one describing the problem or feature
  2. Fork Repository: Create a personal fork of the repository
  3. Feature Branch: Create a branch for your feature (git checkout -b feature/new-feature)
  4. Implementation: Implement changes following project coding conventions
  5. Testing: Ensure code passes all tests (./gradlew test)
  6. Commit: Make commits with descriptive messages (git commit -m 'feat: add new feature')
  7. Push Changes: Upload changes to your fork (git push origin feature/new-feature)
  8. Pull Request: Open a PR detailing changes and referencing corresponding issue

Development Guidelines: Review our contribution guidelines for detailed information about development process, code standards, and workflow.


Support the Project

If you find value in OpenTune and want to contribute to its continued development, consider making a donation. Your financial support allows us to:

  • Implement new features and improvements
  • Fix bugs and optimize performance
  • Maintain project infrastructure
  • Dedicate more time to development and maintenance

GitHub Sponsors PayPal

Note: Donations are completely optional. OpenTune will always be free and open-source, regardless of financial support received.


Acknowledgments

Special thanks to the following contributors and supporters:

  • mostafaalagamy - MetroList implementation
  • Fabito02 - Unconditional support from the beginning
  • Community translators - Making OpenTune accessible worldwide
  • Beta testers - Helping improve stability and usability

License

Copyright Β© 2025 Arturo Cervantes

This program is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

GPL v3

Important: Any unauthorized commercial use of this software or its derivatives constitutes a violation of the license terms.


Β© 2023-2025 Open Source Projects

Developed with passion by Arturo Cervantes

Forked by mikey


GitHub Email

About

A Youtube Music client for Android, following Material Design 3

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Languages

  • Kotlin 90.2%
  • Java 9.8%