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
  • 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.5.tar.gz (449.3 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.5-py3-none-any.whl (471.9 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: openbbq-0.0.5.tar.gz
  • Upload date:
  • Size: 449.3 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","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.5.tar.gz
Algorithm Hash digest
SHA256 6b713b2091770f8efe6195e3c84992991310258be5e9af5a821b4cbaa96f8ea3
MD5 97a85d3bd7ba9326f4175b48b06ea037
BLAKE2b-256 1d3811f0be0411d90dcbfbe5f23b0738aae5e2fddb4a8c5e8b8d06ef8f684a6f

See more details on using hashes here.

File details

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

File metadata

  • Download URL: openbbq-0.0.5-py3-none-any.whl
  • Upload date:
  • Size: 471.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: uv/0.11.28 {"installer":{"name":"uv","version":"0.11.28","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.5-py3-none-any.whl
Algorithm Hash digest
SHA256 7004e9e644aababf137b01d54d7a826ce2c8ce42fec578b1e6a853e67c3164df
MD5 3751929e2a8df9e019d071ba55397f47
BLAKE2b-256 f37e2b12c16657356a328b814a646635203df24322277331be23cbf28eba05e0

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