Skip to main content
BBPlayer offers powerful playlist management features that let you organize your Bilibili audio collection. This guide covers creating local playlists, importing external playlists, and managing playlist content.

​
Creating a New Playlist

1

Open the Playlist Menu

Navigate to the Library tab and tap the + icon in the playlist section header.
2

Select 'New Playlist'

From the menu, choose 新建播放列表 (New Playlist).
3

Enter Playlist Details

Fill in the playlist information:
  • Title (required): Give your playlist a memorable name
  • Description (optional): Add details about the playlist’s theme or purpose
  • Cover Image (optional): Tap the image icon to select a custom cover from your device
Custom cover images are stored locally in the app’s covers directory for quick access.
4

Create the Playlist

Tap 确定 (Confirm) to create your playlist. If you selected “redirect to new playlist,” you’ll be taken directly to the new playlist page.

​
Adding Tracks to Playlists

There are multiple ways to add tracks to your playlists:

​
From Track Menu

  1. Tap the three-dot menu (⋮) next to any track
  2. Select 添加到播放列表 (Add to Playlist)
  3. Choose one or more playlists from the list
  4. Tap confirm to add the track
Tracks are added to the end of local playlists using fractional indexing, which allows for efficient reordering without affecting other tracks.

​
Batch Adding Tracks

1

Enter Selection Mode

Long-press on any track in a playlist or library view to enter selection mode.
2

Select Multiple Tracks

Tap additional tracks to select them. Use the “Select All” or “Invert Selection” buttons in the top bar for bulk operations.
3

Add to Playlist

Tap the playlist icon in the action bar, then choose the destination playlist(s).

​
Reordering Playlist Tracks

Local playlists support drag-and-drop reordering:
  1. Open your local playlist
  2. Long-press and hold a track item
  3. Drag the track to your desired position
  4. Release to drop the track in the new position
The app uses fractional indexing to maintain sort order efficiently without renumbering all tracks.

​
Removing Tracks from Playlists

​
Remove Single Track

  1. Tap the menu (⋮) next to the track
  2. Select 从播放列表中移除 (Remove from Playlist)
  3. Confirm the removal

​
Remove Multiple Tracks

  1. Enter selection mode by long-pressing a track
  2. Select all tracks you want to remove
  3. Tap the remove icon in the top action bar
  4. Confirm batch removal
Removing a track from a playlist doesn’t delete the track from your library - it only removes the playlist association.

​
Importing External Playlists

BBPlayer can import playlists from external platforms:
1

Get Playlist Link

Copy the share link from a supported platform (Bilibili, Netease Music, QQ Music, etc.).
2

Import to BBPlayer

In the Library tab, tap + → 导入外部歌单 (Import External Playlist).
3

Paste the Link

Paste the playlist URL and tap confirm. BBPlayer will fetch the playlist metadata and tracks.
4

Sync Content

The playlist will be created with type bilibili, netease, qqmusic, etc., based on the source. Tracks are automatically synced and stored locally.
External playlists sync automatically but can be manually refreshed by pulling down on the playlist page.

​
Shared Playlists

BBPlayer supports collaborative playlist sharing through the BBPlayer backend:

​
Sharing a Playlist

  1. Open a local playlist
  2. Tap the share icon in the header
  3. Choose 创建共享链接 (Create Share Link)
  4. Set sharing permissions (view-only or collaborative)
  5. Share the generated link with others

​
Subscribing to Shared Playlists

  1. Receive a BBPlayer share link from another user
  2. In Library, tap + → 订阅共享歌单 (Subscribe to Shared Playlist)
  3. Paste the share link
  4. The playlist will appear in your library and sync automatically
Shared playlists use the shareId field to connect to the BBPlayer backend. Changes made by the playlist owner are synced to all subscribers. The lastShareSyncAt timestamp tracks the last sync time to efficiently fetch only new changes.

​
Managing Playlists

​
Edit Playlist Metadata

  1. Open the playlist
  2. Tap the edit icon (✏️) in the header
  3. Update title, description, or cover image
  4. Save changes

​
Delete a Playlist

  1. Long-press the playlist in the Library view
  2. Select 删除 (Delete)
  3. Confirm deletion
Deleting a playlist removes all track associations but doesn’t delete the tracks themselves from your library.

​
Search Within a Playlist

For playlists with many tracks:
  1. Open the playlist
  2. Tap the search icon (🔍)
  3. Enter track title or artist name
  4. Results are filtered in real-time
The search uses case-insensitive matching on track titles and artist names via SQL LIKE queries.

​
Playlist Types

BBPlayer uses different playlist types internally:
  • local: User-created playlists that you fully control
  • bilibili: Synced from Bilibili favorites or collections
  • netease: Imported from Netease Cloud Music
  • qqmusic: Imported from QQ Music
  • favorite: Special “Watch Later” list for Bilibili users
Only local playlists support reordering, manual track management, and sharing. External playlists are read-only and sync from their source platforms.

​
Best Practices

  1. Use descriptive names: Make playlist titles clear and searchable
  2. Add cover images: Visual covers make playlists easier to identify at a glance
  3. Regular syncing: For external playlists, pull to refresh occasionally to get the latest content
  4. Organize by mood or genre: Create themed playlists for different listening situations
  5. Leverage shared playlists: Collaborate with friends on music discovery

​
Troubleshooting

Check your network connection and ensure you’re logged in to Bilibili if importing Bilibili playlists. The app needs a valid cookie to access private playlists.
For local playlists, the sort order is descending by sortKey. If tracks appear incorrectly ordered, try removing and re-adding them, or manually drag them to the correct positions.
Playlist titles must be unique. If you see an error, a playlist with that name already exists. Try a different title or delete the existing playlist first.

Build docs developers (and LLMs) love

Get started for freeTalk to us