yt-dlp plugin for converting Bilibili danmaku into ASS format
Project description
yt-dlp-danmaku
yt-dlp plugin for converting Bilibili danmaku into ASS format. Powered by biliass.
Installation and upgrading
Requires yt-dlp 2023.01.02 or above.
You can install or upgrade this package with pip:
pip install -U yt-dlp-danmaku
Usage
Download video along with the ASS subtitle
yt-dlp --write-subs --use-postprocessor danmaku https://www.bilibili.com/video/BV1Sm4y1N78J
Download video embedded with danmaku as a subtitle stream
Bilibili videos are originally mp4 format, but this format does not support ASS subtitle. Therefore, you need to use another format that supports it, such as mkv:
yt-dlp --embed-subs --use-postprocessor danmaku --remux-video mkv https://www.bilibili.com/video/BV1Sm4y1N78J
You can then try playing this video with players that support ASS subtitles, such as mpv and VLC.
Download video and "burn" the danmaku onto it
You need to run FFmpeg yourself to do this. Here is an example how you can do that:
yt-dlp --write-subs --use-postprocessor danmaku --output input https://www.bilibili.com/video/BV1Sm4y1N78J
ffmpeg -i input.mp4 -vf subtitles=input.danmaku.ass output.mp4
rm input.mp4 input.danmaku.ass
Get ASS subtitle without downloading the video
yt-dlp --write-subs --use-postprocessor danmaku:when=before_dl --skip-download https://www.bilibili.com/video/BV1Sm4y1N78J
Use with mpv
mpv --script-opts=ytdl_hook-ytdl_path=yt-dlp --ytdl-raw-options=use-postprocessor=danmaku:when=before_dl,write-subs=,no-simulate=,skip-download= https://www.bilibili.com/video/BV1Sm4y1N78J
You can turn on and off danmaku by using j (by default).
Add --sid=1
to turn on danmaku on start.
You can add these options to your mpv config file.
Notice: this will leave an ASS file in the current directory. Delete it afterwards if you do not want it.
Configuration
You can pass options to this plugin.
For example, to set the opacity of danmaku texts to 0.1 and reserve the bottom 150 pixels, use
--use-postprocessor danmaku:text_opacity=0.1;reserve_blank=150
.
All available options:
Option | Default | Meaning |
---|---|---|
lang |
danmaku | Language selector; you do not normally need to set this |
reserve_blank |
0 | |
font_face |
sans-serif | |
font_size |
25 | |
text_opacity |
0.8 | |
duration_marquee |
15 | |
duration_still |
10 | |
comment_filter |
||
is_reduce_comments |
false |
Run biliass -h
for more information about these options.
Development
See the Plugin Development section of the yt-dlp wiki.
License
MIT.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Hashes for yt_dlp_danmaku-0.1.0-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 7276afe324416b4f88ad4582ea55cc2be29408694ca2b175e89f8f162894db41 |
|
MD5 | eb234dd5624cbc0796bfa520c2e7f4c0 |
|
BLAKE2b-256 | b3fe88dabddca1a827e4cd6d948e0c6817264740700b73858b65f8384528748c |