Glossaries

Reuse canonical names, aliases, translation choices, and context across workspaces.

A glossary is a named JSON document stored globally under $OPENBBQ_HOME/glossaries/. It can influence three parts of the workflow:

Canonical source terms bias supported ASR backends.
Known aliases are corrected to canonical source spelling during segmentation.
Translation targets and keep rules are included in translation worksheets and checks.

Create a glossary

openbbq glossary new project-name --context "Technical interviews about AI developer tools"

The result is ~/.openbbq/glossaries/project-name.json by default:

{
  "schema": "openbbq/glossary@1",
  "name": "project-name",
  "context": "Technical interviews about AI developer tools",
  "terms": []
}

Add terms

Edit the JSON file and add entries:

{
  "source": "OpenBBQ",
  "target": null,
  "aliases": ["Open BBQ", "Open BQ"],
  "note": "Project and CLI name",
  "keep": true
}

Fields:

Field	Meaning
`source`	Canonical source spelling; also used for ASR biasing
`target`	Canonical translation when the term should be translated
`aliases`	Known ASR mistakes or alternate source forms corrected to `source`
`note`	Disambiguation context for translators or agents
`keep`	Keep the source spelling in target text

Use target for a canonical translation, or keep: true for a brand/proper noun that should remain unchanged. Leaving both unset means the translation decision is still open.

Inspect the library

openbbq glossary list
openbbq glossary show project-name

Bind a glossary to a workspace

At initialization:

openbbq init /path/to/video.mp4 --workspace workspaces/demo --glossary project-name

Or later:

openbbq glossary use project-name --workspace workspaces/demo

The binding is written to manifest.glossary. transcribe, segment, and translate init use it unless their own --glossary option overrides the name.

Mine candidate terms

After transcription, ask OpenBBQ to surface repeated proper-noun-shaped or low-confidence words:

openbbq glossary suggest --workspace workspaces/demo

Useful filters:

openbbq glossary suggest \
  --workspace workspaces/demo \
  --glossary project-name \
  --max-prob 0.6 \
  --min-count 2 \
  --max 30

Suggestions are deterministic candidates, not automatic semantic edits. Review them, then add appropriate terms manually.