Skip to content
Yet another danmaku and video file downloader of Bilibili.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Yet another automatic/semi-automatic/manual danmaku and video file downloader of Bilibili.

This grabber is integrated with most of the "black techs". Good to bypass some copyright and geolocation restrictions:

  • 7 independent ways to parse source(s)! Now with BilibiliPr and you-get! And fake IP!
  • Auto concatenates and converts to MP4 (or FLV, even nothing, if not possible) file(s) via direct integration with Mukioplayer-Py-Mac (the Flash danmaku playing solution) and ABPlayer-HTML5-Mac (the HTML5 playing solution, preferred).
  • Interactive and command line mode for different use-cases. And also silent mode.
  • Process single or multiple videos with ease. Now you can use Bilibili mylists.
  • Convert danmaku to ASS subtitles with ease using m13253's Danmaku2ass (GPLv2). Both py2 and master (py3) branches available for better danmaku handling.
  • Damaku-only exports
  • M3U exports -- play danmaku without waiting with players like MPlayer, MPC or VLC, etc.
  • Built-in multi-part download, useful to reduce slow overheads.


If you have a Bilibili account, setting the cookie with dantmnf/biliupload/ will help you to download some of the restricted videos. You can do this by hand too.

The file should look like:


Interactive mode (Note some functionalities are not available in this mode):

$ python2

Or command line mode:

$ python2 -h
python (-h) (-a) (-p) (-s) (-c) (-d) (-v) (-l) (-e) (-b) (-m) (-n) (-u) (-t) (-q) (-r) (-g)

-h: Default: None
    Print this usage file.
-a: Default: None
    The av number.
    If not set, Biligrab will use the fallback interactive mode.
    Support "~", "," and mix use.
        Input        Output
          1           [1]
         1,2         [1, 2]
         1~3        [1, 2, 3]
        1,2~3       [1, 2, 3]
-p: Default: 0
    The part number.
    Able to use the same syntax as "-a".
    If set to 0, Biligrab will download all the available parts in the video.
-s: Default: 0
Source to download.
0: The original API source, can be Letv backup,
   and can fail if the original video is not available(e.g., deleted)
1: The CDN API source, "oversea accelerate".
   Can be MINICDN backup in Mainland China or oversea.
   Good to bypass some bangumi's restrictions.
2: Force to use the original source.
   Use Flvcd to parse the video, but would fail if
   1) The original source DNE, e.g., some old videos
   2) The original source is Letvcloud itself.
   3) Other unknown reason(s) that stops Flvcd from parsing the video.
For any video that failed to parse, Biligrab will try to use Flvcd.
(Mainly for oversea users regarding to copyright-restricted bangumies.)
If the API is blocked, Biligrab would fake the UA.
3: (Not stable) Use the HTML5 API.
   This works for downloading some cached Letvcloud videos, but is slow, and would fail for no reason sometimes.
   Will retry if unavailable.
4: Use Flvcd.
   Good to fight with oversea and copyright restriction, but not working with iQiyi.
   May retrieve better quality video, especially for Youku.
5: Use BilibiliPr.
   Good to fight with some copyright restriction that BilibiliPr can fix.
   Not always working though.
