Search packages, repositories and app categories

GitHub repositoryTheVolecitor/BeatBoss

BeatBoss

Music Player built with Flutter

BeatBoss project cover
Stars
148
Forks
7
Last push (UTC)
Sep 5, 2026
Project status
Active

Original README

English project snapshot. Visit GitHub for the latest content.

BeatBoss

BeatBoss is a high performance cross platform music player client designed for audiophiles. Built with Flutter, it delivers a native, responsive experience on both Windows and Android.

[!NOTE] Note: BeatBoss supports EclipseMusic addons too, or any addon based player that uses the standard manifest format like stremio. Do check out EclipseMusic, it is frequently updated, addons are cross compatible, the dev is talented guy @doctor98whoo and he has inspired me to keep working on the things I love to do.

Features

  • Cross Platform: Seamless experience on Windows, Linux and Android.
  • High Quality Playback: Support for various stream formats and high resolution audio.
  • Local Downloads: Download tracks for offline listening with high quality metadata.
  • Last.fm Integration: Full scrobbling support and secure API signing.
  • Modern UI: Dark and Light mode support with adaptive layouts.
  • Smart Queue: Drag and drop reordering and history tracking.
  • Addon System: Extensible architecture for search, lyrics, and cloud synchronization.

Getting Started

Prerequisites
  • Flutter SDK (Latest Stable)
  • Git
  • Windows: Visual Studio 2022 with C++ Desktop Development workload.
  • Android: Android Studio with SDK Command line Tools.
Installation
  1. Copy the repository:

    git clone https://github.com/TheVolecitor/BeatBoss.git
    cd BeatBoss
    
  2. Install dependencies:

    flutter pub get
    
  3. Run the application:

    Windows:

    flutter run -d windows
    

    Android:

    flutter run -d android
    

Building for Production

Windows (.exe)
flutter build windows

The output can be found in build/windows/runner/Release/.

Android (.apk)
flutter build apk --release

The output app-release.apk will be in build/app/outputs/flutter-apk/.

Addon Development

The application supports a flexible addon system for extending its functionality. You can develop your own addons to provide new search sources, lyrics providers, or custom library synchronization servers.

For detailed information on how to build and integrate your own addons, please refer to the Addon Development Guide.

Configuration

API Keys and Security

This project is open source and does not include private API keys.

  • Spotify and YouTube: Metadata is fetched via public web scraping. No API keys are required.
  • Last.fm: Requires a valid API Key and Shared Secret. These can be configured in the Settings UI.

License

MIT License. See LICENSE file for details.

Disclaimer

BeatBoss is solely a client side audio player that streams or locally plays audio from the user's own library. All rights belong to their respective owners.

TheVolecitor GitHub avatar
GitHub author

TheVolecitor ↗

LanguagesDartC++CMakeSwiftHTMLCRubyKotlin

Dependencies used

Dependency list 41 items

Rankings

How do I choose a repository?

Start with your use case, compare repository activity, and check the original project before adopting it.

  1. Search by repository name, owner or description, then narrow the results by topic.
  2. Compare stars, forks and recent pushes. Stars show community interest, not a guarantee of quality.
  3. Read the README, license and issues on GitHub before using a project.

Sources and maintenance

“A repository is the most basic element of GitHub.”

GitHub Docs — About repositories ↗