Skip to content

ndriqa/musicky

Repository files navigation

🎵 Musicky

Musicky is a minimalistic, privacy-respecting Android music player designed to bring beauty and smooth audio playback together. Built with Jetpack Compose, Media3, and love 💚.


✨ Features

  • 🎧 Play local audio files with clean UI
  • 📊 Live waveform visualizer that reacts to music
  • 🏷️ Auto-detects and displays metadata (title, artist, etc.)
  • 💾 Local caching with Room for fast loading
  • 🧠 User preferences stored with DataStore
  • 🔥 Firebase Analytics and Crashlytics integrated
  • 📦 No user accounts, no tracking — privacy first
  • 🔢 Sorting options: You can sort your songs more easily.
  • 🎧 ExoPlayer: Expect more reliable and flexible playback.

🛠️ Built With

  • Kotlin + Jetpack Compose
  • ExoPlayer
  • Room + DataStore
  • Firebase Analytics & Crashlytics
  • Modern Android Architecture (ViewModel, Clean layers, etc.)

🧪 Debug Builds

The repo is public for learning, contribution, and experimentation.
Please do not publish clones, or use the code commercially.


📜 License

Musicky is licensed under the Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0) license.

That means:

  • ✅ You can fork it, learn from it, contribute to it
  • ❌ You can’t use it commercially or publish clones

Full license: LICENSE

© 2025 Ndriçim Rrahmani (ndriqa.com)
Contact: ndricimrrahmani@gmail.com


🤝 Contributing

🔧 Setup

  1. Clone the repo
  2. In the app/ folder, rename the dummy Firebase config:
    • from app/google-services.json.dummy
    • to app/google-services.json

PRs

Pull requests are welcome — but first, please read the Contributing Guide.

👉 Got an idea or bug fix?

Open an issue first using the issue template.
Wait for approval before starting any major work.

This helps keep Musicky focused and aligned with its original vision.


📱 Screenshots

To be added soon!


🌐 About

Musicky is developed with ❤️ in Kosovo 🇽🇰 by Ndriçim Rrahmani a.k.a. ndriqa.