FLUTTER ECOSYSTEM

TheVolecitor/BeatBoss

使用 Flutter 构建的音乐播放器

BeatBoss 项目封面
Stars
148
Forks
7
最近推送(UTC)
2026年9月5日
项目状态
未归档
TheVolecitor GitHub avatar
GITHUB User

TheVolecitor ↗

语言DartC++CMakeSwiftHTMLCRubyKotlin

使用的依赖

依赖清单 41 项

所在榜单

原始 README

以下为英文项目原文快照,最新内容请访问 GitHub。

展开 / 收起项目 README

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.