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.8

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.8
File	Size	Uploaded
bili_dl-0.1.8.tar.gz	37.2 kB	Jun 28, 2026	Details

Built distribution (wheel)

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

Total release size: 57.9 kB

Release files / bili_dl-0.1.8.tar.gz

Download URL	bili_dl-0.1.8.tar.gz
Size	37.2 kB
Tags	Source
SHA-256 checksum How to use checksums	`6a01b265da1cea03fdc57d0f942fba99e4fd8f15e4d5e92bdbd453a153ab03e6`
BLAKE2b-256 checksum How to use checksums	`d22c1b2ea2a70e6dab76e57d8a16e056da2d33bec591162b930e92ce2c3159fa`
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/2899b52a1c61dd80e1cd0681e4444ca7f22eb577

Workflow

Publishing configuration: github.com/Echoziness/bili-dl/blob/2899b52a1c61dd80e1cd0681e4444ca7f22eb577/.github/workflows/publish.yml
Publishing logs: github.com/Echoziness/bili-dl/actions/runs/28314070362/attempts/1

Artifact

Subject: bili_dl-0.1.8.tar.gz
SHA-256 checksum: 6a01b265da1cea03fdc57d0f942fba99e4fd8f15e4d5e92bdbd453a153ab03e6 Verifying attestations

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

Download URL	bili_dl-0.1.8-py3-none-any.whl
Size	20.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`37df9710b4c5f58f3a10c031964083393a50cb79190ae1098843e0b6f8016090`
BLAKE2b-256 checksum How to use checksums	`aa11e26db9059610024b08c600bd2caca6ce65f0f605d66ff4ecdd547431d889`
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/2899b52a1c61dd80e1cd0681e4444ca7f22eb577

Workflow

Publishing configuration: github.com/Echoziness/bili-dl/blob/2899b52a1c61dd80e1cd0681e4444ca7f22eb577/.github/workflows/publish.yml
Publishing logs: github.com/Echoziness/bili-dl/actions/runs/28314070362/attempts/1

Artifact

Subject: bili_dl-0.1.8-py3-none-any.whl
SHA-256 checksum: 37df9710b4c5f58f3a10c031964083393a50cb79190ae1098843e0b6f8016090 Verifying attestations