Skip to content

mvxGREEN/Musix

Repository files navigation

Musix Round App Icon

Musix 🎵🎧

Build Status License: WTFPL Language: Kotlin Platform: Android

MusixPlayer is an offline audio player app built for Android using Kotlin.

It provides a simple, focused audio playback experience for audio files stored locally on your Android device.

📸 Screenshots

              

✨ Features

  • Offline Playback: Enjoy your entire local music library anywhere, anytime.
  • Broad Format Support: Plays all your favorite audio formats including MP3, AAC, WAV, FLAC, and M4A.
  • Modern Android Stack: 100% Kotlin codebase utilizing modern Android development practices.
  • Clean UI/UX: Designed to be intuitive, clean, and distraction-free for the best listening experience.

🛠️ Tech Stack

  • Language: Kotlin
  • Build System: Gradle (Kotlin DSL build.gradle.kts)
  • Platform: Android

⚡️ Quick Start App

  1. Download latest APK from Releases to an Android device.

  2. Open APK file to install.

  3. Done! Open Musix app to start listening offline.

💻 Build From Source Code

To build and run this project locally, you will need Android Studio installed on your machine.

Prerequisites

  • Android Studio (Latest stable version recommended)
  • Android SDK
  • JDK 17 (or compatible version used by the Gradle daemon)

Installation

  1. Clone the repository:

    git clone https://github.com/mvxGREEN/Musix.git
  2. Open the project:

    • Launch Android Studio.
    • Select Open and navigate to the cloned directory.
  3. Sync Gradle:

    • Wait for Android Studio to download the necessary dependencies and sync the project.
  4. Run the app:

    • Connect an Android device via USB (with USB Debugging enabled) or start an Android Emulator.
    • Click the Run button (green play icon) in the Android Studio toolbar.

🤝 Contributing

Contributions, issues, and feature requests are welcome! Feel free to check the issues page if you want to contribute.

📄 License

This project is released under the WTFPL (Do What The F*ck You Want To Public License).

            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
                    Version 2, December 2004

 Copyright (C) 2004 Sam Hocevar <sam@hocevar.net>

 Everyone is permitted to copy and distribute verbatim or modified
 copies of this license document, and changing it is allowed as long
 as the name is changed.

            DO WHAT THE FUCK YOU WANT TO PUBLIC LICENSE
   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION

  0. You just DO WHAT THE FUCK YOU WANT TO.

See the LICENSE file for more details.


Created by @mvxGREEN