Skip to content

kenschultz64/gogospelnow

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

62 Commits
conductor
conductor
 
 
listener-app
listener-app
 
 
scripts
scripts
 
 
temp_audio
temp_audio
 
 
tests
tests
 
 
.gitignore
.gitignore
 
 
APPLICATION_SETTINGS.md
APPLICATION_SETTINGS.md
 
 
FAQ.md
FAQ.md
 
 
GoGospelNow_backup_2025-12-23.zip
GoGospelNow_backup_2025-12-23.zip
 
 
GoGospelNow_v2.zip
GoGospelNow_v2.zip
 
 
HARDWARE_RECOMMENDATIONS.md
HARDWARE_RECOMMENDATIONS.md
 
 
INSTALL.txt
INSTALL.txt
 
 
LICENSE
LICENSE
 
 
PERFORMANCE_TUNING_GUIDE.md
PERFORMANCE_TUNING_GUIDE.md
 
 
README.md
README.md
 
 
ROADMAP.md
ROADMAP.md
 
 
SECURITY_SETUP.md
SECURITY_SETUP.md
 
 
THIRD_PARTY.md
THIRD_PARTY.md
 
 
TTS_SUPPORTED_LANGUAGES.md
TTS_SUPPORTED_LANGUAGES.md
 
 
TUNING.md
TUNING.md
 
 
UPDATES.md
UPDATES.md
 
 
backup.zip
backup.zip
 
 
check_google_voices.py
check_google_voices.py
 
 
display_debug.txt
display_debug.txt
 
 
gogospelnow.desktop
gogospelnow.desktop
 
 
launch.bat
launch.bat
 
 
listener-standalone.html
listener-standalone.html
 
 
listener.html
listener.html
 
 
main.py
main.py
 
 
requirements.txt
requirements.txt
 
 
settings.json
settings.json
 
 
start_translator.sh
start_translator.sh
 
 
testkokoro.py
testkokoro.py
 
 
translator_core.py
translator_core.py
 
 
update_settings.py
update_settings.py
 
 
user_preferences.json
user_preferences.json
 
 

Repository files navigation

GoGospelNow Real-Time Preaching Translator

Watch the video Buy Me A Coffee

What You Need to Know Before Starting

The GoGospelNow Translator uses three background technologies:

  • Python (version 3.11 or higher) - the programming language
  • Docker - runs the text-to-speech service
  • Ollama - runs the AI translation models

This guide will walk you through installing everything step-by-step. Choose your operating system below and follow ALL the steps in order:

After installation, see Running the Translator to start using the program.

Windows Installation 🪟

Follow these steps in order. Do not skip any steps.

Step 1: Check Python Version

  1. Open Command Prompt or PowerShell:

    • Press Windows Key + R
    • Type cmd and press Enter

  2. Check if Python is installed:

    python --version

  3. If you see "Python 3.11" or higher (like 3.12, 3.13), you're good! Skip to Step 2.

  4. If you see a version lower than 3.11 OR get an error, you need to install Python:

    • Go to https://www.python.org/downloads/
    • Click the yellow "Download Python" button (get the latest version)
    • Run the installer
    • ⚠️ IMPORTANT: Check the box "Add Python to PATH" at the bottom of the installer
    • Click "Install Now"
    • After installation, close and reopen Command Prompt
    • Verify: python --version should now show 3.11 or higher

