Skip to content
 
 

Repository files navigation

Pixel Music 🎶 ko-fi

Pixel Music App Icon

The Ultimate Hybrid Local, Streaming, and Cloud Music Powerhouse for Android
An elegant, feature-rich audio experience built for audiophiles, cloud hoarders, and streaming enthusiasts alike.

Home Page Explore Page Full Player Full Player Alternate Theme Library Listening Analytics Song Cards & Sharing Streaming & Sources

Support PixelMusic on Ko-fi

Android 11+ Kotlin 100% GPL-3.0-or-later License Telegram Channel

Gratitude to the original open-source authors and contributors whose foundational work made this project possible.


📖 What is Pixel Music?

Pixel Music is a unified, privacy-first audio powerhouse for Android. It bridges your local offline library, streaming catalogs, and cloud sources under a single, gorgeous interface.

  • Local Library: Scan and play high-resolution files like FLAC, ALAC, WAV, APE, OPUS, OGG, and MP3.
  • YouTube Music Streaming: Browse and stream available online catalog content with seamless library synchronization for liked tracks, playlists, and artists.
  • Telegram Integration: Connect your Telegram account to stream audio directly from channels, chats, and saved messages.
  • Google Drive: Stream your personal cloud library directly from remote drives.
  • Deezer Artist Artwork: High-definition artist covers and backdrop artwork automatically cataloged.

The interface adapts dynamically to your album artwork colors using Material You, and is packed with advanced playback features, lyrics, and cross-device connectivity.


⚡ Feature Highlights

Feature Description
Premium Audio Engine Media3 ExoPlayer with FFmpeg decoding, 10-band hardware equalizer, bass boost, spatial virtualizer, and EBU R128 loudness normalization.
Hybrid Streaming YouTube Music, Telegram channels, Google Drive, and local files in one unified library.
Real-Time Synchronized Lyrics Synchronized LRC lyrics with manual millisecond offset tuning, offline caching, and live translation support.
Generative AI Playlists Feed custom mood/prompt descriptions to AI models (Gemini, DeepSeek, OpenAI) to generate intelligent queues.
Smart Mixes (Last.fm) Last.fm-powered discovery with 8 generation modes and automated retention pruning policies.
Dynamic Material You Adaptive HSL color extraction from album artwork for player sheets, sliders, and navigation surfaces.
Snapchat & Story Sharing Spotify-style shareable cards with glassmorphism, dynamic pastels, and Snapchat Creative Kit integration.
Connectivity & Ecosystem Android Auto, Chromecast, Wear OS companion app, and Quick Settings playback tiles.
Interactive Widgets Material 3 Glance home-screen widgets with playback controls and artwork displays.

🚀 Installation & Downloads

This repository contains official APK releases for sideloading.

Prerequisites

  • Android 11 (API 30) or higher
  • ~150 MB free storage

Steps

  1. Download the latest APK for your device architecture from the Releases page:
    • arm64-v8a — most modern phones (recommended)
    • armeabi-v7a — older 32-bit devices
    • x86_64 — emulators and Chromebooks / tablets
    • universal — compatible with all supported devices
  2. Open the downloaded APK file on your device and tap Install.
  3. If prompted, allow installation from your browser or file manager in Settings.

Tip: If you are unsure which APK to pick, choose arm64-v8a. It works on the vast majority of modern Android devices.


📋 Requirements & Permissions

  • Minimum OS: Android 11 (API 30)
  • Target OS: Android 15+ (API 37)
  • Permissions: Internet, Bluetooth, media storage read access, notifications, and foreground service (for background playback).

📚 Documentation & Project Links


⚖️ Disclaimer & Legal Notice

Pixel Music is an independent, third-party audio player and client. It is not associated with Google LLC, YouTube Music, Deezer, Telegram, Snapchat, Last.fm, ListenBrainz, or any of their parent companies.

  • No Media Hosting: This app does not host, upload, or store copyrighted music. It operates strictly as an interface to scan local device storage or stream media directly from public or user-authenticated APIs.
  • Fair Use & Client Interface: This software operates strictly as a local media player and client interface to user-accessible APIs and user storage. Users are responsible for ensuring compliance with applicable copyright laws and platform Terms of Service.

For complete terms, read DISCLAIMER.md.


📦 Upstream Source & GPLv3 Compliance

This repository contains the complete open-source source code and official APK releases of Pixel Music.

Pixel Music is derived from and built upon the open-source PixelPlayerOSS project (and the foundational PixelPlayer codebase). In accordance with the GNU General Public License v3.0 (GPL-3.0-or-later):

  • Upstream Open-Source Codebase: Complete upstream source code is available at https://github.com/PixelPlayerHQ/PixelPlayerOSS.
  • Source Code in this Repository: In accordance with GPLv3 Section 6(a), the full machine-readable Corresponding Source code for all Pixel Music builds and modifications is openly published directly in this repository.
  • Third-Party & Runtime Notices: Full attribution and component licenses (including FFmpeg, TagLib, and fonts) are documented in THIRD_PARTY_NOTICES.md.
  • Provenance & Lineage: Upstream history, base commits, and license references are documented in PROVENANCE.md.
  • Disclaimer & Non-Affiliation: Independent client disclaimers are documented in DISCLAIMER.md.

📄 License

Pixel Music is licensed under the GNU General Public License v3.0 (GPL-3.0-or-later).

Pixel Music
Copyright (C) 2026 Pixel Music Contributors

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.

You should have received a copy of the GNU General Public License
along with this program.  If not, see <https://www.gnu.org/licenses/>.

For the complete license terms and conditions, see LICENSE.


Support PixelMusic on Ko-fi

Telegram ChannelReleasesChangelogPrivacy PolicySecurity

About

Material 3 Expressive yt music and local music player for Android. Enjoy a beautiful, free Spotify and YT Premium alternative with local playback, high-res YouTube Music, and Telegram streaming. Loaded with synchronized LRC lyrics, custom 10-band EQ, gapless playback, Wear OS companion, AI playlist helpers.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages