OpenBBQ

中文说明 · Usage Guide

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 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

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
  • Custom translation prompts
  • 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.7.tar.gz (485.9 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.7-py3-none-any.whl (513.2 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: openbbq-0.0.7.tar.gz
  • Upload date:
  • Size: 485.9 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.7.tar.gz
Algorithm Hash digest
SHA256 0093149a74b8ee979adac6996727164202b24e4a48f19e4b1f8e40cf078534c8
MD5 0cbb975410c4ca23aa60d4260955d7fc
BLAKE2b-256 13ac95cee4b043e701af0131abfe92a2e67782843d97d2ad821d8e102da25d6a

See more details on using hashes here.

File details

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

File metadata

  • Download URL: openbbq-0.0.7-py3-none-any.whl
  • Upload date:
  • Size: 513.2 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.7-py3-none-any.whl
Algorithm Hash digest
SHA256 37c6782271acc73051879958a3344ec5d95d7366712b8ac705d02778cd5cfbbb
MD5 3e96cb59462669c5521e524df2e5c920
BLAKE2b-256 59ab7ab6496c0d489a65d36f361f33d699a22148f87cadc6fa5d7d41fdda27ec

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