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.10.tar.gz (526.8 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.10-py3-none-any.whl (554.8 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: openbbq-0.0.10.tar.gz
  • Upload date:
  • Size: 526.8 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.10.tar.gz
Algorithm Hash digest
SHA256 2e3a6af8d2f4e0689bdea1109b7f6da38a01c400d6a44dc034d0c2af2de8229f
MD5 558f8a3b97edfcf7f23a9b1cd7611443
BLAKE2b-256 235cefffa3190c39dba0516ffe04d08048c1954241f9280f1f43fcec4349958f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: openbbq-0.0.10-py3-none-any.whl
  • Upload date:
  • Size: 554.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.32 {"installer":{"name":"uv","version":"0.11.32","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.10-py3-none-any.whl
Algorithm Hash digest
SHA256 6673eea4eb2e5a2455e3114184cafd1ed911f3c7cf3ae99ac30e620479ae3868
MD5 e4e7fe64922574ff9cdc4912a26ce93b
BLAKE2b-256 ace0c1d6d318ebe2373d4529203ea7a67d5a466999ebdfec868bbc816c38d222

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