Skip to content

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.

Notifications You must be signed in to change notification settings

godwill1224/leb-lango-bible-osis-converter

Repository files navigation

📖 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):

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:
python convert_bblx_to_osis.py
  1. Result:
✅ 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 the script if needed
  • Clean special characters or footnotes post-export
  • Convert to other formats (CSV, EPUB, TXT)

📇 Project Info

Project Title: Lëb Lango Bible OSIS Conversion

Created by: Mawa Godwill

Purpose: Enable native language Bible projection in OpenLP using .bblx sources

License: Free for personal and church use


🙏 Acknowledgments


📬 Need help? Open an issue or contact me directly.

About

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.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages