BiliExp：原作者：https://github.com/happy888888
请各位务必遵守 Github 服务条款。不要滥用 Actions 工作流。
Please be sure to abide by the Github terms of service. Don’t abuse the Actions workflow.
| ↳ Stargazers | ↳ Forkers |
|---|---|
本项目为bilibili(哔哩哔哩,以下简称B站)助手，涵盖了B站视频主站，直播，漫画等领域，提供B站自动化养号(服务器挂机,多账户)，视频音频漫画下载，视频专栏音乐投稿等工具集，方便大家更好地使用B站。如果您对本项目有新的建议，想在本项目上添加新的功能，欢迎贡献你的想法，帮助本项目更好地发展。
一、B站自动操作脚本BiliExp.py
- 每日获取经验(投币(支持自定义up主)、点赞、分享视频)
- 自动转发互动抽奖并评论点赞(官抽，非官抽支持指定关键字如"#互动抽奖#",支持跟踪转发模式)(Actions上默认1天执行1次，1次转发过去1天的动态，云函数上每次只转发过去10分钟的动态，建议修改为每10分钟执行1次)
- 获取主站@和私聊消息提醒(便于多账号抽奖时获取中奖信息)
- 参与官方转盘抽奖活动(目前没有自动搜集活动的功能,需要在配置文件config/activities.json里面手动指定活动列表)
- 每日直播签到
- 直播挂机(获取小心心,点亮粉丝牌，云函数默认关闭此功能，Actions上默认每次每个粉丝牌房间分别挂机45分钟)
- 直播自动送出快过期礼物(默认送出两天内过期的礼物)
- 直播天选时刻抽奖 (支持条件过滤，云函数默认搜索1次后立即退出，Actions上默认执行45分钟后退出，云函数上建议10分钟执行1次)
- 直播应援团每日签到
-
直播开启宝箱领取银瓜子(本活动已结束，不知道B站以后会不会再启动) - 每日兑换银瓜子为硬币
- 自动领取大会员每月权益(B币劵，优惠券)
- 自动花费大会员剩余B币劵(支持给自己充电、兑换成金瓜子或者兑换成漫读劵)
- 漫画APP每日签到
- 自动花费即将过期漫读劵(默认不开启)
- 自动积分兑换漫画福利券(需中午12点启动，默认不开启)
- 自动领取大会员漫画每月福利劵
-
自动参加每月"站友日"活动(本活动已结束，不知道B站以后会不会再启动) - 定时清理无效动态(转发的过期抽奖，失效动态，支持自定义关键字，非官方渠道抽奖无法判断是否过期，默认不开启本功能)
- 风纪委员投票(云函数默认没有案件立即退出，Actions默认45分钟内没有案件自动退出，云函数上建议每20分钟运行1次)
默认所有任务每天只执行1次，但建议云函数上风纪投票，抽奖转发，天选时刻等任务每天多次执行，Actions上风纪投票，天选时刻，直播挂机(领小心心)等任务可以设置更长的超时时间(默认45分钟后退出)。
使用这些功能可以参考一下部分功能推荐配置
二、脚本up主系列
- python实现B站专栏的编写，排版和发表
- python实现B站动态发布
- python实现B站视频稿件的上传和发布
- python实现B站音频(lrc歌词)稿件(单曲和合辑)的上传和发布
(例子和教程请参考专栏、动态、视频和音频的发表(面向开发者)
三、B站漫画下载mangaDownloader.py
- 支持使用账号密码登录下载已解锁部分
- 支持下载app端限时免费漫画(需登录)
- 支持合并为单个pdf文件
快速使用
四、B站视频下载videoDownloader.py
- 支持使用账号密码登录下载大会员视频
- 支持下载港澳台番剧(内置一个反向代理接口，接口源码见"player_proxy"文件夹，支持阿里/腾讯云函数部署此接口)
- 支持下载弹幕(转成ass字幕文件,需要用支持ass字幕的播放器打开,目前只支持滚动弹幕和顶部/底部弹幕,不支持高级弹幕)
快速使用
- 项目说明
- 目录
- 使用说明(仅自动操作脚本部分)
- 使用说明(下载器部分)
- 使用说明(视频投稿部分)
- 使用说明(专栏、动态、视频和音频的发表,面向开发者)
- 欢迎打赏
- 获得B站账户cookies方法
- 一些实用的B站PC浏览器辅助小脚本
详细配置文件在/config/config.json，云函数部署后在/src/config/config.json，Actions上应使用secrets定义所有配置而不能直接修改config.json！！！
- 1.准备
-
1.1 一个或多个B站账号，以及登录后获取的SESSDATA，bili_jct，DedeUserID (获取方式见下方示意图)
浏览器打开B站主页--》按F12打开开发者工具--》application--》cookies -
1.2 fork本项目 本步骤目的是将Actions Workflow文件(.github/workflows/run_BiliExp.yml)文件放到你自己的仓库，当然你也可以不fork直接新建一个仓库将***.github/workflows/run_BiliExp.yml***文件放进去(路径保持一致)，如果这样做请不要跳过步骤3
-
- 2.部署
- 2.1 在fork后的github仓库(或者你新建的存放run_BiliExp.yml的仓库)的 “Settings” --》“Secrets” 中添加"Secrets"，name(不用在意大小写)和value分别为：
- 2.1.1 name为"biliconfig" value为B站账号登录信息(可多个)，格式如下
例如下面这样(例子为两个账号)SESSDATA(账号1) bili_jct(账号1) uid(账号1) uid(账号2) bili_jct(账号2) SESSDATA(账号2) (多个账户继续加在后面，不用考虑每个账号三个参数的先后顺序)注：每行一个cookie项(SESSDATA bili_jct uid或者空行)，不规定顺序但必须一个账户三个参数填完才能开始填下一个账户的参数e1272654%vfdawi241825%2C8dc06*a1 0a9081cc53856314783d195f5ddbadf3 203953353 2035453 dfs425cc53856351d4d5195f5ddbakb2 e1412354%afdoii534825%2Cbbc06*a1
- 2.1.2 (可选)name为"push_message" value为推送SCKEY或email或telegramBot_token或SKEY用于消息推送，格式如下
注：每行一个推送参数(SCKEY email telegramBot_token SKEY或者空行)，可以同时提供多个或不提供SCKEY或email或telegramBot_token或SKEY，填写后会同时推送,SCU10xxxxxxxxxxxxxxxd547519b62d027xxxxxxxxx20f3578cbe6 example@qq.com 1443793198:AAEI9TGazdrj4Jh6X6B7CvuAKX4IivEb450,1459469720 efa28782a2b4a7b25daz12f7d595ae26
使用telegramBot的注意，除了填写token,还要填写chat_id,在同一行用逗号隔开,比如例子提供的意思是telegram token为1443793198:AAEI9TGazdrj4Jh6X6B7CvuAKX4IivEb450,chat_id为1459469720,
SCKEY来自server酱(微信推送，支持Turbo版)，email为你的邮箱，SKEY来自酷推(QQ推送)- 2.1.3 (可选)name为"advconfig" value为/config/config.json文件的所有内容(直接复制粘贴整个文件)
此项为详细配置文件，可配置所有细节参数，前两项secrets均会自动映射到本配置文件中
请注意不要直接修改/config/config.json文件而是使用本secrets(ADVCONFIG)
如果使用天选时刻，风纪委员投票和 直播心跳(获取小心心) 功能可参考 部分功能推荐配置 - 2.1.4 (可选)name为"delay" value为延迟时间
添加了本项后在启动前会延时一段时间启动任务，整数+单位(s,m,h),不带单位默认为s(秒)
- 2.2 添加完上面的"Secrets"后，进入"Actions" --》"run BiliExp"，点击右边的"Run workflow"即可第一次启动
- 2.2.1 首次fork可能要去actions(正上方的actions不是Settings里面的actions)里面同意使用actions条款，如果"Actions"里面没有"run BiliExp"，点一下右上角的"star"，"run BiliExp"就会出现在"Actions"里面(先按照主分支说明切换分支否则找不到对应的Actions)
- 2.2.2 第一次启动后，脚本会每天12:00自动执行，不需要再次手动执行(第一次手动执行这个步骤不能忽略)。
- 2.2.1 首次fork可能要去actions(正上方的actions不是Settings里面的actions)里面同意使用actions条款，如果"Actions"里面没有"run BiliExp"，点一下右上角的"star"，"run BiliExp"就会出现在"Actions"里面(先按照主分支说明切换分支否则找不到对应的Actions)
- 2.1 在fork后的github仓库(或者你新建的存放run_BiliExp.yml的仓库)的 “Settings” --》“Secrets” 中添加"Secrets"，name(不用在意大小写)和value分别为：
- 3.其他secrets
- 3.1 repository
(可选)仓库名称，指定Actions执行时从哪个仓库获取代码，此项不存在时默认为你自己的仓库(也就是fork后的仓库)，也可以填写我的仓库
happy888888/BiliExp - 3.2 ref
(可选)仓库分支名称或者sha，指定Actions执行时从仓库的哪个分支获取代码，此项不存在时默认为仓库默认分支的最新一次提交，也可以填写
master
这两个secrets是用来当Actions和代码不在同一个仓库里使用的 可以将 .github/workflows/run_BiliExp.yml 文件放到其他仓库里执行而不是fork本仓库 当然fork本身是携带代码的，不需要配置这两个secrets即可使用 - 3.1 repository
(可选)仓库名称，指定Actions执行时从哪个仓库获取代码，此项不存在时默认为你自己的仓库(也就是fork后的仓库)，也可以填写我的仓库
- 1.准备
- 1.1开通云函数 SCF 的腾讯云账号，在访问秘钥页面获取账号的 TENCENT_SECRET_ID，TENCENT_SECRET_KEY
注意！为了确保权限足够，获取这两个参数时不要使用子账户！此外，腾讯云账户需要实名认证。
- 1.2依次登录 SCF 云函数控制台 和 SLS 控制台 开通相关服务，确保您已开通服务并创建相应服务角色 SCF_QcsRole、SLS_QcsRole
- 1.3一个或多个B站账号，以及登录后获取的SESSDATA，bili_jct，DedeUserID (获得B站账户cookies方法)
- 1.4fork本项目
- 2.部署
- 2.1 在fork后的github仓库的 “Settings” --》“Secrets” 中添加"Secrets"，name和value分别为：
- 2.1.1 name为"TENCENT_SECRET_ID" value为腾讯云用户SecretID(需要主账户，子账户可能没权限)
- 2.1.2 name为"TENCENT_SECRET_KEY" value为腾讯云账户SecretKey
注意图片上的BILICONFIG仅供Actions使用，云函数仍需要部署后在云函数控制台中/config/config.json文件中手动填入账号cookie
- 2.2 添加完上面 2个"Secrets"后，进入"Actions"(上面那个不是Secrets下面那个) --》"deploy for serverless"，点击右边的"Run workflow"即可部署至腾讯云函数(如果出错请在红叉右边点击"deploy for serverless"查看部署任务的输出信息找出错误原因)
- 2.2.1 首次fork可能要去actions里面同意使用actions条款，如果"Actions"里面没有"deploy for serverless"，点一下右上角的"star"，"deploy for serverless"就会出现在"Actions"里面
- 2.2.2 部署完成后一定要去云函数控制台将账号cookie填写到/config/config.json文件中
目前有发现在Actions内无法ping通阿里云函数的域名，部署可能出现超时现象
-
1.准备
- 这里直接参考腾讯云函数部署步骤
-
2.部署
- 2.1在fork后的github仓库的 “Settings” --》“Secrets” 中添加"Secrets"，name和value分别为：
- 2.1.1 name为"ACCOUNT_ID" value为阿里云用户的账号ID
- 2.1.2 name为"ACCESS_KEY_ID" value为阿里云账户AccessKeyID(需要主账户，子账户可能没权限)
- 2.1.3 name为"ACCESS_KEY_SECRET" value为阿里云账户accessKeySecret
- 2.2这里直接参考腾讯云函数部署步骤中的2.2步骤
- 2.1在fork后的github仓库的 “Settings” --》“Secrets” 中添加"Secrets"，name和value分别为：
-
1.准备
- 1.1一个或多个B站账号，以及登录后获取的SESSDATA，bili_jct，DedeUserID (获得B站账户cookies方法)
- 1.2进入右边的release ,下载BiliExp-win32_64开头的压缩包
-
2.部署
- 2.1解压步骤1.2下载的压缩包，并放置到合适位置(比如E:\Program Files)
- 2.2进入解压后产生的config文件夹，配置config.json文件(包含功能的启用和账号cookie的配置)
- 2.3退出config文件夹返回上层，运行setup_for_windows.bat文件(需要管理员权限)，按照提示即可完成安装。脚本将会在每天12:00启动(依赖于计划任务)。
如果电脑上已经安装python3环境，比起使用release版本，更推荐直接下载代码到本地运行，因为release版本可能是老旧的版本
-
1.准备
- 1.1一个或多个B站账号，以及登录后获取的SESSDATA，bili_jct，DedeUserID (获得B站账户cookies方法)
-
2.部署
- 2.1执行如下命令，并按照提示安装
wget https://glare.now.sh/happy888888/BiliExp/BiliExp-Linux-64 && mv BiliExp-Linux-64* BiliExp.tar && tar xvf BiliExp.tar && cd BiliExp && sudo chmod 755 setup_for_linux.sh && sudo ./setup_for_linux.sh - 2.2安装成功后，可去/etc/BiliExp/config.json文件中进行详细配置，脚本将会在每天12:00启动(依赖于crontab)。
- 2.1执行如下命令，并按照提示安装
如果服务器上已经安装python3环境，比起使用release版本，更推荐直接clone代码到本地运行，因为release版本可能是老旧的版本
-
1.准备
- 1.1一个或多个B站账号，以及登录后获取的SESSDATA，bili_jct，DedeUserID (获取方式见最下方示意图),可选：SCKEY，email用于微信或邮箱的消息推送
- 1.2安装docker(以安装可忽略)
curl -fsSL https://get.docker.com | bash -s docker --mirror Aliyun
-
2.部署
-
2.1填写本项目下config/config.json文件，放到本地任意文件夹下(以路径 '/home/user/Biliexp' 为例)
-
2.2执行如下命令，运行BiliExp
docker run \ -v /home/user/Biliexp:/BiliExp \ happy888888/biliexp:runner-latest -
2.3其他参数
docker run \ -v /home/user/Biliexp:/BiliExp \ happy888888/biliexp:runner-latest \ -t <tag> \ -d \ -c <cron><tag>表示版本号,可以使用latest(不指定时默认,表示最新版),newest(表示拉取最新主分支代码执行),指定版本号例如1.1.0,当指定版本号时代码会缓存到挂载的路径(上面的例子是主机的/home/user/Biliexp/code-cache目录),不指定版本号为每次拉取github代码
-d指定本参数时容器不会退出，而是在每天中午12:00执行代码
<cron>表示cron表达式,指定后会按照指定表达式的时间执行，默认为0 12 * * *即每天中午12点执行,此项参数在不指定-d时无效例子,每天8点执行BiliExp 1.1.0版本
docker run -d -v /home/user/Biliexp:/BiliExp happy888888/biliexp:runner-latest -t 1.1.0 -d -c "0 8 * * *"
-
-
3.支持平台
平台 tag标签 windows/linux(x64) runner-latest linux(arm32) runner-arm-latest linux(arm64) runner-arm64-latest -
4.注意事项
- 4.1docker镜像中不包含本项目代码，docker启动时会自动下载
- 4.2下载代码的版本号由参数
-t指定，只有指定-t 版本号时才会缓存代码下次使用，-t latest和-t newest均为每次下载代码 - 4.3缓存代码后每次只会执行缓存的代码,要更新版本必须删除缓存才会重新下载新代码(指定了
-t latest(默认)和-t newest除外) - 4.4日志也存放在挂载目录中，且增量保存，可以定时清理
此方式难度较大，如果能用其他方式请尽量使用其他方式
-
1.准备
- 1.1一个或多个B站账号，以及登录后获取的SESSDATA，bili_jct，DedeUserID (获取方式见最下方示意图),可选：SCKEY，email用于微信或邮箱的消息推送
- 1.2使用xshell等工具,登录openwrt(padavan等)路由器，使用命令安装python3
opkg update opkg install python3-light - 1.3安装python
aiohttp库aiohttp库在openwrt(padavan)等路由器的opkg软件源上并没有直接的安装包，需要自己下载项目源码在openwrt平台上构建
如果你的路由器架构是mipsel，可以下载我编译好的依赖库(与本项目代码一起打包),BiliExp_with_aiohttp-mipsel.zip
-
2.部署
- 2.1下载本项目代码(步骤1.3压缩包包含代码),解压,填写config/config.json文件
- 2.2通过
xftp(WinScp)等软件把解压的文件夹上传到路由器内(比如路径为/root/BiliExp) - 2.3设置crontab使代码定时启动
使用xshell等工具,登录openwrt(padavan等)路由器，输入命令
也可以在路由器网页上寻找类似计划任务的功能,在默认添加一行
echo "0 12 * * * /usr/bin/python3 /root/BiliExp/BiliExp.py -c /root/BiliExp/config/config.json" >> "/etc/crontabs/root"0 12 * * * /usr/bin/python3 /root/BiliExp/BiliExp.py -c /root/BiliExp/config/config.json并保存
-
3.注意事项
- 3.1在步骤1.3中我提供的依赖库只有"mipse"架构的路由器能使用,其他架构的路由器只能自行编译"aiohttp"库并安装
- 3.2本项目依赖的库较大，不能外接U盘的路由器最好不要使用
- 3.3 x86架构的软路由最好直接使用docker
- 1.转至release ，下载BiliDownloader，解压。
- 2.将账户密码填入config文件夹中的user.json文件(linux可将文件放入/etc/BiliExp/user.json)
- 3.使用videoDownloader
命令行参数 videoDownloader -a -p <下载文件夹> -v <视频1> -e <分集数> -q <质量序号> -v <视频2> -e <分集数> -q <质量序号> ... -a --ass 下载视频时附带ass文件,配合支持ass字幕的播放器可以显示弹幕 -p --path 下载保存的路径，提供一个文件夹路径，没有会自动创建文件夹，默认为当前文件夹 -v --video 下载的视频地址，支持链接，av号(avxxxxx)，BV号(BVxxxxxx)，ep，ss -e --episode 分p数，只对多P视频和多集的番剧有效，不提供默认为1，多个用逗号分隔，连续用减号分隔 -e 2,3,5-7,10 表示2,3,5,6,7,10集 -q --quality 视频质量序号，0为能获取的最高质量(默认)，1为次高质量，数字越大质量越低 -x --proxy 是否使用接口代理(可下载仅港澳台)，0为不使用(默认)，1为使用代理 注意，一个 -v 参数对应一个 -e(-q, -x) 参数，如果出现两个 -v 参数但只有一个 -e(-q, -x) 参数则只应用于第一个，可以有多个 -v 参数以一次性下载多个视频 -V --version 显示版本信息 -h --help 显示帮助信息 使用例子 windows上(假如文件在D:\bilidownloader\videoDownloader.exe)，下载BV1qt411x7yQ的1,2,3,6集到D:\download目录 打开cmd执行如下命令 cd /d D:\bilidownloader videoDownloader -v BV1qt411x7yQ -e 1-3,6 -p D:\download linux上(提前将videoDownloader移动到/usr/local/bin)，下载BV1qt411x7yQ的1,2,3,6集到用户的download目录 shell中执行 videoDownloader -v BV1qt411x7yQ -e 1-3,6 -p ~/download - 4.使用mangaDownloader
命令行参数 mangaDownloader -p <下载文件夹> -m <漫画> -e <章节数> -f --width=<PDF每页宽度> --height=<PDF每页高度> --split -p --path 下载保存的路径，提供一个文件夹路径，没有会自动创建文件夹，不提供默认为当前文件夹 -m --manga 下载的漫画mc号，整数 -e --episode 章节数，不提供默认下载所有章节，多个用逗号分隔，连续用减号分隔 -e 2,3,5-7,10 表示2,3,5,6,7,10章节，注意番外也算一个章节 -f --pdf 下载后合并为一个pdf，如果未指定-m --manga参数，则直接合并-p --path指定的文件夹内的jpg图片 --width 合并为pdf时指定每页宽度(像素)，若未指定 --height 则会按漫画比例自适应高度，仅当使用-f --pdf参数后有效，否则忽略 --height 合并为pdf时指定每页高度(像素)，若未指定 --width 则会按漫画比例自适应宽度，仅当使用-f --pdf参数后有效，否则忽略 --split 合并为pdf时拆分每个章节为一个pdf，仅当使用-f --pdf参数后有效，否则忽略 -V --version 显示版本信息 -h --help 显示帮助信息 使用例子 windows上(假如文件在D:\bilidownloader\mangaDownloader.exe)，下载漫画mc28565的3,9,12,13,14章到D:\download目录 打开cmd执行如下命令 cd /d D:\bilidownloader mangaDownloader -m 28565 -e 3,9,12-14 -p D:\download linux上(提前将mangaDownloader移动到/usr/local/bin)，下载漫画mc28565的3,9,12,13,14章到用户的download目录 shell中执行 mangaDownloader -m 28565 -e 3,9,12-14 -p ~/download
- 1.转至release ，下载videoUploader，解压。
- 2.将账户密码填入config文件夹中的user.json文件(linux可将文件放入/etc/BiliExp/user.json)
- 3.使用videoUploader
命令行参数 VideoUploader -v <视频文件路径> -t <视频标题> -d <视频简介> -c <视频封面图片路径> -t <视频标签> -n -s <非原创时视频来源 网址> -v --videopath 视频文件路径 -t --title 视频标题，不指定默认为视频文件名 -d --desc 视频简介，不指定默认为空 -c --cover 视频封面图片路径，不提供默认用官方提供的第一张图片 -i --tid 分区id，默认为174，即生活,其他分区 -T --tags 视频标签，多个标签用半角逗号隔开，带空格必须打引号，不提供默认用官方推荐的前两个标签 -n --nonOriginal 勾选转载，不指定本项默认为原创 -s --source -n参数存在时指定转载源视频网址 -D --DelayTime 发布时间戳,10位整数,官方的延迟发布,时间戳距离现在必须大于4小时 -V --version 显示版本信息 -h --help 显示帮助信息 以上参数中只有-v --videopath为必选参数，其他均为可选参数 使用例子 windows上(假如程序在D:\VideoUploader\VideoUploader.exe,视频在D:\VideoUploader\测试视频.mp4) 打开cmd执行如下命令 cd /d D:\VideoUploader VideoUploader -v "D:\VideoUploader\测试视频.mp4" linux上(提前将VideoUploader移动到/usr/local/bin,视频文件在/root/upload/测试视频.mp4) shell中执行 VideoUploader -v "/root/upload/测试视频.mp4"
如果觉得本项目好用，对你有所帮助，欢迎打赏支持一下本项目发展！！！
B站操作需要的cookie数据可以按照以下方式获取 浏览器打开B站主页--》按F12打开开发者工具--》application--》cookies
