PackageTrack
Sign in Get early access

github.com/difyz9/ytb2bili

v0.4.1 #1056 most downloaded on Go modules difyz9/ytb2bili

What this package is like to depend on

Last release 2 months ago

21 Jun 2026

Release timing varies

gaps range from 8 days to 3 months

Rarely documented

notes for 8 of 34 stable releases

Nothing withdrawn

no release was ever pulled

9 months old

39 releases · first in 2025

39 releases in the last 12 months

see the full history below

Release timeline

39 releases · Nov 2025 to Jun 2026
2026
Release Pre-release

Releases

latest 39
  1. v0.4.2-0.20260621111716-17e23548791e 21 Jun 2026 pre-release

    Nothing published for this version

  2. v0.4.1 09 May 2026
    Release notes

    ytb2bili 使用说明

    通过 GitHub Releases 下载预构建安装包，无需本地编译即可运行。

    目录

    1. 前置依赖
    2. 下载安装包
    3. 创建配置文件
    4. 首次运行
    5. 配置说明
    6. 升级到新版本
    7. 常见问题

    1. 前置依赖

    工具 用途 是否必须
    yt-dlp YouTube 视频下载 ✅ 必须
    ffmpeg 音视频处理 ✅ 必须
    api2key.base_url 或服务端兜底 LLM Key AI 功能 可选

    安装 yt-dlp：

    # macOS
brew install yt-dlp

# Linux
pip install yt-dlp
# 或下载二进制：https://github.com/yt-dlp/yt-dlp/releases/latest

# Windows
winget install yt-dlp

    安装 ffmpeg：

    # macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
winget install ffmpeg

    2. 下载安装包

    前往 GitHub Releases 下载对应平台的二进制文件：

    平台 架构 文件名
    Linux x86_64 (AMD64) ytb2bili-linux-amd64
    Linux ARM64 (树莓派 / 服务器) ytb2bili-linux-arm64
    macOS Intel ytb2bili-darwin-amd64
    macOS Apple Silicon (M1/M2/M3) ytb2bili-darwin-arm64
    Windows x86_64 ytb2bili-windows-amd64.exe

    命令行下载示例（Linux / macOS）：

    # 以 Linux AMD64 为例，替换版本号和文件名
VERSION=v0.4.1
curl -L -o ytb2bili \
  "https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"

# 授予执行权限
chmod +x ytb2bili

    3. 创建配置文件

    程序启动时会从当前工作目录读取 config.toml。

    # 下载配置模板（用于参考）
curl -L -o config.toml \
  "https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"

    或手动创建 config.toml，以下是最小必要配置：

    # ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir  = "./downloads"
static_path = "/static"

# ── 数据库（SQLite，开箱即用）─────────────────────────
[database]
type         = "sqlite"
path         = "ytb2bili.db"
auto_migrate = true

# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path  = "/usr/local/bin/yt-dlp"   # 若不在 PATH 中，取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url   = "http://127.0.0.1:7890"   # 代理（可选）

# ── AI Agent（可选兜底，不影响 ytb2bili-api 网关模式）──────────────
[agent]
name = "ytb2bili_agent"

[agent.llm]
# api_key  = "sk-..."         # 可选：仅本地兜底时填写
model    = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"

# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled        = true
auto_update    = false
check_interval = 24

    说明：Web AI 助手默认走 ytb2bili-api /ai/v1 网关，agent.llm 只作为旧流程或离线环境的兜底配置。

    [agent.llm]
api_key  = "sk-..."
model    = "gpt-4o-mini"
base_url = "https://open.ytb2bili.com/ai/v1"

    4. 首次运行

    # 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili   config.toml

# Linux / macOS
./ytb2bili

# Windows
.\ytb2bili-windows-amd64.exe

    启动成功后，终端输出类似：

    🚀 YTB2BILI 启动中... 版本: v0.4.1, 构建时间: 2026-03-04T...
✅ 应用启动成功，按 Ctrl+C 停止...

    访问地址：

    入口 地址
    Web 界面 http://localhost:8096
    API 健康检查 http://localhost:8096/health
    API 文档（Swagger） http://localhost:8096/swagger/index.html

    5. 配置说明

    5.1 指定配置文件路径

    通过环境变量 CONFIG_FILE 指定任意路径的配置文件：

    CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili

    5.2 cookies 文件（下载受限视频）

    若需要下载需要登录的 YouTube 视频，在 config.toml 中配置：

    [workflow]
cookies_file = "/path/to/cookies.txt"

    可通过浏览器插件（如 Get cookies.txt）导出 YouTube cookies。

    5.3 开启 LLM 字幕翻译

    [workflow]
llm_translation_enabled    = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"

    5.4 静态文件目录

    downloads/ 目录将自动创建，用于存储下载的视频/字幕/缩略图。
    可通过 http://localhost:8096/static/<文件名> 直接访问。

    6. 升级到新版本

    方式一：手动替换二进制

    1. 从 Releases 页面 下载新版本
    2. 停止旧进程（Ctrl+C 或 kill）
    3. 替换可执行文件，重新启动

    方式二：API 检查并更新（experimental）

    启动后通过 API 检查更新：

    # 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check

