Skip to content

A modern Android music streaming app with offline capabilities, built using cutting-edge Android technologies following Clean Architecture principles.

License

Notifications You must be signed in to change notification settings

MahabubKarim/MaxMediaPlayer

Repository files navigation

Max Media Player 🎵

Kotlin Version Android API License

A modern Android music streaming app with offline capabilities, built using cutting-edge Android technologies following Clean Architecture principles.

App Demo

Features ✨

  • 🎧 Audio Streaming from Jamendo API
  • 📥 Offline Caching with Room Database
  • 📑 Playlist Management (Create/Edit/Delete)
  • 🎮 Media Controls in Notification & Lock Screen
  • 🎨 Material 3 Dynamic Theming
  • 🔍 Search Functionality (Coming Soon)
  • 🔄 Background Audio Playback
  • ♻️ Network State Awareness (Coming Soon)

Tech Stack 🛠️

Core Components

Component Technology
UI Framework Jetpack Compose
Audio Engine Android Media3 (ExoPlayer)
Database Room + SQLite
DI Framework Hilt with KSP
Networking Retrofit 2 + OkHttp
Image Loading Coil
Navigation Compose Navigation

Architecture

com.mmk.maxmediaplayer/
├── data/ # Data layer (Repositories, DAOs)
├── domain/ # Business logic (Models, UseCases)
├── ui/ # UI (Composables, ViewModels)
├── di/ # Dependency Injection
└── service/ # Background services

Screenshots 📱

Player Light Playlist View Player Dark

Getting Started 🚀

Prerequisites

  • Android Studio Narwhal | 2025.1.1 Canary 8 or later
  • Android SDK 36
  • Jamendo API key (free tier available)

Installation

  1. Clone the repository:

    git clone https://github.com/MahabubKarim/MaxMediaPlayer.git
  2. Obtain a Jamendo API key from Jamendo Developer Portal

  3. Add your API key to local.properties: JAMENDO_API_KEY="your_api_key_here"

  4. Build and run the app!

  5. And Enjoy!

Made with ❤️ for music lovers

Give a ⭐ if you like this project!

About

A modern Android music streaming app with offline capabilities, built using cutting-edge Android technologies following Clean Architecture principles.

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages