Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/bbplayer-app/BBPlayer/llms.txt

Use this file to discover all available pages before exploring further.

​
Platform Support

BBPlayer previously had basic iOS adaptation, but development is currently focused on Android.
The iOS version is not actively maintained and may not compile successfully. We cannot guarantee iOS functionality at this time.
The development team’s focus remains on the Android platform, where BBPlayer provides the best experience.
BBPlayer supports modern Android devices running Android 6.0 (API 23) or higher.Recommended Architecture: arm64-v8a (covers most modern smartphones)Also Available:
  • armeabi-v7a (older devices)
  • x86/x86_64 (Android emulators)
For the best experience, use a device with at least 2GB of RAM.

​
Privacy & Data Collection

BBPlayer uses a lightweight anonymous data collection system to improve the app.Usage Data:
  • Feature usage frequency
  • Playback session duration
  • General app interaction patterns
Crash Reports:
  • Stack traces when the app crashes
  • Device and OS information for debugging
All data is completely anonymous and does not include:
  • Account credentials or cookies
  • Bilibili account information
  • Browsing or listening history details
  • Personal identification information
Learn more in the Privacy Policy.
Yes! You have full control over data collection.To disable all data collection:
  1. Open Settings (设置)
  2. Go to General (通用设置)
  3. Toggle off “Share Data (Crash Reports & Anonymous Stats)” (分享数据)
Disabling this setting will stop all analytics and crash reporting. The app will continue to work normally.
BBPlayer is fully open source! You can review all analytics and data collection code on GitHub:The codebase is transparent and available for audit.

​
Features & Functionality

BBPlayer is a local-first Bilibili audio player with comprehensive features:Core Playback:
  • Bilibili login via QR code or cookies
  • Access to favorites, subscriptions, and custom playlists
  • Import playlists from NetEase Cloud Music and QQ Music
  • Full-featured player with shuffle, repeat, queue, loudness normalization
  • Resume playback from where you left off
  • Danmaku (comments) display on the player screen
Lyrics System:
  • Support for SPL format with word-by-word progress, romaji, and translations
  • Auto-match lyrics from NetEase, QQ Music, and Kugou
  • Desktop lyrics (floating window)
  • Lyrics sharing cards
Download & Export:
  • Cache songs for offline playback
  • Export cached songs as .m4a files with cover art, metadata, and embedded lyrics
UI & Experience:
  • Light/dark mode with Material Design 3
  • Dynamic color theming (Monet)
  • Sleep timer
  • Playback statistics and rankings
BBPlayer supports importing playlists from NetEase Cloud Music and QQ Music.The app will automatically match songs to Bilibili videos and save them as local playlists.
This feature was introduced in version 2.3.0. Check out the Changelog for details.
SPL (Song Lyric) is a lyrics format specification developed by BBPlayer that supports:
  • Word-by-word progress: Karaoke-style synchronized lyrics
  • Romaji annotations: Pronunciation guides for Japanese songs
  • Translation display: Multiple language support
Learn more in the SPL Specification.
Yes! BBPlayer supports:
  • Caching songs for offline playback within the app
  • Exporting cached songs as .m4a files to your device storage
Exported files include:
  • Cover art
  • Metadata (title, artist, etc.)
  • Embedded lyrics
Make sure to download missing cover images if you previously cached songs. Go to Settings > General and tap “Download Missing Covers”.
Yes! Starting from version 2.3.0, BBPlayer displays Bilibili danmaku directly on the player screen.This brings the authentic Bilibili experience to your music listening sessions.

​
Technical Questions

BBPlayer is built with modern React Native technologies:Framework:
  • React Native with Expo
  • Expo Router for navigation
State & Data:
  • Zustand for state management
  • React Query for data fetching
  • Drizzle ORM for database
UI:
  • Material Design 3 (React Native Paper)
  • React Native Reanimated for animations
Audio:
  • @bbplayer/orpheus (custom player based on Media3)
View the full tech stack in the README.
Yes! BBPlayer is fully open source under the MIT License.GitHub Repository: bbplayer-app/bbplayer
Contributions are welcome! The project uses a monorepo structure with shared packages and libraries.
Use GitHub Issues to report bugs or request features:For privacy-related questions, email me@roitium.com.

​
Installation & Updates

Choose the APK based on your device architecture:
FileArchitectureDevice Type
bbplayer-vX.X.X-prod-arm64-v8a.apkarm64-v8aRecommended - Most modern Android phones
bbplayer-vX.X.X-prod-armeabi-v7a.apkarmeabi-v7aOlder devices (several years old) or budget phones
bbplayer-vX.X.X-prod-x86.apkx86Android emulators on PC
bbplayer-vX.X.X-prod-x86_64.apkx86_6464-bit Android emulators
If you’re unsure, download the arm64-v8a version - it works on the vast majority of modern smartphones.
  1. Download the latest APK from GitHub Releases
  2. Install the APK over your existing installation
  3. Your data and settings will be preserved
Check the Changelog for new features and fixes in each version.

​
Support & Community

If BBPlayer has been helpful to you, consider supporting the developer:
  • Star the project on GitHub
  • Contribute code, translations, or documentation
  • Donate to help the developer buy dinner or games (donation QR codes available in the app)
All donations help support continued development and maintenance of BBPlayer.
Follow the project development:

Build docs developers (and LLMs) love

Get started for freeTalk to us