6: Use You-get (
   You need a you-get callable directly like "you-get -u blahblah".
-c: Default: ./bilicookies
The path of cookies.
Use cookies to visit member-only videos.

-d: Default: None
Set the desired download software.
Biligrab supports aria2c(16 threads), axel(20 threads), wget and curl by far.
If not set, Biligrab will detect an available one;
If none of those is available, Biligrab will quit.
For more software support, please open an issue at

-v: Default:None
Set the desired concatenate software.
Biligrab supports ffmpeg by far.
If not set, Biligrab will detect an available one;
If none of those is available, Biligrab will quit.
For more software support, please open an issue at
Make sure you include a *working* command line example of this software!

-l: Default: INFO
Dump the log of the output for better debugging.
Can be set to debug.

-e: Default: 1
Export Danmaku to ASS file.
Fulfilled with danmaku2ass(,
Author: @m13253, GPLv3 License.
*For issue with this function, if you think the problem lies on the danmaku2ass side,
please open the issue at both projects.*
If set to 1 or 2, Biligrab will use Danmaku2ass's py2 branch.
If set to 3, Biligrab will use Danmaku2ass's master branch, which would require
a python3 callable via 'python3'.
If python3 not callable or danmaku2ass2/3 DNE, Biligrab will ask for action.

-b: Default: None
Set the probe software.
Biligrab supports Mediainfo and FFprobe.
If not set, Biligrab will detect an available one;
If none of those is available, Biligrab will quit.
For more software support, please open an issue at
Make sure you include a *working* command line example of this software!

-m: Default: 0
Only download the danmaku.

-n: Default: 0
Silent Mode.
Biligrab will not ask any question.

-u: Default: 0
Export video link to .m3u file, which can be used with MPlayer, mpc, VLC, etc.
Biligrab will export a m3u8 instead of downloading any video(s).
Can be broken with sources other than 0 or 1.

-t: Default: None
The number of Mylist.
Biligrab will process all the videos in this list.

-q: Default: 3
The thread number for downloading.
Good to fix overhead problem.

-r: Default: -1
Select video quality.
Only works with Source 0 or 1.
Range: 0~4, higher for better quality.

-g: Default: 6
Threads for downloading every part.
Works with aria2 and axel.

-i: Default: None
Fake IP address.


  • Python 2.7
  • curl + None/aria2c/wget/axel
  • ffmpeg
  • mediainfo/ffprobe (for danmaku2ass)
  • Python 3.x (for danmaku2ass's python3 mode, or you-get)
  • you-get (See for mode 6 info.)




MIT license.

The Danmaku2ass(master) and Danmaku2ass(py2) part belongs to @m13253, GPLv3 license. Used under the authorization of the original author.

This program is provided as is, with absolutely no warranty.


Any contribution are welcome.

For issues, it would be better to include the log output, which can be enabled by -l.


You can still send me the info privately via my email. PGP public key available at

Any donation is welcome as well. Please get in touch with me: cnbeining[at] .

Release History

0.98.95: Use the miniloader's key.

0.98.92: Again change API key set.

0.98.91: Change API key set.

0.98.86: Emergency update: Fake UA to download.

0.98.85: Rewrite url get function, also add IP faking.

0.98.81: Update as API domain update. Thanks for @m13253 's help.

0.98.8: Add download via you-get; Fix traceback printing.

0.98.72: Add thread control, as in #15 .

0.98.7: Add some quality selection.

0.98.6: Add BilibiliPr's API.

0.98.5: Add testing multi-part download, Change UA, Change error handling, Fix #13, #14.

0.98.4: Change UA, change to use best source, rewrite HTML5 API as in #11.

0.98.39: Change to download high quality Youku video, rewrite the error report and logging, retry if failed to fetch video, rewrite arguments.

0.98.3: Change default probe software to ffprobe; Fix error at resolution with danmaku export only; Better debugging output; Fix error with danmaku2ass(py2)'s float problem; Beautify code.

0.98.29: Add ver. number: Fix: do not fail to fake UA when use normal api #9, thanks to @arition 's help.

0.98.28: Fix typo; Fix error with CLI mode.

0.98.27: Update as #7.

0.98.26: Add more support of broken sources.

0.98.25: Add some support of M3U export of Sina source and source that was broken.

0.98.2: Add some support of M3U export of non-Sina source.

0.98.1: Add mylist download.

0.98: Fix error with special characters in filename; Add export to M3U file to use players like MPlayer, VLC, etc.; Rewrite video URL API logic; Fix error with Danmaku2ASS(main); Error handling with ffprobe

0.97.9: Rewrite URL retrieve logic; Divide URL retrieve to functions; Change to .format() style; Add HTML5 API; Directly use Flvcd; Beautify ERROR logging.

0.97.5: Add (auto) download all the pages; Auto PEP-8.

0.97: Silent mode; Multiple video mode; Functions beautify; More error handling.

0.96.2: Merge pull request #6, #7: Optimize Danmaku2ASS parameters and exception handling, thanks to @m13253's help; Fix error when cookie does not exist, thanks to @m13253's report.

0.96.1: Add exception handling regarding to Danmaku2ass2; Fix vid guessing.

0.96: Add danmaku2ass(py2) to handle ass convertion without Python 3; Add the danmaku2ass dependencies check mode for safety; Add "danmaku only" mode to depreciate BiligrabLite; Change the default live time to 8 sec as the update from upstream; Update the license info.

0.95: Add danmaku2ass, able to convert danmaku to ass file; Fix axel error.

0.94: Add faking UA to bypass blocking; Add auto-generate UA; Rewrite API logic.

0.93: Fix error when handling filenames containing /\&, thanks to @solimot 's report; Add log mode, which can be enabled by -l 1 ; Clean multiple headers; Rearrange global variables.

0.92: Fix wrongly exit when downloading multiple parts.

0.91: Add support to axel, wget, curl and easy way to add more support; Add easy way to add more concat support; Able to select desired software and auto detect; Change dependencies check; Code beauty.

0.90: Fix if cannot get download URL for some reason(geo location, or API server error), try to use Flvcd to download video.

0.89: Fix #4, force declare the variable, and set the path if not assigned.

0.88: Fix #3, 2 typos.

0.87: Able to edit cookie path. Fix cannot read cookie.

0.86: Add non-interact mode, change API domain, fix #2.

0.81: Fix Flvcd module; When failed to concat, try to concat to flv; If failed, leave the original file; Delete some lines to make it easier to intregrate; Fix domain name

0.8: Fix the most recent change with APIs, with player biliInterface-201407302359. Use own key instead of AcDown's.

For history before V0.74, visit , or check the code at .

You can’t perform that action at this time.