Offline Playback and Downloads

BBPlayer’s offline playback feature lets you download audio tracks from Bilibili to your device for listening without an internet connection. This guide covers downloading, managing, and exporting your offline content.

​

How Downloads Work

BBPlayer uses the Orpheus audio engine to handle downloads:

• Concurrent downloads: Up to 3 tracks download simultaneously by default
• Queue management: Downloads are queued and processed in order
• State persistence: Download progress survives app restarts
• Smart caching: Covers are downloaded separately and cached locally

​

Downloading Single Tracks

​

Download States

Tracks can be in one of these download states:

• Queued: Waiting for an available download slot
• Downloading: Actively downloading with progress indicator
• Completed: Successfully downloaded and available offline (✓ icon)
• Failed: Download encountered an error (⚠ icon)

​

Batch Downloading

​

Download Entire Playlist

​

Download Selected Tracks

1. Long-press a track to enter selection mode
2. Tap additional tracks to select them
3. Tap the download icon in the top action bar
4. Confirm batch download

​

Managing Downloads

​

View Download Queue

​

Clear Download Queue

To remove all incomplete downloads:

1. Open the download manager
2. Tap 清空任务 (Clear All Tasks) in the header
3. Confirm to cancel all queued and failed downloads

​

Viewing Downloaded Content

​

Playing Downloaded Tracks

Downloaded tracks work exactly like streamed tracks:

• Tap any downloaded track to play it
• Create playlists containing downloaded tracks
• Downloaded tracks show a checkmark (✓) indicator
• Playback uses local files with no network required

​

Deleting Downloads

​

Delete Single Download

1. Navigate to the downloaded tracks page
2. Tap the menu (⋮) next to the track
3. Select 删除 (Delete)
4. Confirm deletion

This removes both the audio file and download record.

​

Batch Delete Downloads

​

Exporting Downloads (Android Only)

Export downloaded audio files to external storage:

What format are exported files?

Exported files maintain the same format as downloaded from Bilibili (typically M4A or MP3). Metadata including track title, artist name, and album artwork are embedded in the file tags.

​

Download Settings

​

Concurrent Download Limit

Adjust how many tracks download simultaneously:

1. Go to Settings → Downloads
2. Change 最大并发下载数 (Max Concurrent Downloads)
3. Options: 1-5 downloads at once

​

Storage Management

Check download storage usage:

1. Go to Settings → Storage
2. View 音频缓存 (Audio Cache) size
3. Tap to see breakdown by playlist or source

​

Offline Playback Behavior

When offline, BBPlayer:

• Plays downloaded tracks normally: Full playback with seek, repeat, shuffle
• Shows cached lyrics: Lyrics downloaded previously remain available
• Displays cover art: Album art is cached separately for offline display
• Skips unavailable tracks: Non-downloaded tracks in playlists are skipped automatically
• Disables streaming features: Comments, related videos, and online search are unavailable

​

Offline Priority Playback

When you play a playlist:

1. BBPlayer checks which tracks are downloaded
2. Downloaded tracks are prioritized in the queue
3. Unavailable tracks are added to the end or skipped based on settings

This ensures smooth playback without buffering interruptions.

Can I download while playing?

Yes! The download system runs in the background independently of playback. You can continue listening while downloads proceed in the queue.

​

Troubleshooting

Download stuck at 0%

Possible causes:

1. Poor network connection
2. Server temporarily unavailable
3. Track URL expired (common for Bilibili content)

Solutions:

1. Check your internet connection
2. Cancel and retry the download
3. Try downloading a different track to test
4. If Bilibili content, ensure you’re logged in with valid cookies
5. For expired URLs, refresh the playlist to get new playback URLs

Download failed immediately

Common reasons:

1. Track no longer available on Bilibili
2. Insufficient storage space
3. Network error during URL fetching

Solutions:

1. Check available storage in device settings
2. Verify the track is playable online first
3. Clear failed downloads and retry
4. Check app permissions for storage access

Downloaded tracks won't play offline

Checklist:

1. Verify track shows completed (✓) status
2. Check that download wasn’t interrupted
3. Re-download the track if file may be corrupted
4. Ensure app has storage read permissions
5. Check that the file wasn’t manually deleted from storage

Export fails on Android

Common issues:

1. Insufficient storage in destination folder
2. Permission denied for selected directory
3. SD card write protection

Solutions:

1. Try exporting to internal storage first
2. Grant all file access permissions if requested
3. Select a different destination folder
4. Ensure SD card is mounted and writable

Can't delete downloads

If deletion fails:

1. Close and reopen the app
2. Check if the file is currently playing
3. Clear app cache in Android settings
4. As a last resort, reinstall the app (this will delete all downloads)

​

Best Practices

1. Download on Wi-Fi: Save mobile data by downloading only when connected to Wi-Fi
2. Manage storage proactively: Regularly review and delete downloads you no longer need
3. Download playlists for trips: Pre-download full playlists before traveling to areas with poor connectivity
4. Use selection mode: Batch operations are faster than one-by-one downloads
5. Export backups: Periodically export important downloads to external storage as backup
6. Monitor failed downloads: Check the download manager occasionally for failed tasks
7. Clear queue before bulk downloads: Remove failed tasks before starting large batch downloads to avoid clutter

​

Storage Considerations

• Average track size: 3-6 MB per track (varies by quality and duration)
• Cover art cache: ~100-200 KB per unique album cover
• Lyrics cache: Negligible (~1-5 KB per track)
• Recommended free space: Keep at least 500 MB free for smooth operation