OpenBBQ
OpenBBQ is a command-line tool for agent-driven video translation and subtitle production.
OpenBBQ provides composable tools for video download, audio extraction, ASR transcription, segmentation, translation, review, subtitle export, and subtitle burning. It does not force one fixed pipeline. The goal is to let an agent choose the right workflow for each task.
Why OpenBBQ?
In Chinese fansub and creator communities, the process of translating and subtitling foreign-language videos is often called "barbecue". Raw untranslated material is "raw meat"; the translated, subtitled result is "cooked meat".
OpenBBQ is meant to be an open-source, open subtitle translation platform.
Requirements
- Python 3.12 or newer
- uv, used to install the
openbbqcommand and manage Python dependencies - ffmpeg, used for video download, audio/video merging, audio extraction, and video burning; subtitle burning also needs FFmpeg with
libasssupport - An ASR backend. OpenBBQ currently supports whisper.cpp through its Python binding
- An ASR model. Models are not downloaded with the package. After installation, run
openbbq models list, then explicitly runopenbbq models pull ... - A local desktop browser if the video platform requires login, human verification, or a browser challenge
For Agent
Read the [install guide](https://raw.githubusercontent.com/ACAne0320/OpenBBQ/main/docs/install-agent.md) and help me install [OpenBBQ](https://github.com/ACAne0320/OpenBBQ).
Manual Install
uv tool install 'openbbq[whispercpp]'
openbbq doctor
openbbq models list
openbbq models pull large-v3-turbo
openbbq doctor
Usage
For local files, YouTube login, ASS presets, outputs, and command details, see the Usage Guide.
For agent setup and the packaged OpenBBQ skill, see the Agent Install Guide and the OpenBBQ Skill.
Roadmap
- Windows and Linux support
- More ASR backends
- More video-platform authentication support
- Visual translation review for manual translators
- More subtitle editing and publishing workflows
License
Apache-2.0. See LICENSE.
1 maintainer
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
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file openbbq-0.0.3.tar.gz.
File metadata
- Download URL: openbbq-0.0.3.tar.gz
- Upload date:
- Size: 80.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
83d0692f895559e84998398fa80efdcf34d2a13bfe1f82bc077304243c5840bc
|
|
| MD5 |
f47c263b063c6c3a368127d33dc98889
|
|
| BLAKE2b-256 |
04aa76d360c593a3adeb5f787bffcbea710a160c411506cc0ee235be0adbad69
|
File details
Details for the file openbbq-0.0.3-py3-none-any.whl.
File metadata
- Download URL: openbbq-0.0.3-py3-none-any.whl
- Upload date:
- Size: 98.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.26 {"installer":{"name":"uv","version":"0.11.26","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
34694457dcd210792029694ae57733b6cb26fb2dd7886d84e44f987ee8dd6ae0
|
|
| MD5 |
eef200065d27b9c117dd8c3576d89a6c
|
|
| BLAKE2b-256 |
2d8a38d67feed2a828bf9a5b18265b6d0c0899ff14a9a6329fdebbcb43c577c1
|
