Scripture App Builder (SAB) is a powerful tool that allows you to create customized Bible apps for Android devices. These apps can include Scripture text and audio, and they can be distributed globally, allowing people to engage with the Bible in their own language. In this guide, we’ll walk you through the process of creating your own Bible app using Scripture App Builder.

Features of Scripture App Builder

  1. Uses existing translation files: Import raw files from Paratext or the Digital Bible Library.
  2. Audio synchronization: Sync audio with text, highlighting verses or phrases as the audio plays.
  3. Offline distribution: Share apps via Bluetooth, microSD, wireless devices, email, websites, or the Google Play Store.
  4. Complex font handling: Include fonts suitable for Roman or Non-Roman scripts.
  5. Localization and customization: Customize app icons, splash screens, color schemes, and interface text.
  6. Support for non-Scripture texts: Publish books of songs, commentaries, picture stories, and devotional materials.
  7. Export to EPUB: Create e-books in EPUB format with text-audio synchronization.

How To Guide

Step 1: Install Required Software

  1. Download and Install JDK: Ensure you have version 17 of the Java Development Kit (JDK). You can download it from the Azul website.
  2. Install Android SDK: Use the Install Android SDK wizard within SAB to download and install the Android SDK.
  3. Install Scripture App Builder: Download the latest setup program from the Scripture App Builder download page.

Step 2: Get Started with Scripture App Builder

  1. Launch SAB: Open the Scripture App Builder application on your computer.
  2. Start a New Project: Click New App on the toolbar to open the New App wizard.
  3. Enter Basic Information:
    • App Name: Provide a clear and understandable name for your app.
    • Package Name: Enter a unique identifier for your app, usually in the format org.yourorganization.app.

Step 3: Add Content

  1. Add Scriptures: Select the books you want to include. You can add files in USFM, USX, or Word document format.
  2. Set Book Order: Configure the order of the books according to the church tradition of the target users.
  3. Specify Language: Choose the language code and name for the app. You can also add script, region, and variant information.

Step 4: Customize Appearance

  1. Choose Fonts: Select appropriate fonts for the text. You can include multiple fonts for user selection.
  2. Select Color Scheme: Choose a color scheme for the app, including main bars and individual items.
  3. Design Icons: Create app icons and splash screens using PNG images. Customize the app interface text in various languages.

Step 5: Add Audio Files

  1. Synchronize Audio: Include audio files (MP3) for each chapter and synchronize them with the text using timing files.
  2. Add Audio Files: Upload the necessary audio files and timing files to the app.
  3. Customize Audio Sources: Configure where the audio files will be stored, whether inside the APK, on an external folder, or for online download.

Step 6: Build Your App

  1. Preview Your App: Check all settings and configurations to ensure everything is correct.
  2. Build the App: Click the Build Android App button. If something is not configured correctly, the builder will notify you.
  3. Install on Device: Once the app is built, copy the APK file to your device using a USB cable or a file transfer app.

Step 7: Distribute Your App

  1. Test the App: Install the APK file on your Android device and test all functionalities.
  2. Share Offline: Distribute the app via Bluetooth, Wi-Fi transfer apps (like Xender), or microSD cards.
  3. Publish Online: Upload the app to the Google Play Store or your website for online distribution.

Additional Features & Resources

  1. Non-Scripture Texts: Add songs, stories, and other devotional materials.
  2. EPUB Export: Create EPUB e-books for various platforms.
  3. Workshops & Tutorials: Use available resources like video tutorials and manuals on the SAB resources page.

Conclusion

Scripture App Builder empowers you to create customized Bible apps that can be distributed worldwide, enabling people to engage with Scripture in their heart language. By following this guide, you can create a robust, user-friendly app that serves your community’s spiritual needs.

For more detailed instructions and resources, visit the Scripture App Builder website. Happy app building!