Scripture Burrito Specification¶
- Status:
Working Draft
- Date:
09 July 2026
Scripture Burrito is a standard for exchanging Bible translation projects between tools. At the core is a metadata file — the burrito — that describes every file in a project: what it contains, what part of Scripture it covers, and what role it plays. The same burrito can be stored as a zip file, a directory, a GitHub repository, a database, or delivered via API.
All burritos share a common structure — see Scripture Burrito Structure. Flavor-specific fields are documented below.
This Scripture Burrito specification defines these flavors:
Scripture Text — USFM, USX, or USJ text translations [Specification | Tutorial | Example]
Scripture Audio — recorded audio translations [Specification | Tutorial | Example]
Alignment — word-level or timecode alignment between two texts [Specification | Tutorial | Example]
Wrapper — groups related burritos together, such as a text and audio burrito for the same translation [Specification | Tutorial | Example]
Any flavor can also be extended:
Derived — burritos produced from other burritos, such as back-translations and publication artifacts [Specification | Tutorial | Example]
Custom — defining your own nonstandard flavor using the
x-prefix [Specification]
The following beta flavors are defined in Scripture Burrito v1.0.0. When a beta flavor reaches release status, it will be added to this specification.