bili-dl

Cross-platform Bilibili downloader — a thin, fast wrapper around yt-dlp + ffmpeg.

Download Bilibili videos and audio at the best available quality (up to 1080p for non-premium accounts). Cross-platform, zero runtime dependencies, foobar2000-friendly audio output.

Features

Cookie-safe — drop any .txt cookie export next to the tool, and only the Bilibili-domain entries are extracted. Other-site cookies are never parsed, stored, or sent anywhere.
Cookie-verified — probes Bilibili's nav API to confirm your session is actually logged in before downloading.
foobar2000-friendly audio — every produced M4A goes through a zero-loss ffmpeg -c copy remux (moov-first + ISOM container). No re-encode, no quality loss, instant playback in picky players.
Zero runtime deps — standard library only. If you have Python, pipx install bili-dl is all you need.

Install

bili-dl needs yt-dlp and ffmpeg on your PATH:

pip install -U yt-dlp       # or: winget / brew / pipx
# ffmpeg:
winget install ffmpeg        # Windows
brew install ffmpeg          # macOS
sudo apt install ffmpeg      # Debian/Ubuntu

Then:

pipx install bili-dl         # recommended
bili-dl -V                   # verify

Quick start

Cookies (one-time)

Bilibili requires a login cookie. Use any browser extension that exports cookies in Netscape format (Cookie-Editor, Get cookies.txt, etc.):

Export cookies — the file should look like:

# Netscape HTTP Cookie File
.bilibili.com	TRUE	/	FALSE	0	SESSDATA	<session>
.bilibili.com	TRUE	/	FALSE	0	bili_jct	<csrf>

Save the exported .txt file in the cookie directory (any filename works):

OS	Cookie directory
Windows	`%APPDATA%\bili-dl`
macOS	`~/Library/Application Support/bili-dl`
Linux	`~/.config/bili-dl`

Run bili-dl once — it auto-detects any .txt file containing Bilibili entries, extracts only those, and reuses them thereafter. Override with --cookie-dir.

Download

bili-dl                                       # interactive REPL
bili-dl https://www.bilibili.com/video/BV...   # one-shot (video + audio)
bili-dl -a https://www.bilibili.com/video/BV...  # audio only
bili-dl -v https://www.bilibili.com/video/BV...  # video only

OS	Videos	Audio
Windows	`~/Videos/bilibili_videos`	`~/Music/bilibili_audio`
macOS	`~/Movies/bilibili_videos`	`~/Music/bilibili_audio`
Linux	`~/Downloads/bilibili_videos`	`~/Downloads/bilibili_audio`

Override with --output-dir / --audio-dir.

CLI reference

Flag	Description
`--all`	video + audio, merged MP4 + extracted M4A (default)
`-v`, `--video`	video only (MP4)
`-a`, `--audio`	audio only (M4A, faststart ISOM)
`-k`, `--insecure`	skip TLS certificate verification
`--proxy URL`	proxy for yt-dlp
`-V`, `--version`	show version
`-h`, `--help`	show help

Privacy

Only Bilibili-domain cookie lines are kept; all others are discarded in memory — never written to disk or sent anywhere.
Network requests go only to api.bilibili.com (login probe) and the URLs you provide (via yt-dlp). No telemetry, no analytics.
cookies_bilibili.txt is created with a timestamped backup before any overwrite.

License

MIT. bili-dl is a wrapper; the actual downloading is done by yt-dlp (Unlicense) and ffmpeg (LGPL/GPL), which you must install separately.

Release files for bili-dl 0.1.7

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for bili-dl 0.1.7
File	Size	Uploaded
bili_dl-0.1.7.tar.gz	31.0 kB	Jun 28, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for bili-dl 0.1.7
File	Interpreter	ABI	Platform	Reset
bili_dl-0.1.7-py3-none-any.whl 19.9 kB Jun 28, 2026	Python 3	none	any	Details

Total release size: 50.9 kB

Release files / bili_dl-0.1.7.tar.gz

Download URL	bili_dl-0.1.7.tar.gz
Size	31.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`a0d64695c48be6479661667ac09090a1018a7a9bdbebf41759c44fded611c48a`
BLAKE2b-256 checksum How to use checksums	`3a081d935b9223528b3c959ec801453e8b97d7187a2587f7dc478c5580b076c2`
Upload date	Jun 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Echoziness/bili-dl
Publishing commit: github.com/Echoziness/bili-dl/tree/144bc54b32c1e4d787a747404748d62f93861556

Workflow

Publishing configuration: github.com/Echoziness/bili-dl/blob/144bc54b32c1e4d787a747404748d62f93861556/.github/workflows/publish.yml
Publishing logs: github.com/Echoziness/bili-dl/actions/runs/28313201461/attempts/1

Artifact

Subject: bili_dl-0.1.7.tar.gz
SHA-256 checksum: a0d64695c48be6479661667ac09090a1018a7a9bdbebf41759c44fded611c48a Verifying attestations

Release files / bili_dl-0.1.7-py3-none-any.whl

Download URL	bili_dl-0.1.7-py3-none-any.whl
Size	19.9 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`730e3113348884700039d9c789f2012309f15bf64597d0c934f17f023f7da5d8`
BLAKE2b-256 checksum How to use checksums	`ad7c10b98024208d9f9dc4bc440f395d3e29980084951586816c69812d0b97eb`
Upload date	Jun 28, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Echoziness/bili-dl
Publishing commit: github.com/Echoziness/bili-dl/tree/144bc54b32c1e4d787a747404748d62f93861556

Workflow

Publishing configuration: github.com/Echoziness/bili-dl/blob/144bc54b32c1e4d787a747404748d62f93861556/.github/workflows/publish.yml
Publishing logs: github.com/Echoziness/bili-dl/actions/runs/28313201461/attempts/1

Artifact

Subject: bili_dl-0.1.7-py3-none-any.whl
SHA-256 checksum: 730e3113348884700039d9c789f2012309f15bf64597d0c934f17f023f7da5d8 Verifying attestations