OpenBBQ

中文说明 · Usage Guide

OpenBBQ is a command-line tool for agent-driven video translation and subtitle production.

OpenBBQ provides a default agent init/next/apply/finish facade so different agents can follow the same quality workflow from one prompt. Fine-grained download, ASR, segmentation, translation, review, export, and burn commands remain available for expert debugging and compatibility.

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 openbbq command and manage Python dependencies
  • ffmpeg, used for video download, audio/video merging, audio extraction, and video burning; subtitle burning also needs FFmpeg with libass support
  • 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 run openbbq models pull ...
  • A local desktop browser if the video platform requires login, human verification, or a browser challenge

Install

Agent Install

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

Recommended agent entry point:

openbbq --json agent init '<video-or-url>' --workspace workspaces/demo --to zh
openbbq --json agent next --workspace workspaces/demo

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

  • Demo video
  • Detailed documentation site
  • Windows and Linux support
  • More ASR backends
  • More video-platform authentication support
  • Agent-led discovery of videos worth translating
  • Reproducible target-language translation briefs
  • Visual translation review for manual translators
  • More subtitle editing and publishing workflows

License

Apache-2.0. See LICENSE.

Project links

Data verified by PyPI on
Data provided by the project maintainers, verified at the time the release was uploaded to PyPI.

Key dates

PyPI data
Data sourced directly from PyPI's database.
  • Released:
Newer release available (0.0.12)

1 maintainer

PyPI data
Data sourced directly from PyPI's database.
Avatar for acane0320 from gravatar.com acane0320

Credits

Author: ACAne0320

GitHub Statistics

Data verified by PyPI on 
The GitHub source repository was provided by the project maintainers and verified by PyPI at the time of upload. Stars, forks, and open issues/PRs are derived from that repository and have not been independently verified.

License expression

Apache-2.0
View SPDX License List

Requires

Python >=3.12

Provides Extra

review whispercpp

Classifiers

Report project as malware

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

openbbq-0.0.9.tar.gz (521.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

openbbq-0.0.9-py3-none-any.whl (548.9 kB view details)

Uploaded Python 3

File details

Details for the file openbbq-0.0.9.tar.gz.

File metadata

  • Download URL: openbbq-0.0.9.tar.gz
  • Upload date:
  • Size: 521.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","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

Hashes for openbbq-0.0.9.tar.gz
Algorithm Hash digest
SHA256 e4347998c5f3c1060736e0c0a3c36cdf0316daa19ff1be11801aa6499f68456e
MD5 f2bb2718dccbba3ed76bf706011158c2
BLAKE2b-256 001e4654e01c21d3e9dc2792970393c6b2b161d1c651b0529f501bdeebf921fb

See more details on using hashes here.

File details

Details for the file openbbq-0.0.9-py3-none-any.whl.

File metadata

  • Download URL: openbbq-0.0.9-py3-none-any.whl
  • Upload date:
  • Size: 548.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","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

Hashes for openbbq-0.0.9-py3-none-any.whl
Algorithm Hash digest
SHA256 3d8b8b11507b433432090d62eb28ff848a7b69a260bd2bb32d435d60db3d08f3
MD5 36a796f638b685545aaa59333eeceff1
BLAKE2b-256 5e3a69f28619d6e07ad3f8c81da0f8d493d7aafacca1ba473957b3b46b7bec68

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page