godwill1224/leb-lango-bible-osis-converter

Convert the Lëb Lango Bible from an e-Sword .bblx module into a clean, standards-compliant .osis.xml format — ready for use in OpenLP and other Bible presentation software. # 📖 Lëb Lango Bible OSIS Converter Convert the **Lëb Lango Bible** from an e-Sword `.bblx` module into a clean, standards-compliant `.osis.xml` format — ready for use in **OpenLP** and other Bible presentation software. --- ## 📚 Project Description This tool extracts scripture text from a `.bblx` file (specifically formatted for e-Sword) and converts it into a valid OSIS XML format: - 🔄 Converts `.bblx` → `.osis.xml` - 🧼 Cleans up RTF-encoded verses - 🌍 Uses correct book/chapter/verse mapping - 🎛 Structured and formatted for **OpenLP import** It’s ideal for churches, Bible study leaders, and developers who want to **present the Lëb Lango Bible** using modern tools while retaining local language scripture integrity. --- ## 📦 Output | File | Description | |----------------------------|--------------------------------------------------| | `convert_bblx_to_osis.py` | Python script that performs the conversion | | `Lango Bible -(ng).bblx` | Source: Lëb Lango e-Sword Bible module | | `leb-lango.osis.xml` | Output: OSIS-formatted Bible (OpenLP-ready) | --- ## 🧰 Requirements - Python 3.7+ - A `.bblx` file (e.g. `Lango Bible -(ng).bblx`) - RTF-to-text support via `striprtf` Install via virtual environment (recommended): ```bash python3 -m venv .venv source .venv/bin/activate pip install lxml striprtf ```` --- ## ▶️ How to Use 1. Place your `.bblx` file in the same folder 2. Run the script: ```bash python convert_bblx_to_osis.py ``` 3. Result: ```bash ✅ OSIS Bible generated: leb-lango.osis.xml ``` --- ## 📥 How to Import into OpenLP 1. Open **OpenLP** 2. Navigate to: `File → Import → Bibles → OSIS File` 3. Select `leb-lango.osis.xml` 4. Give it a display name (e.g. *Lëb Lango Bible*) 5. Confirm and finish ✅ You’ll now be able to search and display verses in Lëb Lango language during services or events. --- ## ⚙️ Advanced Customization * Customize `BOOK_CODES` in …