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.8.tar.gz (494.5 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.8-py3-none-any.whl (521.6 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: openbbq-0.0.8.tar.gz
  • Upload date:
  • Size: 494.5 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.8.tar.gz
Algorithm Hash digest
SHA256 f7318506de4e0ad8b35f542513222e1c952daeaf98f81677f4d346657c38474f
MD5 2629285341b5ba99c68c3b7b533b7950
BLAKE2b-256 fd054dd8fc9ba89211265eff990aa7133ff65d30aa040f53757477fed2250787

See more details on using hashes here.

File details

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

File metadata

  • Download URL: openbbq-0.0.8-py3-none-any.whl
  • Upload date:
  • Size: 521.6 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.8-py3-none-any.whl
Algorithm Hash digest
SHA256 6c6ec92acd8340add7c8303cbf2e9317cdae874707d11bad05c42a0e762a9ebd
MD5 77d2a68aff749347ed87caf046d00d03
BLAKE2b-256 f7fb9023e3e59873868430de0c3b5fd51008f4d51b700f89ce1c127e0079bfd6

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