Skip to main content

​
Installation

BBPlayer is currently available for Android devices. This guide will walk you through downloading, installing, and configuring BBPlayer on your device.

​
System Requirements

Android Requirements

  • OS Version: Android 6.0 (Marshmallow) or higher
  • Storage: At least 100MB free space (more recommended for offline music)
  • RAM: 2GB minimum (4GB recommended)
  • Internet: Required for streaming (optional for offline playback)
BBPlayer is optimized for modern Android devices. Older devices may experience performance issues, especially with the comments feature enabled.

​
Download BBPlayer

1

Visit GitHub Releases

BBPlayer releases are published on GitHub. Visit the official releases page:github.com/bbplayer-app/bbplayer/releases
Only download from official sources. Avoid third-party app stores or unofficial mirrors to ensure you’re getting the authentic, unmodified version.
2

Download the Latest APK

  1. On the releases page, find the latest release (at the top)
  2. Expand the Assets section
  3. Download the APK file (typically named bbplayer-v{version}.apk)
You can also download older versions if needed, but we always recommend using the latest release for bug fixes and new features.
3

Verify the Download (Optional but Recommended)

For security, you can verify the APK’s integrity:
  1. Download the .sha256 checksum file from the release
  2. Use a checksum tool to verify the APK matches the published hash
# On Linux/macOS
sha256sum bbplayer-v2.3.2.apk

# On Windows (PowerShell)
Get-FileHash bbplayer-v2.3.2.apk -Algorithm SHA256
Compare the output with the value in the .sha256 file.

​
Install on Android

1

Enable Unknown Sources

Before installing, you need to allow installation from unknown sources:
  1. Open Settings → Apps & notifications → Special app access
  2. Tap Install unknown apps
  3. Select your browser or file manager
  4. Toggle Allow from this source
For security, disable “Unknown sources” after installation is complete.
2

Install the APK

  1. Open your file manager or downloads folder
  2. Tap the downloaded BBPlayer APK
  3. Tap Install when prompted
  4. Wait for installation to complete
  5. Tap Open or find BBPlayer in your app drawer
Installation typically takes 10-30 seconds depending on your device.
3

Grant Required Permissions

On first launch, BBPlayer will request permissions:

​
Required Permissions

Why it’s needed: To cache audio files, store lyrics, and save downloaded content.When denied: You won’t be able to download songs for offline playback or export audio files.
Why it’s needed: To stream audio from Bilibili, fetch lyrics, and sync playlists.When denied: App will only work with previously downloaded content.
Why it’s needed: To show playback controls in the notification shade and on lock screen.When denied: You’ll need to open the app to control playback.
Why it’s needed: To display desktop lyrics (floating lyrics window).When denied: Desktop lyrics feature will not be available.Enable later in: Settings → Playback Settings → Desktop Lyrics
You can always manage permissions later in Android Settings → Apps → BBPlayer → Permissions.
4

Complete Initial Setup

When you first open BBPlayer:
  1. Welcome screen will briefly appear
  2. App initializes the local database
  3. You’ll land on the Home screen
  4. Optional: Log in to your Bilibili account (see Quick Start)

​
iOS Support

iOS support is experimental and not actively maintained.
While BBPlayer has basic iOS compatibility, the development focus is currently on Android. iOS builds may not compile successfully or may have missing features.

​
Why iOS is not prioritized:

  • Developer does not have access to macOS/iOS devices for testing
  • Apple’s strict app distribution policies make sideloading difficult
  • React Native’s iOS support requires Xcode and macOS for compilation

​
For iOS developers:

If you’d like to help bring BBPlayer to iOS:
  1. Fork the repository: github.com/bbplayer-app/bbplayer
  2. Follow the Development Setup Guide
  3. Build and test on iOS
  4. Submit a pull request with fixes

Contribute to iOS Support

Help make BBPlayer available on iOS

​
Updating BBPlayer

1

Check for Updates

BBPlayer does not have automatic updates. To check for new versions:
  1. Visit the GitHub Releases page
  2. Compare the latest version number with your installed version
  3. Check Settings → About to see your current version
2

Download the New Version

Follow the same download process as initial installation (see above).
3

Install Over Existing Version

  1. Tap the new APK file
  2. Android will detect an existing installation
  3. Tap Update or Install
  4. Your data, playlists, and settings will be preserved
Always back up your playlists before major updates. Export them to local storage as a precaution.
Watch the GitHub repository to get notified of new releases:github.com/bbplayer-app/bbplayer → Click Watch → Custom → Check Releases

​
Troubleshooting Installation

Possible causes:
  1. Insufficient storage: Free up space (Settings → Storage)
  2. Corrupted download: Re-download the APK
  3. Incompatible Android version: Ensure you’re on Android 6.0+
  4. Security software blocking: Temporarily disable antivirus apps
Solution:
# Check available storage
Settings → Storage → Check "Available space"

# Clear download cache
Settings → Apps → Downloads → Clear cache
Common causes:
  1. Outdated Android version: Update your OS if possible
  2. Conflicting apps: Try installing in safe mode
  3. Corrupted installation: Uninstall and reinstall
Steps to fix:
  1. Uninstall BBPlayer
  2. Reboot your device
  3. Re-download the APK
  4. Install again
If crashes persist, please report an issue with:
  • Your device model
  • Android version
  • App version
  • Crash logs (if available)
This usually means:
  1. Incomplete download: The APK file is corrupted
  2. Wrong architecture: APK doesn’t match your device’s CPU
Solution:
  • Delete the downloaded APK
  • Clear your browser cache
  • Download again from GitHub Releases
  • Ensure you’re downloading the correct file (not the source code ZIP)
If you denied permissions during installation:Re-enable permissions:
  1. Go to Settings → Apps → BBPlayer → Permissions
  2. Enable required permissions:
    • Storage
    • Network (usually auto-granted)
  3. Restart BBPlayer
For overlay permission (Desktop Lyrics):
  1. Open BBPlayer
  2. Go to Settings → Playback Settings → Desktop Lyrics
  3. Toggle the switch — you’ll be redirected to system settings
  4. Enable Display over other apps
Common locations:
  • /storage/emulated/0/Download/
  • Internal Storage → Download folder
  • Check your browser’s download history
Using a file manager:
  1. Open any file manager app
  2. Navigate to Downloads or Internal Storage/Download
  3. Look for bbplayer-v*.apk
Some browsers let you tap the download notification to open the file directly.

​
Post-Installation Steps

After successful installation:

Quick Start Guide

Follow our guide to set up BBPlayer in 5 minutes

Login to Bilibili

Connect your Bilibili account to access favorites

Create Playlists

Learn how to organize your music library

Enable Offline Mode

Download songs for offline listening

​
Security & Privacy

BBPlayer is open source and auditable. You can review the source code at any time:github.com/bbplayer-app/bbplayer

​
What BBPlayer Does NOT Do:

  • ❌ Does not collect your Bilibili credentials
  • ❌ Does not access your contacts or messages
  • ❌ Does not track your location
  • ❌ Does not contain ads or trackers
  • ❌ Does not share your data with third parties

​
What BBPlayer Collects (Optional):

  • ✅ Anonymous usage analytics (can be disabled)
  • ✅ Crash reports to fix bugs (can be disabled)
Disable data collection: Settings → General Settings → Share Data → Toggle OFF

​
Need Help?

If you encounter issues during installation:

FAQ

Check common questions and answers

Report a Bug

Open an issue on GitHub

Community Discussions

Ask the community for help

Development Guide

Build from source (advanced users)

Build docs developers (and LLMs) love

Get started for freeTalk to us