# 查看当前版本
curl http://localhost:8096/api/v1/updater/version

    auto_update = true 时程序会在后台自动下载并重启（实验性功能，建议生产环境手动升级）。

    7. 常见问题

    Q: 启动报错 config.toml: no such file or directory
    A: 确保 config.toml 与可执行文件在同一目录，或通过 CONFIG_FILE 环境变量指定路径。

    Q: 下载视频失败，提示 yt-dlp not found
    A: 将 yt-dlp 安装后确保在 PATH 中，或在 config.toml 中填写绝对路径：

    [workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"

    Q: macOS 提示"无法验证开发者"
    A: 在终端执行以下命令移除隔离标记：

    xattr -d com.apple.quarantine ytb2bili-darwin-arm64

    Q: 端口 8096 被占用
    A: 修改 config.toml 中的 server.port 为其他端口。

    Q: AI 功能不可用
    A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。

    Open source →
  3. v0.4.0 09 May 2026
    Release notes

    ytb2bili 使用说明

    通过 GitHub Releases 下载预构建安装包，无需本地编译即可运行。

    目录

    1. 前置依赖
    2. 下载安装包
    3. 创建配置文件
    4. 首次运行
    5. 配置说明
    6. 升级到新版本
    7. 常见问题

    1. 前置依赖

    工具 用途 是否必须
    yt-dlp YouTube 视频下载 ✅ 必须
    ffmpeg 音视频处理 ✅ 必须
    api2key.base_url 或服务端兜底 LLM Key AI 功能 可选

    安装 yt-dlp：

    # macOS
brew install yt-dlp

# Linux
pip install yt-dlp
# 或下载二进制：https://github.com/yt-dlp/yt-dlp/releases/latest

# Windows
winget install yt-dlp

    安装 ffmpeg：

    # macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
winget install ffmpeg

    2. 下载安装包

    前往 GitHub Releases 下载对应平台的二进制文件：

    平台 架构 文件名
    Linux x86_64 (AMD64) ytb2bili-linux-amd64
    Linux ARM64 (树莓派 / 服务器) ytb2bili-linux-arm64
    macOS Intel ytb2bili-darwin-amd64
    macOS Apple Silicon (M1/M2/M3) ytb2bili-darwin-arm64
    Windows x86_64 ytb2bili-windows-amd64.exe

    命令行下载示例（Linux / macOS）：

    # 以 Linux AMD64 为例，替换版本号和文件名
VERSION=v0.4.0
curl -L -o ytb2bili \
  "https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"

# 授予执行权限
chmod +x ytb2bili

    3. 创建配置文件

    程序启动时会从当前工作目录读取 config.toml。

    # 下载配置模板（用于参考）
curl -L -o config.toml \
  "https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"

    或手动创建 config.toml，以下是最小必要配置：

    # ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir  = "./downloads"
static_path = "/static"

# ── 数据库（SQLite，开箱即用）─────────────────────────
[database]
type         = "sqlite"
path         = "ytb2bili.db"
auto_migrate = true

# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path  = "/usr/local/bin/yt-dlp"   # 若不在 PATH 中，取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url   = "http://127.0.0.1:7890"   # 代理（可选）

# ── AI Agent（可选兜底，不影响 ytb2bili-api 网关模式）──────────────
[agent]
name = "ytb2bili_agent"

[agent.llm]
# api_key  = "sk-..."         # 可选：仅本地兜底时填写
model    = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"

# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled        = true
auto_update    = false
check_interval = 24

    说明：Web AI 助手默认走 ytb2bili-api /ai/v1 网关，agent.llm 只作为旧流程或离线环境的兜底配置。

    [agent.llm]
api_key  = "sk-..."
model    = "gpt-4o-mini"
base_url = "https://open.ytb2bili.com/ai/v1"

    4. 首次运行

    # 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili   config.toml

# Linux / macOS
./ytb2bili

# Windows
.\ytb2bili-windows-amd64.exe

    启动成功后，终端输出类似：

    🚀 YTB2BILI 启动中... 版本: v0.4.0, 构建时间: 2026-03-04T...
✅ 应用启动成功，按 Ctrl+C 停止...

    访问地址：

    入口 地址
    Web 界面 http://localhost:8096
    API 健康检查 http://localhost:8096/health
    API 文档（Swagger） http://localhost:8096/swagger/index.html

    5. 配置说明

    5.1 指定配置文件路径

    通过环境变量 CONFIG_FILE 指定任意路径的配置文件：

    CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili

    5.2 cookies 文件（下载受限视频）

    若需要下载需要登录的 YouTube 视频，在 config.toml 中配置：

    [workflow]
cookies_file = "/path/to/cookies.txt"

    可通过浏览器插件（如 Get cookies.txt）导出 YouTube cookies。

    5.3 开启 LLM 字幕翻译

    [workflow]
llm_translation_enabled    = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"

    5.4 静态文件目录

    downloads/ 目录将自动创建，用于存储下载的视频/字幕/缩略图。
    可通过 http://localhost:8096/static/<文件名> 直接访问。

    6. 升级到新版本

    方式一：手动替换二进制

    1. 从 Releases 页面 下载新版本
    2. 停止旧进程（Ctrl+C 或 kill）
    3. 替换可执行文件，重新启动

    方式二：API 检查并更新（experimental）

    启动后通过 API 检查更新：

    # 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check

# 查看当前版本
curl http://localhost:8096/api/v1/updater/version

    auto_update = true 时程序会在后台自动下载并重启（实验性功能，建议生产环境手动升级）。

    7. 常见问题

    Q: 启动报错 config.toml: no such file or directory
    A: 确保 config.toml 与可执行文件在同一目录，或通过 CONFIG_FILE 环境变量指定路径。

    Q: 下载视频失败，提示 yt-dlp not found
    A: 将 yt-dlp 安装后确保在 PATH 中，或在 config.toml 中填写绝对路径：

    [workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"

    Q: macOS 提示"无法验证开发者"
    A: 在终端执行以下命令移除隔离标记：

    xattr -d com.apple.quarantine ytb2bili-darwin-arm64

    Q: 端口 8096 被占用
    A: 修改 config.toml 中的 server.port 为其他端口。

    Q: AI 功能不可用
    A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。

    Open source →
  4. v0.3.9 09 May 2026
    Release notes

    ytb2bili 使用说明

    通过 GitHub Releases 下载预构建安装包，无需本地编译即可运行。

    目录

    1. 前置依赖
    2. 下载安装包
    3. 创建配置文件
    4. 首次运行
    5. 配置说明
    6. 升级到新版本
    7. 常见问题

    1. 前置依赖

    工具 用途 是否必须
    yt-dlp YouTube 视频下载 ✅ 必须
    ffmpeg 音视频处理 ✅ 必须
    api2key.base_url 或服务端兜底 LLM Key AI 功能 可选

    安装 yt-dlp：

    # macOS
brew install yt-dlp

# Linux
pip install yt-dlp
# 或下载二进制：https://github.com/yt-dlp/yt-dlp/releases/latest

# Windows
winget install yt-dlp

    安装 ffmpeg：

    # macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
winget install ffmpeg

    2. 下载安装包

    前往 GitHub Releases 下载对应平台的二进制文件：

    平台 架构 文件名
    Linux x86_64 (AMD64) ytb2bili-linux-amd64
    Linux ARM64 (树莓派 / 服务器) ytb2bili-linux-arm64
    macOS Intel ytb2bili-darwin-amd64
    macOS Apple Silicon (M1/M2/M3) ytb2bili-darwin-arm64
    Windows x86_64 ytb2bili-windows-amd64.exe

    命令行下载示例（Linux / macOS）：

    # 以 Linux AMD64 为例，替换版本号和文件名
VERSION=v0.3.9
curl -L -o ytb2bili \
  "https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"

# 授予执行权限
chmod +x ytb2bili

    3. 创建配置文件

    程序启动时会从当前工作目录读取 config.toml。

    # 下载配置模板（用于参考）
curl -L -o config.toml \
  "https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"

    或手动创建 config.toml，以下是最小必要配置：

    # ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir  = "./downloads"
static_path = "/static"

# ── 数据库（SQLite，开箱即用）─────────────────────────
[database]
type         = "sqlite"
path         = "ytb2bili.db"
auto_migrate = true

# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path  = "/usr/local/bin/yt-dlp"   # 若不在 PATH 中，取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url   = "http://127.0.0.1:7890"   # 代理（可选）

# ── AI Agent（可选兜底，不影响 ytb2bili-api 网关模式）──────────────
[agent]
name = "ytb2bili_agent"

[agent.llm]
# api_key  = "sk-..."         # 可选：仅本地兜底时填写
model    = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"

# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled        = true
auto_update    = false
check_interval = 24

    说明：Web AI 助手默认走 ytb2bili-api /ai/v1 网关，agent.llm 只作为旧流程或离线环境的兜底配置。

    [agent.llm]
api_key  = "sk-..."
model    = "gpt-4o-mini"
base_url = "https://open.ytb2bili.com/ai/v1"

    4. 首次运行

    # 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili   config.toml

# Linux / macOS
./ytb2bili

# Windows
.\ytb2bili-windows-amd64.exe

    启动成功后，终端输出类似：

    🚀 YTB2BILI 启动中... 版本: v0.3.9, 构建时间: 2026-03-04T...
✅ 应用启动成功，按 Ctrl+C 停止...

    访问地址：

    入口 地址
    Web 界面 http://localhost:8096
    API 健康检查 http://localhost:8096/health
    API 文档（Swagger） http://localhost:8096/swagger/index.html

    5. 配置说明

    5.1 指定配置文件路径

    通过环境变量 CONFIG_FILE 指定任意路径的配置文件：

    CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili

    5.2 cookies 文件（下载受限视频）

    若需要下载需要登录的 YouTube 视频，在 config.toml 中配置：

    [workflow]
cookies_file = "/path/to/cookies.txt"

    可通过浏览器插件（如 Get cookies.txt）导出 YouTube cookies。

    5.3 开启 LLM 字幕翻译

    [workflow]
llm_translation_enabled    = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"

    5.4 静态文件目录

    downloads/ 目录将自动创建，用于存储下载的视频/字幕/缩略图。
    可通过 http://localhost:8096/static/<文件名> 直接访问。

    6. 升级到新版本

    方式一：手动替换二进制

    1. 从 Releases 页面 下载新版本
    2. 停止旧进程（Ctrl+C 或 kill）
    3. 替换可执行文件，重新启动

    方式二：API 检查并更新（experimental）

    启动后通过 API 检查更新：

    # 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check

# 查看当前版本
curl http://localhost:8096/api/v1/updater/version

    auto_update = true 时程序会在后台自动下载并重启（实验性功能，建议生产环境手动升级）。

    7. 常见问题

    Q: 启动报错 config.toml: no such file or directory
    A: 确保 config.toml 与可执行文件在同一目录，或通过 CONFIG_FILE 环境变量指定路径。

    Q: 下载视频失败，提示 yt-dlp not found
    A: 将 yt-dlp 安装后确保在 PATH 中，或在 config.toml 中填写绝对路径：

    [workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"

    Q: macOS 提示"无法验证开发者"
    A: 在终端执行以下命令移除隔离标记：

    xattr -d com.apple.quarantine ytb2bili-darwin-arm64

    Q: 端口 8096 被占用
    A: 修改 config.toml 中的 server.port 为其他端口。

    Q: AI 功能不可用
    A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。

    Open source →
  5. v0.3.8 02 May 2026
    Release notes

    ytb2bili 使用说明

    通过 GitHub Releases 下载预构建安装包，无需本地编译即可运行。

    目录

    1. 前置依赖
    2. 下载安装包
    3. 创建配置文件
    4. 首次运行
    5. 配置说明
    6. 升级到新版本
    7. 常见问题

    1. 前置依赖

    工具 用途 是否必须
    yt-dlp YouTube 视频下载 ✅ 必须
    ffmpeg 音视频处理 ✅ 必须
    api2key.base_url 或服务端兜底 LLM Key AI 功能 可选

    安装 yt-dlp：

    # macOS
brew install yt-dlp

# Linux
pip install yt-dlp
# 或下载二进制：https://github.com/yt-dlp/yt-dlp/releases/latest

# Windows
winget install yt-dlp

    安装 ffmpeg：

    # macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
winget install ffmpeg

    2. 下载安装包

    前往 GitHub Releases 下载对应平台的二进制文件：

    平台 架构 文件名
    Linux x86_64 (AMD64) ytb2bili-linux-amd64
    Linux ARM64 (树莓派 / 服务器) ytb2bili-linux-arm64
    macOS Intel ytb2bili-darwin-amd64
    macOS Apple Silicon (M1/M2/M3) ytb2bili-darwin-arm64
    Windows x86_64 ytb2bili-windows-amd64.exe

    命令行下载示例（Linux / macOS）：

    # 以 Linux AMD64 为例，替换版本号和文件名
VERSION=v0.3.8
curl -L -o ytb2bili \
  "https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"

# 授予执行权限
chmod +x ytb2bili

    3. 创建配置文件

    程序启动时会从当前工作目录读取 config.toml。

    # 下载配置模板（用于参考）
curl -L -o config.toml \
  "https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"

    或手动创建 config.toml，以下是最小必要配置：

    # ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir  = "./downloads"
static_path = "/static"

# ── 数据库（SQLite，开箱即用）─────────────────────────
[database]
type         = "sqlite"
path         = "ytb2bili.db"
auto_migrate = true

# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path  = "/usr/local/bin/yt-dlp"   # 若不在 PATH 中，取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url   = "http://127.0.0.1:7890"   # 代理（可选）

# ── AI Agent（可选兜底，不影响 ytb2bili-api 网关模式）──────────────
[agent]
name = "ytb2bili_agent"

[agent.llm]
# api_key  = "sk-..."         # 可选：仅本地兜底时填写
model    = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"

# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled        = true
auto_update    = false
check_interval = 24

    说明：Web AI 助手默认走 ytb2bili-api /ai/v1 网关，agent.llm 只作为旧流程或离线环境的兜底配置。

    [agent.llm]
api_key  = "sk-..."
model    = "gpt-4o-mini"
base_url = "https://open.ytb2bili.com/ai/v1"

    4. 首次运行

    # 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili   config.toml

# Linux / macOS
./ytb2bili

# Windows
.\ytb2bili-windows-amd64.exe

    启动成功后，终端输出类似：

    🚀 YTB2BILI 启动中... 版本: v0.3.8, 构建时间: 2026-03-04T...
✅ 应用启动成功，按 Ctrl+C 停止...

    访问地址：

    入口 地址
    Web 界面 http://localhost:8096
    API 健康检查 http://localhost:8096/health
    API 文档（Swagger） http://localhost:8096/swagger/index.html

    5. 配置说明

    5.1 指定配置文件路径

    通过环境变量 CONFIG_FILE 指定任意路径的配置文件：

    CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili

    5.2 cookies 文件（下载受限视频）

    若需要下载需要登录的 YouTube 视频，在 config.toml 中配置：

    [workflow]
cookies_file = "/path/to/cookies.txt"

    可通过浏览器插件（如 Get cookies.txt）导出 YouTube cookies。

    5.3 开启 LLM 字幕翻译

    [workflow]
llm_translation_enabled    = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"

    5.4 静态文件目录

    downloads/ 目录将自动创建，用于存储下载的视频/字幕/缩略图。
    可通过 http://localhost:8096/static/<文件名> 直接访问。

    6. 升级到新版本

    方式一：手动替换二进制

    1. 从 Releases 页面 下载新版本
    2. 停止旧进程（Ctrl+C 或 kill）
    3. 替换可执行文件，重新启动

    方式二：API 检查并更新（experimental）

    启动后通过 API 检查更新：

    # 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check

# 查看当前版本
curl http://localhost:8096/api/v1/updater/version

    auto_update = true 时程序会在后台自动下载并重启（实验性功能，建议生产环境手动升级）。

    7. 常见问题

    Q: 启动报错 config.toml: no such file or directory
    A: 确保 config.toml 与可执行文件在同一目录，或通过 CONFIG_FILE 环境变量指定路径。

    Q: 下载视频失败，提示 yt-dlp not found
    A: 将 yt-dlp 安装后确保在 PATH 中，或在 config.toml 中填写绝对路径：

    [workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"

    Q: macOS 提示"无法验证开发者"
    A: 在终端执行以下命令移除隔离标记：

    xattr -d com.apple.quarantine ytb2bili-darwin-arm64

    Q: 端口 8096 被占用
    A: 修改 config.toml 中的 server.port 为其他端口。

    Q: AI 功能不可用
    A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。

    Open source →
  6. v0.3.8-0.20260502020416-4a124a6d34ca 02 May 2026 pre-release

    Nothing published for this version

  7. v0.3.7 25 Apr 2026
    Release notes

    ytb2bili 使用说明

    通过 GitHub Releases 下载预构建安装包，无需本地编译即可运行。

    目录

    1. 前置依赖
    2. 下载安装包
    3. 创建配置文件
    4. 首次运行
    5. 配置说明
    6. 升级到新版本
    7. 常见问题

    1. 前置依赖

    工具 用途 是否必须
    yt-dlp YouTube 视频下载 ✅ 必须
    ffmpeg 音视频处理 ✅ 必须
    api2key.base_url 或服务端兜底 LLM Key AI 功能 可选

    安装 yt-dlp：

    # macOS
brew install yt-dlp

# Linux
pip install yt-dlp
# 或下载二进制：https://github.com/yt-dlp/yt-dlp/releases/latest

# Windows
winget install yt-dlp

    安装 ffmpeg：

    # macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
winget install ffmpeg

    2. 下载安装包

    前往 GitHub Releases 下载对应平台的二进制文件：

    平台 架构 文件名
    Linux x86_64 (AMD64) ytb2bili-linux-amd64
    Linux ARM64 (树莓派 / 服务器) ytb2bili-linux-arm64
    macOS Intel ytb2bili-darwin-amd64
    macOS Apple Silicon (M1/M2/M3) ytb2bili-darwin-arm64
    Windows x86_64 ytb2bili-windows-amd64.exe

    命令行下载示例（Linux / macOS）：

    # 以 Linux AMD64 为例，替换版本号和文件名
VERSION=v0.3.7
curl -L -o ytb2bili \
  "https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"

# 授予执行权限
chmod +x ytb2bili

    3. 创建配置文件

    程序启动时会从当前工作目录读取 config.toml。

    # 下载配置模板（用于参考）
curl -L -o config.toml \
  "https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"

    或手动创建 config.toml，以下是最小必要配置：

    # ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir  = "./downloads"
static_path = "/static"

# ── 数据库（SQLite，开箱即用）─────────────────────────
[database]
type         = "sqlite"
path         = "ytb2bili.db"
auto_migrate = true

# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path  = "/usr/local/bin/yt-dlp"   # 若不在 PATH 中，取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url   = "http://127.0.0.1:7890"   # 代理（可选）

# ── AI Agent（可选兜底，不影响 ytb2bili-api 网关模式）──────────────
[agent]
name = "ytb2bili_agent"

[agent.llm]
# api_key  = "sk-..."         # 可选：仅本地兜底时填写
model    = "gpt-4o-mini"
# base_url = "https://open.ytb2bili.com/ai/v1"

# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled        = true
auto_update    = false
check_interval = 24

    说明：Web AI 助手默认走 ytb2bili-api /ai/v1 网关，agent.llm 只作为旧流程或离线环境的兜底配置。

    [agent.llm]
api_key  = "sk-..."
model    = "gpt-4o-mini"
base_url = "https://open.ytb2bili.com/ai/v1"

    4. 首次运行

    # 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili   config.toml

# Linux / macOS
./ytb2bili

# Windows
.\ytb2bili-windows-amd64.exe

    启动成功后，终端输出类似：

    🚀 YTB2BILI 启动中... 版本: v0.3.7, 构建时间: 2026-03-04T...
✅ 应用启动成功，按 Ctrl+C 停止...

    访问地址：

    入口 地址
    Web 界面 http://localhost:8096
    API 健康检查 http://localhost:8096/health
    API 文档（Swagger） http://localhost:8096/swagger/index.html

    5. 配置说明

    5.1 指定配置文件路径

    通过环境变量 CONFIG_FILE 指定任意路径的配置文件：

    CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili

    5.2 cookies 文件（下载受限视频）

    若需要下载需要登录的 YouTube 视频，在 config.toml 中配置：

    [workflow]
cookies_file = "/path/to/cookies.txt"

    可通过浏览器插件（如 Get cookies.txt）导出 YouTube cookies。

    5.3 开启 LLM 字幕翻译

    [workflow]
llm_translation_enabled    = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"

    5.4 静态文件目录

    downloads/ 目录将自动创建，用于存储下载的视频/字幕/缩略图。
    可通过 http://localhost:8096/static/<文件名> 直接访问。

    6. 升级到新版本

    方式一：手动替换二进制

    1. 从 Releases 页面 下载新版本
    2. 停止旧进程（Ctrl+C 或 kill）
    3. 替换可执行文件，重新启动

    方式二：API 检查并更新（experimental）

    启动后通过 API 检查更新：

    # 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check

# 查看当前版本
curl http://localhost:8096/api/v1/updater/version

    auto_update = true 时程序会在后台自动下载并重启（实验性功能，建议生产环境手动升级）。

    7. 常见问题

    Q: 启动报错 config.toml: no such file or directory
    A: 确保 config.toml 与可执行文件在同一目录，或通过 CONFIG_FILE 环境变量指定路径。

    Q: 下载视频失败，提示 yt-dlp not found
    A: 将 yt-dlp 安装后确保在 PATH 中，或在 config.toml 中填写绝对路径：

    [workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"

    Q: macOS 提示"无法验证开发者"
    A: 在终端执行以下命令移除隔离标记：

    xattr -d com.apple.quarantine ytb2bili-darwin-arm64

    Q: 端口 8096 被占用
    A: 修改 config.toml 中的 server.port 为其他端口。

    Q: AI 功能不可用
    A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。

    Open source →
  8. v0.3.6 25 Apr 2026

    Nothing published for this version

  9. v0.3.5 25 Apr 2026
    Release notes

    ytb2bili 使用说明

    通过 GitHub Releases 下载预构建安装包，无需本地编译即可运行。

    目录

    1. 前置依赖
    2. 下载安装包
    3. 创建配置文件
    4. 首次运行
    5. 配置说明
    6. 升级到新版本
    7. 常见问题

    1. 前置依赖

    工具 用途 是否必须
    yt-dlp YouTube 视频下载 ✅ 必须
    ffmpeg 音视频处理 ✅ 必须
    api2key.base_url 或服务端兜底 LLM Key AI 功能 可选

    安装 yt-dlp：

    # macOS
brew install yt-dlp

# Linux
pip install yt-dlp
# 或下载二进制：https://github.com/yt-dlp/yt-dlp/releases/latest

# Windows
winget install yt-dlp

    安装 ffmpeg：

    # macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
winget install ffmpeg

    2. 下载安装包

    前往 GitHub Releases 下载对应平台的二进制文件：

    平台 架构 文件名
    Linux x86_64 (AMD64) ytb2bili-linux-amd64
    Linux ARM64 (树莓派 / 服务器) ytb2bili-linux-arm64
    macOS Intel ytb2bili-darwin-amd64
    macOS Apple Silicon (M1/M2/M3) ytb2bili-darwin-arm64
    Windows x86_64 ytb2bili-windows-amd64.exe

    命令行下载示例（Linux / macOS）：

    # 以 Linux AMD64 为例，替换版本号和文件名
VERSION=v0.3.5
curl -L -o ytb2bili \
  "https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"

# 授予执行权限
chmod +x ytb2bili

    3. 创建配置文件

    程序启动时会从当前工作目录读取 config.toml。

    # 下载配置模板（用于参考）
curl -L -o config.toml \
  "https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"

    或手动创建 config.toml，以下是最小必要配置：

    # ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir  = "./downloads"
static_path = "/static"

# ── 数据库（SQLite，开箱即用）─────────────────────────
[database]
type         = "sqlite"
path         = "ytb2bili.db"
auto_migrate = true

# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path  = "/usr/local/bin/yt-dlp"   # 若不在 PATH 中，取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url   = "http://127.0.0.1:7890"   # 代理（可选）

# ── AI Agent（可选兜底，不影响 ytb2bili-api 网关模式）──────────────
[agent]
name = "ytb2bili_agent"

[agent.llm]
# api_key  = "sk-..."         # 可选：仅本地兜底时填写
model    = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"

# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled        = true
auto_update    = false
check_interval = 24

    说明：Web AI 助手默认走 ytb2bili-api /ai/v1 网关，agent.llm 只作为旧流程或离线环境的兜底配置。

    [agent.llm]
api_key  = "sk-..."
model    = "gpt-4o-mini"
base_url = "https://open.api2key.com/ai/v1"

    4. 首次运行

    # 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili   config.toml

# Linux / macOS
./ytb2bili

# Windows
.\ytb2bili-windows-amd64.exe

    启动成功后，终端输出类似：

    🚀 YTB2BILI 启动中... 版本: v0.3.5, 构建时间: 2026-03-04T...
✅ 应用启动成功，按 Ctrl+C 停止...

    访问地址：

    入口 地址
    Web 界面 http://localhost:8096
    API 健康检查 http://localhost:8096/health
    API 文档（Swagger） http://localhost:8096/swagger/index.html

    5. 配置说明

    5.1 指定配置文件路径

    通过环境变量 CONFIG_FILE 指定任意路径的配置文件：

    CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili

    5.2 cookies 文件（下载受限视频）

    若需要下载需要登录的 YouTube 视频，在 config.toml 中配置：

    [workflow]
cookies_file = "/path/to/cookies.txt"

    可通过浏览器插件（如 Get cookies.txt）导出 YouTube cookies。

    5.3 开启 LLM 字幕翻译

    [workflow]
llm_translation_enabled    = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"

    5.4 静态文件目录

    downloads/ 目录将自动创建，用于存储下载的视频/字幕/缩略图。
    可通过 http://localhost:8096/static/<文件名> 直接访问。

    6. 升级到新版本

    方式一：手动替换二进制

    1. 从 Releases 页面 下载新版本
    2. 停止旧进程（Ctrl+C 或 kill）
    3. 替换可执行文件，重新启动

    方式二：API 检查并更新（experimental）

    启动后通过 API 检查更新：

    # 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check

# 查看当前版本
curl http://localhost:8096/api/v1/updater/version

    auto_update = true 时程序会在后台自动下载并重启（实验性功能，建议生产环境手动升级）。

    7. 常见问题

    Q: 启动报错 config.toml: no such file or directory
    A: 确保 config.toml 与可执行文件在同一目录，或通过 CONFIG_FILE 环境变量指定路径。

    Q: 下载视频失败，提示 yt-dlp not found
    A: 将 yt-dlp 安装后确保在 PATH 中，或在 config.toml 中填写绝对路径：

    [workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"

    Q: macOS 提示"无法验证开发者"
    A: 在终端执行以下命令移除隔离标记：

    xattr -d com.apple.quarantine ytb2bili-darwin-arm64

    Q: 端口 8096 被占用
    A: 修改 config.toml 中的 server.port 为其他端口。

    Q: AI 功能不可用
    A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。

    Open source →
  10. v0.3.4 25 Apr 2026
    Release notes

    ytb2bili 使用说明

    通过 GitHub Releases 下载预构建安装包，无需本地编译即可运行。

    目录

    1. 前置依赖
    2. 下载安装包
    3. 创建配置文件
    4. 首次运行
    5. 配置说明
    6. 升级到新版本
    7. 常见问题

    1. 前置依赖

    工具 用途 是否必须
    yt-dlp YouTube 视频下载 ✅ 必须
    ffmpeg 音视频处理 ✅ 必须
    api2key.base_url 或服务端兜底 LLM Key AI 功能 可选

    安装 yt-dlp：

    # macOS
brew install yt-dlp

# Linux
pip install yt-dlp
# 或下载二进制：https://github.com/yt-dlp/yt-dlp/releases/latest

# Windows
winget install yt-dlp

    安装 ffmpeg：

    # macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
winget install ffmpeg

    2. 下载安装包

    前往 GitHub Releases 下载对应平台的二进制文件：

    平台 架构 文件名
    Linux x86_64 (AMD64) ytb2bili-linux-amd64
    Linux ARM64 (树莓派 / 服务器) ytb2bili-linux-arm64
    macOS Intel ytb2bili-darwin-amd64
    macOS Apple Silicon (M1/M2/M3) ytb2bili-darwin-arm64
    Windows x86_64 ytb2bili-windows-amd64.exe

    命令行下载示例（Linux / macOS）：

    # 以 Linux AMD64 为例，替换版本号和文件名
VERSION=v0.3.4
curl -L -o ytb2bili \
  "https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"

# 授予执行权限
chmod +x ytb2bili

    3. 创建配置文件

    程序启动时会从当前工作目录读取 config.toml。

    # 下载配置模板（用于参考）
curl -L -o config.toml \
  "https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"

    或手动创建 config.toml，以下是最小必要配置：

    # ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir  = "./downloads"
static_path = "/static"

# ── 数据库（SQLite，开箱即用）─────────────────────────
[database]
type         = "sqlite"
path         = "ytb2bili.db"
auto_migrate = true

# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path  = "/usr/local/bin/yt-dlp"   # 若不在 PATH 中，取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url   = "http://127.0.0.1:7890"   # 代理（可选）

# ── AI Agent（可选兜底，不影响 ytb2bili-api 网关模式）──────────────
[agent]
name = "ytb2bili_agent"

[agent.llm]
# api_key  = "sk-..."         # 可选：仅本地兜底时填写
model    = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"

# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled        = true
auto_update    = false
check_interval = 24

    说明：Web AI 助手默认走 ytb2bili-api /ai/v1 网关，agent.llm 只作为旧流程或离线环境的兜底配置。

    [agent.llm]
api_key  = "sk-..."
model    = "gpt-4o-mini"
base_url = "https://open.api2key.com/ai/v1"

    4. 首次运行

    # 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili   config.toml

# Linux / macOS
./ytb2bili

# Windows
.\ytb2bili-windows-amd64.exe

    启动成功后，终端输出类似：

    🚀 YTB2BILI 启动中... 版本: v0.3.4, 构建时间: 2026-03-04T...
✅ 应用启动成功，按 Ctrl+C 停止...

    访问地址：

    入口 地址
    Web 界面 http://localhost:8096
    API 健康检查 http://localhost:8096/health
    API 文档（Swagger） http://localhost:8096/swagger/index.html

    5. 配置说明

    5.1 指定配置文件路径

    通过环境变量 CONFIG_FILE 指定任意路径的配置文件：

    CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili

    5.2 cookies 文件（下载受限视频）

    若需要下载需要登录的 YouTube 视频，在 config.toml 中配置：

    [workflow]
cookies_file = "/path/to/cookies.txt"

    可通过浏览器插件（如 Get cookies.txt）导出 YouTube cookies。

    5.3 开启 LLM 字幕翻译

    [workflow]
llm_translation_enabled    = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"

    5.4 静态文件目录

    downloads/ 目录将自动创建，用于存储下载的视频/字幕/缩略图。
    可通过 http://localhost:8096/static/<文件名> 直接访问。

    6. 升级到新版本

    方式一：手动替换二进制

    1. 从 Releases 页面 下载新版本
    2. 停止旧进程（Ctrl+C 或 kill）
    3. 替换可执行文件，重新启动

    方式二：API 检查并更新（experimental）

    启动后通过 API 检查更新：

    # 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check

# 查看当前版本
curl http://localhost:8096/api/v1/updater/version

    auto_update = true 时程序会在后台自动下载并重启（实验性功能，建议生产环境手动升级）。

    7. 常见问题

    Q: 启动报错 config.toml: no such file or directory
    A: 确保 config.toml 与可执行文件在同一目录，或通过 CONFIG_FILE 环境变量指定路径。

    Q: 下载视频失败，提示 yt-dlp not found
    A: 将 yt-dlp 安装后确保在 PATH 中，或在 config.toml 中填写绝对路径：

    [workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"

    Q: macOS 提示"无法验证开发者"
    A: 在终端执行以下命令移除隔离标记：

    xattr -d com.apple.quarantine ytb2bili-darwin-arm64

    Q: 端口 8096 被占用
    A: 修改 config.toml 中的 server.port 为其他端口。

    Q: AI 功能不可用
    A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。

    Open source →
  11. v0.3.3 25 Apr 2026
    Release notes

    ytb2bili 使用说明

    通过 GitHub Releases 下载预构建安装包，无需本地编译即可运行。

    目录

    1. 前置依赖
    2. 下载安装包
    3. 创建配置文件
    4. 首次运行
    5. 配置说明
    6. 升级到新版本
    7. 常见问题

    1. 前置依赖

    工具 用途 是否必须
    yt-dlp YouTube 视频下载 ✅ 必须
    ffmpeg 音视频处理 ✅ 必须
    api2key.base_url 或服务端兜底 LLM Key AI 功能 可选

    安装 yt-dlp：

    # macOS
brew install yt-dlp

# Linux
pip install yt-dlp
# 或下载二进制：https://github.com/yt-dlp/yt-dlp/releases/latest

# Windows
winget install yt-dlp

    安装 ffmpeg：

    # macOS
brew install ffmpeg

# Ubuntu / Debian
sudo apt install ffmpeg

# Windows
winget install ffmpeg

    2. 下载安装包

    前往 GitHub Releases 下载对应平台的二进制文件：

    平台 架构 文件名
    Linux x86_64 (AMD64) ytb2bili-linux-amd64
    Linux ARM64 (树莓派 / 服务器) ytb2bili-linux-arm64
    macOS Intel ytb2bili-darwin-amd64
    macOS Apple Silicon (M1/M2/M3) ytb2bili-darwin-arm64
    Windows x86_64 ytb2bili-windows-amd64.exe

    命令行下载示例（Linux / macOS）：

    # 以 Linux AMD64 为例，替换版本号和文件名
VERSION=v0.3.3
curl -L -o ytb2bili \
  "https://github.com/zolagz/ytb2bili/releases/download/${VERSION}/ytb2bili-linux-amd64"

# 授予执行权限
chmod +x ytb2bili

    3. 创建配置文件

    程序启动时会从当前工作目录读取 config.toml。

    # 下载配置模板（用于参考）
curl -L -o config.toml \
  "https://raw.githubusercontent.com/zolagz/ytb2bili/main/config.toml.example"

    或手动创建 config.toml，以下是最小必要配置：

    # ── 服务 ──────────────────────────────────────────────
[server]
host = "0.0.0.0"
port = 8096
static_dir  = "./downloads"
static_path = "/static"

# ── 数据库（SQLite，开箱即用）─────────────────────────
[database]
type         = "sqlite"
path         = "ytb2bili.db"
auto_migrate = true

# ── 视频处理工作流 ─────────────────────────────────────
[workflow]
download_dir = "./downloads"
# ytdlp_path  = "/usr/local/bin/yt-dlp"   # 若不在 PATH 中，取消注释并填写绝对路径
# ffmpeg_path = "/usr/local/bin/ffmpeg"
# proxy_url   = "http://127.0.0.1:7890"   # 代理（可选）

# ── AI Agent（可选兜底，不影响 ytb2bili-api 网关模式）──────────────
[agent]
name = "ytb2bili_agent"

[agent.llm]
# api_key  = "sk-..."         # 可选：仅本地兜底时填写
model    = "gpt-4o-mini"
# base_url = "https://open.api2key.com/ai/v1"

# ── 自动更新 ──────────────────────────────────────────
[updater]
enabled        = true
auto_update    = false
check_interval = 24

    说明：Web AI 助手默认走 ytb2bili-api /ai/v1 网关，agent.llm 只作为旧流程或离线环境的兜底配置。

    [agent.llm]
api_key  = "sk-..."
model    = "gpt-4o-mini"
base_url = "https://open.api2key.com/ai/v1"

    4. 首次运行

    # 确保 config.toml 与可执行文件在同一目录
ls
# ytb2bili   config.toml

# Linux / macOS
./ytb2bili

# Windows
.\ytb2bili-windows-amd64.exe

    启动成功后，终端输出类似：

    🚀 YTB2BILI 启动中... 版本: v0.3.3, 构建时间: 2026-03-04T...
✅ 应用启动成功，按 Ctrl+C 停止...

    访问地址：

    入口 地址
    Web 界面 http://localhost:8096
    API 健康检查 http://localhost:8096/health
    API 文档（Swagger） http://localhost:8096/swagger/index.html

    5. 配置说明

    5.1 指定配置文件路径

    通过环境变量 CONFIG_FILE 指定任意路径的配置文件：

    CONFIG_FILE=/etc/ytb2bili/config.toml ./ytb2bili

    5.2 cookies 文件（下载受限视频）

    若需要下载需要登录的 YouTube 视频，在 config.toml 中配置：

    [workflow]
cookies_file = "/path/to/cookies.txt"

    可通过浏览器插件（如 Get cookies.txt）导出 YouTube cookies。

    5.3 开启 LLM 字幕翻译

    [workflow]
llm_translation_enabled    = true
llm_translation_batch_size = 25
llm_translation_target_lang = "zh-Hans"

    5.4 静态文件目录

    downloads/ 目录将自动创建，用于存储下载的视频/字幕/缩略图。
    可通过 http://localhost:8096/static/<文件名> 直接访问。

    6. 升级到新版本

    方式一：手动替换二进制

    1. 从 Releases 页面 下载新版本
    2. 停止旧进程（Ctrl+C 或 kill）
    3. 替换可执行文件，重新启动

    方式二：API 检查并更新（experimental）

    启动后通过 API 检查更新：

    # 检查是否有新版本
curl -X POST http://localhost:8096/api/v1/updater/check

# 查看当前版本
curl http://localhost:8096/api/v1/updater/version

    auto_update = true 时程序会在后台自动下载并重启（实验性功能，建议生产环境手动升级）。

    7. 常见问题

    Q: 启动报错 config.toml: no such file or directory
    A: 确保 config.toml 与可执行文件在同一目录，或通过 CONFIG_FILE 环境变量指定路径。

    Q: 下载视频失败，提示 yt-dlp not found
    A: 将 yt-dlp 安装后确保在 PATH 中，或在 config.toml 中填写绝对路径：

    [workflow]
ytdlp_path = "/usr/local/bin/yt-dlp"

    Q: macOS 提示"无法验证开发者"
    A: 在终端执行以下命令移除隔离标记：

    xattr -d com.apple.quarantine ytb2bili-darwin-arm64

    Q: 端口 8096 被占用
    A: 修改 config.toml 中的 server.port 为其他端口。

    Q: AI 功能不可用
    A: 先检查是否已登录、api2key.base_url 是否指向可用的 api2key 网关、以及会员/积分状态是否正常。[agent.llm] 仅影响本地兜底模式。

    Open source →
  12. v0.3.1 24 Apr 2026

    Nothing published for this version

  13. v0.3.0 01 Apr 2026

    Nothing published for this version

  14. v0.2.7 01 Apr 2026

    Nothing published for this version

  15. v0.2.5 01 Apr 2026

    Nothing published for this version

  16. v0.2.4 01 Apr 2026

    Nothing published for this version

  17. v0.2.3 01 Apr 2026

    Nothing published for this version

  18. v0.2.1 01 Apr 2026

    Nothing published for this version

  19. v0.2.0 01 Apr 2026

    Nothing published for this version

  20. v0.1.9 19 Mar 2026

    Nothing published for this version

  21. v0.1.8 19 Mar 2026

    Nothing published for this version

  22. v0.1.6 19 Mar 2026

    Nothing published for this version

  23. v0.1.5 19 Mar 2026

    Nothing published for this version

  24. v0.1.4 06 Mar 2026

    Nothing published for this version

  25. v0.1.3 06 Mar 2026

    Nothing published for this version

  26. v0.1.2 06 Mar 2026

    Nothing published for this version

  27. v0.0.20 06 Mar 2026

    Nothing published for this version

  28. v0.0.19 27 Feb 2026

    Nothing published for this version

  29. v0.0.17 27 Feb 2026

    Nothing published for this version

  30. v0.0.14-0.20260227035852-68bb35d4dc0f 27 Feb 2026 pre-release

    Nothing published for this version

  31. v0.0.13 27 Feb 2026

    Nothing published for this version

  32. v0.0.9-0.20251123014546-b344c2093960 23 Nov 2025 pre-release

    Nothing published for this version

  33. v0.0.9-0.20251121203449-dfb7c3fed8d6 21 Nov 2025 pre-release

    Nothing published for this version

  34. v0.0.8 17 Nov 2025

    Nothing published for this version

  35. v0.0.7 14 Nov 2025

    Nothing published for this version

  36. v0.0.6 14 Nov 2025

    Nothing published for this version

  37. v0.0.5 14 Nov 2025

    Nothing published for this version

  38. v0.0.4 14 Nov 2025

    Nothing published for this version

  39. v0.0.3 22 Feb 2026

    Nothing published for this version

Every package, every release, already written down.

The archive is open and free. Watching your own project is what we are building next.

Browse the archive