Step 2: Install Docker

  1. Go to https://www.docker.com/products/docker-desktop/
  2. Click "Download for Windows"
  3. Run the installer (Docker Desktop Installer.exe)
  4. Follow the installation wizard (use default settings)
  5. Restart your computer when prompted
  6. After restart, launch Docker Desktop from the Start menu
  7. Wait for Docker to start (you'll see a green icon in the system tray)

✅ Verify Docker is working:

docker --version

You should see something like "Docker version 24.x.x"

Step 3: Install Ollama

  1. Go to https://ollama.com/download
  2. Click "Download for Windows"
  3. Run the installer (OllamaSetup.exe)
  4. Follow the installation wizard
  5. Ollama will start automatically after installation

✅ Verify Ollama is working:

ollama --version

You should see the Ollama version number.

Step 4: Install Git (if needed)

  1. Check if Git is already installed:

    git --version

  2. If you get an error, install Git:

    • Go to https://git-scm.com/downloads
    • Click "Download for Windows"
    • Run the installer
    • Use all default settings (just keep clicking "Next")
    • After installation, close and reopen Command Prompt

Step 5: Download the GoGospelNow Program

  1. Open Command Prompt or PowerShell

  2. Navigate to where you want to install (for example, your Documents folder):

    cd Documents

  3. Download the program:

    git clone https://github.com/kenschultz64/gogospelnow.git

  4. Go into the program folder:

    cd gogospelnow

✅ Verify: You should see the program files:

dir

Step 6: Create Python Virtual Environment

  1. Make sure you're in the gogospelnow folder (from Step 5)

  2. Create a virtual environment:

    python -m venv venv

  3. Activate the virtual environment:

    venv\Scripts\activate

✅ Verify: Your command prompt should now show (venv) at the beginning of the line.

Step 7: Install FFmpeg (Audio Processing)

  1. Go to https://www.gyan.dev/ffmpeg/builds/

  2. Download ffmpeg-release-full.7z (the first link under "release builds")

  3. Extract the downloaded file:

    • Right-click the file
    • Choose "Extract All" (or use 7-Zip if you have it)

  4. Rename the extracted folder to just ffmpeg

  5. Move the ffmpeg folder to C:\ (so the path is C:\ffmpeg)

  6. Add FFmpeg to your system PATH:

    • Press Windows Key and type "environment variables"
    • Click "Edit the system environment variables"
    • Click "Environment Variables" button
    • Under "System variables", find and select "Path"
    • Click "Edit"
    • Click "New"
    • Type: C:\ffmpeg\bin
    • Click "OK" on all windows
    • Close and reopen Command Prompt

✅ Verify FFmpeg is working:

ffmpeg -version

Step 8: Install Python Dependencies

  1. Make sure your virtual environment is activated (you should see (venv) in your prompt)

  2. If not activated, run: venv\Scripts\activate

  3. Install required Python packages:

    pip install -r requirements.txt

    This will take a few minutes. Wait for it to complete.

✅ Verify: No error messages should appear. Check installed packages:

pip list

Step 9: Start the Text-to-Speech Service

Choose ONE of these commands based on your computer:

If you have a gaming computer with an NVIDIA graphics card:

docker run -d --gpus all --restart unless-stopped --name kokoro-gpu -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-gpu

If you have a regular computer (no gaming graphics card):

docker run -d --restart unless-stopped --name kokoro-cpu -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-cpu

This will download and start the text-to-speech service. It may take several minutes the first time.

✅ Verify it's running:

docker ps

You should see a container named "kokoro-cpu" or "kokoro-gpu" running.

Step 10: Download AI Translation Models

You need at least one translation model. For most computers, start with a smaller model:

Recommended for most computers (choose ONE):

ollama pull gemma3n:e2b

Other options (you can install multiple):

ollama pull llama3.2:3b-instruct-q4_K_M
ollama pull granite3.3:2b

Each model will take several minutes to download.

✅ Verify your models are installed:

ollama list

You should see your downloaded models listed.

Step 11: Test the Translator

  1. Make sure your virtual environment is activated (you should see (venv))

  2. If not, activate it: venv\Scripts\activate

  3. Start the translator:

    python main.py

  4. Keep this Command Prompt window open! The program needs it to stay running.

  5. Open your web browser (Chrome recommended) and go to:

    http://localhost:7860

✅ Verify: You should see the GoGospelNow translator interface in your browser.

  1. For future use: After you've verified everything works, you can use the shortcut:
    • Double-click launch.bat in the gogospelnow folder

macOS Installation 🍎

Follow these steps in order. Do not skip any steps.

Step 1: Check Python Version

  1. Open Terminal:

    • Press Command + Space
    • Type "Terminal" and press Enter

  2. Check if Python 3.11 or higher is installed:

    python3 --version

  3. If you see "Python 3.11" or higher (like 3.12, 3.13), you're good! Skip to Step 2.

  4. If you see a version lower than 3.11, you need to install a newer version:

    • Go to https://www.python.org/downloads/
    • Click the yellow "Download Python" button (get the latest version)
    • Open the downloaded .pkg file
    • Follow the installation wizard
    • After installation, close and reopen Terminal
    • Verify: python3 --version should now show 3.11 or higher

Step 2: Install Homebrew (Package Manager)

Homebrew makes it easy to install software on Mac.

  1. Check if Homebrew is already installed:

    brew --version

  2. If you get an error, install Homebrew:

    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    • Press Enter when prompted
    • Enter your Mac password when asked (you won't see it as you type)
    • Wait for installation to complete (may take several minutes)

✅ Verify Homebrew is installed:

brew --version

Step 3: Install Docker

  1. Go to https://www.docker.com/products/docker-desktop/
  2. Click "Download for Mac"
    • Choose the correct version for your Mac:
      • Apple Silicon (M1, M2, M3 chips) - newer Macs
      • Intel Chip - older Macs
  3. Open the downloaded .dmg file
  4. Drag Docker to your Applications folder
  5. Open Docker from Applications
  6. Follow the setup wizard
  7. Enter your Mac password when prompted
  8. Wait for Docker to start (you'll see a whale icon in the menu bar)

✅ Verify Docker is working:

docker --version

Step 4: Install Ollama

  1. Go to https://ollama.com/download
  2. Click "Download for macOS"
  3. Open the downloaded file
  4. Drag Ollama to your Applications folder
  5. Open Ollama from Applications
  6. Ollama will appear in your menu bar (top of screen)

✅ Verify Ollama is working:

ollama --version

Step 5: Install Git (if needed)

Git is usually pre-installed on macOS, but let's check:

  1. Check if Git is installed:

    git --version

  2. If you get an error, macOS will prompt you to install Command Line Tools. Click "Install" and follow the prompts.

Step 6: Download the GoGospelNow Program

  1. In Terminal, navigate to where you want to install (for example, your Documents folder):

    cd ~/Documents

  2. Download the program:

    git clone https://github.com/kenschultz64/gogospelnow.git

  3. Go into the program folder:

    cd gogospelnow

✅ Verify: You should see the program files:

ls

Step 7: Create Python Virtual Environment

  1. Make sure you're in the gogospelnow folder (from Step 6)

  2. Create a virtual environment:

    python3 -m venv venv

  3. Activate the virtual environment:

    source venv/bin/activate

✅ Verify: Your terminal prompt should now show (venv) at the beginning.

Step 8: Install Required Software (FFmpeg, PortAudio, etc.)

  1. Install audio and GUI packages: 
    brew install ffmpeg portaudio libsndfile python-tk@3.11
    This will take several minutes.

✅ Verify installations:

ffmpeg -version
python3 -m tkinter

A small window should appear (you can close it).

Step 9: Install Python Dependencies

  1. Make sure your virtual environment is activated (you should see (venv) in your prompt)

  2. If not activated, run: source venv/bin/activate

  3. Install required Python packages:

    pip install -r requirements.txt

    This will take a few minutes. Wait for it to complete.

✅ Verify: No error messages should appear. Check installed packages:

pip list

Step 10: Start the Text-to-Speech Service

Choose ONE of these commands based on your Mac:

If you have an Apple Silicon Mac (M1, M2, M3) or Intel Mac with dedicated graphics:

docker run -d --gpus all --restart unless-stopped --name kokoro-gpu -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-gpu

If you have an older Intel Mac:

docker run -d --restart unless-stopped --name kokoro-cpu -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-cpu

This will download and start the text-to-speech service. It may take several minutes the first time.

✅ Verify it's running:

docker ps

You should see a container named "kokoro-cpu" or "kokoro-gpu" running.

Step 11: Download AI Translation Models

You need at least one translation model. For most computers, start with a smaller model:

Recommended for most computers (choose ONE):

ollama pull gemma3n:e2b

Other options (you can install multiple):

ollama pull llama3.2:3b-instruct-q4_K_M
ollama pull granite3.3:2b

Each model will take several minutes to download.

✅ Verify your models are installed:

ollama list

You should see your downloaded models listed.

Step 12: Test the Translator

  1. Make sure your virtual environment is activated (you should see (venv))

  2. If not, activate it: source venv/bin/activate

  3. Start the translator:

    python main.py

  4. Keep this Terminal window open! The program needs it to stay running.

  5. Open your web browser (Chrome recommended) and go to:

    http://localhost:7860

✅ Verify: You should see the GoGospelNow translator interface in your browser.

  1. For future use: After you've verified everything works, you can use the shortcut:
    • In Terminal, navigate to the gogospelnow folder
    • Run: ./start_translator.sh

Linux Installation 🐧

Follow these steps in order. Do not skip any steps.

Step 1: Check Python Version

  1. Open Terminal (usually Ctrl+Alt+T)

  2. Check if Python 3.11 or higher is installed:

    python3 --version

  3. If you see "Python 3.11" or higher (like 3.12, 3.13), you're good! Skip to Step 2.

  4. If you see a version lower than 3.11, install a newer version:

    For Ubuntu/Debian:

    sudo apt update
sudo apt install software-properties-common
sudo add-apt-repository ppa:deadsnakes/ppa
sudo apt update
sudo apt install python3.11 python3.11-venv python3.11-dev

    For Fedora/RHEL:

    sudo dnf install python3.11 python3.11-devel

    For Arch Linux:

    sudo pacman -S python

✅ Verify: python3.11 --version should show 3.11 or higher

Step 2: Install Docker

For Ubuntu/Debian:

sudo apt update
sudo apt install docker.io
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker $USER

For Fedora/RHEL:

sudo dnf install docker
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker $USER

For Arch Linux:

sudo pacman -S docker
sudo systemctl start docker
sudo systemctl enable docker
sudo usermod -aG docker $USER

Important: After running these commands, log out and log back in for the docker group changes to take effect.

✅ Verify Docker is working:

docker --version

Step 3: Install Ollama

  1. Download and install Ollama:

    curl -fsSL https://ollama.com/install.sh | sh

  2. Start Ollama service:

    sudo systemctl start ollama
sudo systemctl enable ollama

✅ Verify Ollama is working:

ollama --version

Step 4: Install Git (if needed)

  1. Check if Git is installed:

    git --version

  2. If you get an error, install Git:

    For Ubuntu/Debian:

    sudo apt install git

    For Fedora/RHEL:

    sudo dnf install git

    For Arch Linux:

    sudo pacman -S git

Step 5: Download the GoGospelNow Program

  1. Navigate to where you want to install (for example, your home folder):

    cd ~

  2. Download the program:

    git clone https://github.com/kenschultz64/gogospelnow.git

  3. Go into the program folder:

    cd gogospelnow

✅ Verify: You should see the program files:

ls

Step 6: Create Python Virtual Environment

  1. Make sure you're in the gogospelnow folder (from Step 5)

  2. Create a virtual environment:

    python3 -m venv venv

    (If you installed Python 3.11 specifically, use: python3.11 -m venv venv)

  3. Activate the virtual environment:

    source venv/bin/activate

✅ Verify: Your terminal prompt should now show (venv) at the beginning.

Step 7: Install Required Software (FFmpeg, PortAudio, etc.)

For Ubuntu/Debian:

sudo apt update
sudo apt install ffmpeg portaudio19-dev libsndfile1 python3-tk

For Fedora/RHEL:

sudo dnf install ffmpeg portaudio-devel libsndfile python3-tkinter

For Arch Linux:

sudo pacman -S ffmpeg portaudio libsndfile tk

✅ Verify installations:

ffmpeg -version
python3 -m tkinter

A small window should appear (you can close it).

Step 8: Install Python Dependencies

  1. Make sure your virtual environment is activated (you should see (venv) in your prompt)

  2. If not activated, run: source venv/bin/activate

  3. Install required Python packages:

    pip install -r requirements.txt

    This will take a few minutes. Wait for it to complete.

✅ Verify: No error messages should appear. Check installed packages:

pip list

Step 9: Start the Text-to-Speech Service

Choose ONE of these commands based on your computer:

If you have an NVIDIA graphics card with CUDA support:

docker run -d --gpus all --restart unless-stopped --name kokoro-gpu -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-gpu

If you have a regular computer (no gaming graphics card):

docker run -d --restart unless-stopped --name kokoro-cpu -p 8880:8880 ghcr.io/remsky/kokoro-fastapi-cpu

This will download and start the text-to-speech service. It may take several minutes the first time.

✅ Verify it's running:

docker ps

You should see a container named "kokoro-cpu" or "kokoro-gpu" running.

Step 10: Download AI Translation Models

You need at least one translation model. For most computers, start with a smaller model:

Recommended for most computers (choose ONE):

ollama pull gemma3n:e2b

Other options (you can install multiple):

ollama pull llama3.2:3b-instruct-q4_K_M
ollama pull granite3.3:2b

Each model will take several minutes to download.

✅ Verify your models are installed:

ollama list

You should see your downloaded models listed.

Step 11: Test the Translator

  1. Make sure your virtual environment is activated (you should see (venv))

  2. If not, activate it: source venv/bin/activate

  3. Start the translator:

    python main.py

  4. Keep this Terminal window open! The program needs it to stay running.

  5. Open your web browser (Chrome recommended) and go to:

    http://localhost:7860

✅ Verify: You should see the GoGospelNow translator interface in your browser.

  1. For future use: After you've verified everything works, you can use the shortcut:
    • In Terminal, navigate to the gogospelnow folder
    • Run: ./start_translator.sh

Running the Translator

After you've completed the installation for your operating system:

Starting the Program

Windows:

  • Double-click launch.bat in the gogospelnow folder
  • OR open Command Prompt, navigate to the folder, and run: python main.py

macOS/Linux:

  • Open Terminal, navigate to the gogospelnow folder
  • Run: ./start_translator.sh
  • OR run: python main.py

Using the Translator

  1. Keep the terminal/command prompt window open while using the program
  2. Open your web browser and go to: http://localhost:7860
  3. The translator interface will load
  4. Select your translation model from the dropdown
  5. Choose your source and target languages
  6. Click "Start" to begin translating

Features

  • Transcription: Faster-Whisper with configurable selectable models.
  • Translation: Local LLM via Ollama API so you can use the latest open-source models as they are released.
  • TTS:
    • Local: Kokoro FastAPI server supporting 9 languages (American/British English, Spanish, French, Italian, Brazilian Portuguese, Japanese, Chinese, and Hindi).
    • Cloud: Google Cloud TTS supporting 30+ languages (requires API key).
  • Secondary Output Monitor: Dedicated translation display window that can be moved to any connected monitor.
    • Smart Monitor Selection: Monitors are numbered left-to-right (Monitor 1, Monitor 2, etc.) for intuitive selection.
    • Custom Window Sizes: Set custom Width × Height for the display window, or use preset resolutions.
    • Worship-Friendly Close Button: Subtle close button that's nearly invisible (appears on hover). Press Escape key to close.
    • Hotkey Support: Press 'M' to cycle through monitors, Escape to close.
    • Cross-Platform: Works on Windows, macOS, and Linux.
  • Performance Tuning: Manual control over all timing and VAD parameters via sliders.
  • Expanded API Support: Integrate with major cloud AI providers including OpenAI, Groq, xAI (Grok), Mistral, and Custom OpenAI (compatible endpoints), in addition to local Ollama models.
  • History: Translation history logging.
  • Offline Capable: Works completely locally (Internet required only for setup and Google Cloud TTS).
  • Universal Translator (Reverse Translation): Can translate from any of the ~86 supported source languages back into English, allowing English speakers to understand foreign-language sermons.

Configuring Cloud Translation Providers (Optional)

You can configure the translator to use cloud-based LLMs for potentially higher quality or faster translations. This requires API keys from the respective providers.

  1. Open the Settings Tab in the application interface.
  2. Enter your API Keys for the services you wish to use:
    • OpenAI: https://platform.openai.com/api-keys
    • Groq: https://console.groq.com/keys
    • Grok (xAI): https://console.x.ai/
    • Mistral: https://console.mistral.ai/api-keys
    • Custom OpenAI: Enter your custom Base URL and API Key.
  3. Click "Save Server Settings".
  4. Select the Provider in the main "Speech Translator" tab using the "Translation Provider" dropdown.

Configuring Google Cloud Text-to-Speech (Optional)

If you want to use Google Cloud Text-to-Speech voices in addition to the local Kokoro voices, you'll need to set up a Google Cloud API key. This is optional - the translator works perfectly with just the local Kokoro voices.

Getting Your Google Cloud API Key

  1. Go to the Google Cloud Console
  2. Create a new project or select an existing one
  3. Enable the "Cloud Text-to-Speech API" for your project
  4. Go to "APIs & Services" → "Credentials"
  5. Click "Create Credentials" → "API Key"
  6. Copy your API key (it will look like: AIzaSyC...)

Securely Adding Your API Key

IMPORTANT: Never hardcode your API key in files that might be shared or committed to version control. Use environment variables instead.

Windows:

  1. Open Command Prompt or PowerShell

  2. Set the environment variable for the current session:

    $env:GOOGLE_API_KEY="your-api-key-here"

  3. To make it permanent (persists after reboot):

    setx GOOGLE_API_KEY "your-api-key-here"

    Then close and reopen your terminal.

  4. Verify it's set:

    echo $env:GOOGLE_API_KEY

macOS/Linux:

  1. Open Terminal

  2. Edit your shell configuration file:

    • For bash: nano ~/.bashrc or nano ~/.bash_profile
    • For zsh (default on newer macOS): nano ~/.zshrc

  3. Add this line at the end of the file:

    export GOOGLE_API_KEY="your-api-key-here"

  4. Save and exit (Ctrl+X, then Y, then Enter in nano)

  5. Reload your configuration:

    source ~/.bashrc    # or ~/.zshrc or ~/.bash_profile

  6. Verify it's set:

    echo $GOOGLE_API_KEY

Using the API Key

Once the environment variable is set:

  1. Restart the translator application
  2. The program will automatically detect and use your Google API key
  3. You'll now have access to Google Cloud voices in addition to Kokoro voices

Security Note: The API key is stored as an environment variable on your computer only. It's never saved in the program files or shared publicly.

Customizing the Translation Prompt

You can customize the instructions given to the AI translator to change the tone, style, or specific requirements of the translation. This is useful for:

  • Giving the translation a specific "persona" (e.g., "Translate for a theology student")
  • Using a specific dialect or vocabulary
  • Adding constraints (e.g., "Keep sentences short")

How to Customize:

  1. Go to the Settings tab.
  2. Scroll to the Server Settings section.
  3. Find the System Prompt Template text box.
  4. Edit the text to your liking.

Important:

  • Caution: Only modify this if the default translation style isn't meeting your needs.
  • Backup: Copy and paste the current prompt into a text file before changing it, so you can easily revert if the new prompt causes issues.
  • You MUST use the placeholders {source_lang} and {target_lang} in your prompt so the system can insert the correct languages.
  • Default Prompt: 
    You are a professional translator. Translate the following text from {source_lang} to {target_lang}. Provide ONLY the translation, without any explanations, notes, or extra text.

Mobile Listener App 📱

GoGospelNow includes a mobile listener feature that allows congregation members to view translations and hear audio on their own phones.

Connecting to the Listener

  1. Start the GoGospelNow translator on your computer
  2. Look for the Mobile Listener URL displayed in the header (e.g., 192.168.1.50:8000)
  3. Share this URL with your congregation
  4. Members open the URL in their phone's browser (Chrome or Safari)
  5. Tap "Start Listening" to begin receiving translations

Setting Up a Static IP Address (Recommended)

For a consistent connection, we recommend setting a static IP on the translator computer so the URL never changes.

Windows:

1. Automated Script (Recommended)

  1. Navigate to the scripts folder
  2. Double-click set_static_ip_windows.bat
  3. Click Yes if prompted to run as Administrator
  4. Follow the on-screen prompts

2. Manual Method

  1. Open Settings → Network & Internet → Wi-Fi (or Ethernet)
  2. Click on your connected network
  3. Click Edit under "IP assignment"
  4. Change from "Automatic (DHCP)" to Manual
  5. Toggle IPv4 to On
  6. Fill in:
    • IP address: Choose one (e.g., 192.168.1.100)
    • Subnet prefix length: 24
    • Gateway: Your router's IP (usually 192.168.1.1)
    • Preferred DNS: 8.8.8.8
  7. Click Save

macOS:

1. Automated Script (Recommended)

  1. Open Terminal
  2. Run: sudo ./scripts/set_static_ip_mac.sh
  3. Follow the prompts

2. Manual Method

  1. Open System Preferences → Network
  2. Select your connection (Wi-Fi or Ethernet)
  3. Click Advanced → TCP/IP tab
  4. Change "Configure IPv4" to Manually
  5. Fill in:
    • IPv4 Address: Choose one (e.g., 192.168.1.100)
    • Subnet Mask: 255.255.255.0
    • Router: Your router's IP (usually 192.168.1.1)
  6. Click OK → Apply

Linux:

Using Script (Recommended):

  1. Open Terminal
  2. Run: sudo ./scripts/set_static_ip_linux.sh

Using NetworkManager (GUI):

  1. Click the network icon → Settings (or Connection Settings)
  2. Select your connection → click the gear icon
  3. Go to IPv4 tab
  4. Change Method to Manual
  5. Add an address:
    • Address: 192.168.1.100
    • Netmask: 255.255.255.0
    • Gateway: 192.168.1.1
  6. Save and reconnect

Using command line (nmcli manually):

# List connections
nmcli con show

# Set static IP (replace "Wired connection 1" with your connection name)
sudo nmcli con mod "Wired connection 1" ipv4.addresses 192.168.1.100/24
sudo nmcli con mod "Wired connection 1" ipv4.gateway 192.168.1.1
sudo nmcli con mod "Wired connection 1" ipv4.dns "8.8.8.8"
sudo nmcli con mod "Wired connection 1" ipv4.method manual

# Restart connection
sudo nmcli con down "Wired connection 1" && sudo nmcli con up "Wired connection 1"

Android Screen Timeout Issue

Android phones aggressively turn off the screen to save battery. For long services (40+ minutes), the listener page cannot reliably keep the screen on via JavaScript.

Solution: Use the native Android App (see below) which has guaranteed screen-on functionality.

📱 Mobile Listener App

The GoGospelNow Mobile Listener allows congregation members to receive real-time translations on their phones. The translation text and audio are streamed directly to their devices.

How It Works

  1. The translator server runs on port 8000
  2. The IP address is shown in the main app header (e.g., 192.168.1.22:8000)
  3. Phones connect to this address via WiFi
  4. They receive live translation text and audio

Android App (Recommended)

The native Android app provides:

  • ✅ Guaranteed screen-on - Screen stays active for the entire service
  • ✅ Saves server address - No need to re-enter each time
  • ✅ Audio playback - Auto-plays translated audio
  • ✅ Offline capable - Works on local network only

Installation:

  1. Download GoGospelNow-Listener.apk from your church website or file share
  2. Enable "Install from unknown sources" when prompted
  3. Install and open the app
  4. Enter the server IP address (shown on the translator computer)
  5. Tap "Connect & Start Listening"

Building the APK (for developers):

  • The source code is in listener-app/ directory
  • Open listener-app/android/ in Android Studio
  • Build → Assemble app
  • APK is at listener-app/android/app/build/outputs/apk/debug/app-debug.apk

iPhone / iPad (Web App)

iOS users use the web-based listener:

  1. Open Safari on the iPhone/iPad
  2. Go to http://[SERVER-IP]:8000 - use listener-standalone.html hosted on your website
  3. Enter the server IP address
  4. Tap "Connect & Start Listening"
  5. (Optional) Tap Share → "Add to Home Screen" for app-like experience

Note: iOS's Screen Time settings may need adjustment for long services.

Network Requirements

Congregation Size Network Recommendation
Up to 50 phones Standard WiFi router
50-150 phones Dual-band router or 2 access points
150-300 phones Business-grade WiFi (Ubiquiti, etc.)
300+ phones Multiple access points + Gigabit backbone

Bandwidth per phone: ~30-50 kbps (very low)

The listener app works alongside NDI video and other network traffic without issues.

🔌 Offline / Air-Gapped Operation

GoGospelNow can run completely offline with no internet connection. This is perfect for:

  • Mission trips without internet
  • Remote locations
  • Maximum privacy (nothing leaves the building)

Offline Setup

  1. Use local models only:

    • Whisper (local) for transcription
    • Ollama with downloaded models for translation
    • Kokoro for TTS

  2. Connect all devices to the same router (no internet required)

  3. Phones connect via WiFi to the router

[Computer] ←→ [Local Router] ←→ [Phones on WiFi]
     ↑              ↑
  (Ethernet)    (No Internet)

All translation happens locally. The phones only need to reach the server on the local network.

Avoid Audio Loopback

Note translation audio should be isolated from the microphone or the program will loop back trying to interpret again what has been translated. Suggested use would be using an aux send to the computer's input for the mic signal. Then use another aux send to output audio to a transmitter to send the translated audio to individual receivers with headphones. Also could be used with Bluetooth headphones depending on the distance and devices needed.

Audio Setup Diagram Watch the video

Additional Documentation

For more detailed information, please refer to these additional guides:

Buy Me A Coffee

About

Real Time Preaching Translator

www.gogospelnow.com

Topics

real-time translation ai church gospel preaching

Resources

Readme

License

View license
Activity

Stars

2 stars

Watchers

1 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages