Skip to main content

​
Quick Start Guide

Get up and running with BBPlayer in just a few minutes. This guide will take you from installation to playing your first track.

​
What You’ll Need

Android Device

Android 6.0 (Marshmallow) or higher

Bilibili Account

Optional, but recommended for accessing your favorites and collections

​
Installation

1

Download BBPlayer

Visit the GitHub Releases page and download the latest APK file.
Download only from official sources. Avoid third-party app stores to ensure you get the authentic version.
2

Install the APK

  1. Open the downloaded APK file on your Android device
  2. If prompted, allow installation from unknown sources
  3. Follow the on-screen installation prompts
  4. Launch BBPlayer from your app drawer
First launch may take a few seconds as the app initializes the database and cache.
3

Grant Permissions

BBPlayer will request the following permissions:
  • Storage: To cache audio files for offline playback
  • Network: To stream audio and fetch metadata
  • Notifications (optional): For playback controls in notification shade
For the best experience, grant all permissions. You can always revoke them later in Android Settings.

​
First-Time Setup

Once installed, follow these steps to set up BBPlayer:
1

Login to Bilibili (Optional)

While you can use BBPlayer without logging in, signing in unlocks powerful features:
  • Access your Bilibili favorites and collections
  • Sync your “Watch Later” playlist
  • Subscribe to video series

​
Login Methods

2

Create Your First Playlist

BBPlayer supports two types of playlists:

​
Online Playlists (Synced from Bilibili)

If you logged in:
  1. Navigate to the Library tab
  2. Tap Favorites or Subscriptions
  3. Select any collection to view its contents
  4. Tap the Sync button to create a local copy
Synced playlists stay in sync with Bilibili. Tap the cloud icon (☁️) to update them.

​
Local Playlists

To create a completely local playlist:
  1. Go to Library → Playlists
  2. Tap the + button in the top-right corner
  3. Enter a name and description
  4. Start adding tracks from search or other playlists
3

Add Songs to Your Playlist

There are multiple ways to add songs:

​
Method 1: Search for Tracks

1. Tap the search icon in the top bar
2. Enter keywords, BV/AV number, or b23.tv short link
3. Tap any result to play immediately or long-press to add to playlist

​
Method 2: Import from Music Services

BBPlayer can import playlists from NetEase Cloud Music and QQ Music:
  1. Go to Library → Playlists
  2. Tap the Import button
  3. Choose NetEase or QQ Music
  4. Paste the playlist URL or ID
  5. BBPlayer will automatically match songs to Bilibili videos
The matching algorithm searches by song title and artist. Results are usually accurate, but you can manually adjust mismatched tracks.

​
Method 3: Add from Bilibili Directly

If you’re logged in, you can add tracks from your existing Bilibili collections:
  1. Browse your favorites or subscriptions
  2. Long-press any track
  3. Select Add to Playlist
4

Play Your First Song

  1. Open any playlist from the Library tab
  2. Tap any song to start playback
  3. The player interface will slide up from the bottom
BBPlayer automatically extracts audio from Bilibili videos. Multi-part videos (分P) will show all parts for selection.

​
Player Interface Overview

Once a song is playing, here’s what you can do:
  • Play/Pause: Tap the center button
  • Skip: Use the forward/backward buttons
  • Seek: Drag the progress bar
  • Shuffle: Tap the shuffle icon
  • Repeat: Tap the repeat icon (off → all → one)
Lyrics appear automatically below the album art:
  • Tap any lyric line to jump to that timestamp
  • Swipe down to view full lyrics
  • Long-press a line to share as a card
  • Tap the pencil icon to edit lyrics manually
BBPlayer auto-fetches lyrics from multiple sources and supports:
  • Word-by-word karaoke timing
  • Romanization for non-Latin scripts
  • Multi-language translations
Tap the queue icon in the bottom-right to:
  • View upcoming tracks
  • Reorder songs by dragging
  • Remove tracks from queue
  • Save the current queue as a playlist
Tap the three dots (⋮) in the top-right for:
  • Timer: Auto-pause after a set duration (perfect for bedtime)
  • Share Song: Generate a beautiful share card
  • Share Lyrics: Create a lyrics image
  • Search Lyrics: Manually search if auto-fetch fails
  • Download: Cache audio for offline playback

​
Download for Offline Playback

1

Download Individual Songs

  1. While playing a song, tap the three dots menu
  2. Select Cache Audio
  3. A checkmark (✓) will appear next to the song when download completes
2

Download Entire Playlists

  1. Open any playlist
  2. Tap the download icon (⬇) at the top of the playlist
  3. BBPlayer will queue all tracks for download
  4. Already downloaded songs are skipped automatically
3

Manage Downloads

  1. Go to Library → Tap the download icon in the top-right
  2. View all cached songs
  3. Delete individual tracks to free up space
  4. Export songs as .m4a files with embedded lyrics and metadata
File Format: Bilibili provides audio in M4S format. A typical song is 5-10MB.Storage Location: Downloads are stored in the app’s private directory. Use the Export feature to save files to public storage.

​
Essential Settings

Customize your experience in Settings:
  • Loudness Equalization: Normalize volume across tracks
  • Resume Playback: Auto-resume where you left off
  • Auto-play on Startup: Start playing when app opens
  • Enable Comments: Show Bilibili video comments in player
  • Desktop Lyrics: Floating lyrics overlay (requires overlay permission)

​
What’s Next?

Explore Features

Dive deep into advanced playback features

Lyrics Guide

Master the advanced lyrics system

Import Playlists

Learn how to import from other music services

Offline Playback

Optimize your offline listening experience

​
Need Help?

FAQ

Common questions and answers

Report Issues

Found a bug? Let us know

Build docs developers (and LLMs) love

Get started for freeTalk to us