命令行

Downbit 应用本身也是一个命令：downbit。带参数时在终端中运行，不带参数时打开应用。它沿用应用的设置和登录状态，下载的内容也会显示在应用的资料库中。

downbit https://vimeo.com/76979871  # 下载，等同于 downbit getdownbit get -a <url>                # 仅音频downbit get -q 720 -o ~/Movies <url> <url>

安装

在应用中选择设置 → 命令行 → 安装 downbit 命令。下载页面上的安装脚本会自动完成这一步。

命令

命令	作用
`downbit get <url>…`	下载；downbit <url> 效果相同
`downbit info <url>`	标题、格式、播放列表条目
`downbit formats <url>`	链接提供的格式，用 -f 选择
`downbit list`	应用和命令行的下载
`downbit subs`	订阅：add、remove、check
`downbit settings`	查看或修改应用的设置
`downbit sites`	有专属提取器的网站
`downbit ffmpeg`	用于转换的 FFmpeg：install、remove
`downbit open [url…]`	把链接交给应用，在它的队列中下载
`downbit browse [url]`	在应用的浏览器中打开网页

下载

downbit get 使用应用的设置下载，参数只改变这一次下载。完整列表见 downbit get --help。

参数	作用
`-o, --output DIR`	保存到的文件夹
`-a, --audio`	仅保留音频（M4A）
`-q, --quality Q`	best、2160、1440、1080、720、480、360
`-f, --format IDS`	按 downbit formats 列出的 ID 选择格式，如 137+140
`--to FORMAT`	mkv、mov、webm、mp3、opus、flac 或 wav
`-i, --input FILE`	下载 FILE 中的链接，每行一个；- 表示从标准输入读取
`--items 1,3,5-7`	选择播放列表条目
`--section 1:00-2:30`	只下载这一段；1:00- 表示到结尾
`--subs, --sub-langs en,de`	下载字幕
`--sponsors-remove default`	剪掉 SponsorBlock 标记的片段；--sponsors-mark 则标记为章节
`--name TEMPLATE`	{title} {site} {author} {quality} {date} {id}
`--cookies FILE`	用 Netscape 格式的 Cookie 文件代替应用的登录状态；--no-cookies 不发送 Cookie
`--rate 2M`	限速
`--proxy URL`	如 socks5://127.0.0.1:1080

直播会持续录制，按 Ctrl-C 结束并保存文件；再按一次 Ctrl-C 则丢弃。

设置

命令行和应用共享设置。downbit settings 会列出每项设置及其作用；加上名称和值即可修改。

downbit settingsdownbit settings quality 1080

脚本与 AI 智能体

每个命令都支持 --json。downbit get --json 每行输出一个事件：start、info、progress、process、done，以及 error 或 stopped。

{"event":"start","url":"https://…"}{"event":"info","title":"…","site":"Vimeo","quality":"1080p","ext":"mp4","path":"/Users/…/Title.mp4"}{"event":"progress","fraction":0.42,"downloaded":44040192,"total":104857600,"speed":6291456,"eta":9}{"event":"process","stage":"Merging"}{"event":"done","path":"/Users/…/Title.mp4","size":104857600,"seconds":17.2}

--quiet 只输出文件路径，每行一个。

退出码

退出码	含义
`0`	完成
`1`	有下载失败
`2`	用法错误
`130`	被 Ctrl-C 停止：再次运行即可继续

命令行

安装

命令

下载

订阅

设置

脚本与 AI 智能体

退出码