EkklesiaSing is a worship music web app designed specifically for house churches and individuals to stream, manage, and present worship songs. The app works offline and can be installed on your device for quick access.

Installing the App (PWA)

• On Mobile: Open the app webpage in your browser (use link button above), then tap "Share" then "Add to Home Screen"

• On Desktop: Look for the install icon in your browser's address bar

• Benefits: Faster loading, offline access, and easy access from your Home Screen

Sign In

• Click the “Sign In to Get Started” button

• Create or Sign in to your Replit account to create and save your personal library and settings

 General Steps

•  Add songs to your Library: This can be from the Music Catalog out your own songs

• Add songs to the Queue: From the Library, select up to 10 songs for the Queue on the Home page, tap button “Add Selected to Queue”

•  Reorder songs: On the Home page, drag and drop to order songs as you choose

•  Start Presentation mode: Turn device horizontally to start Presentation mode

•  Mirror to TV: After starting Presentation mode, use your device controls to start mirroring from your device to a smart TV

•  Use onscreen controls: The left side of the Presentation mode screen has controls to manage your tracks directly from the Presentation mode screen

 The home page is your music control center with these key features:

Preview Screen (turn device horizontally for Presentation view)

Main Controls

• Previous/Next Track: Move between songs in your queue

• Auto Mode: Toggle to turn on/off Auto mode which automatically advances through each track in the Queue

• Play/Pause Button: Large rectangular and color highlighted button for playback control

• Next Section: Scroll through lyrics section by section

• Volume Control: Adjust playbook volume in certain situations

• Song Slider: Use the slider to drag to desired point in song 

• Queue Display: Shows upcoming songs

Managing Your Queue

• Song Info: Title, cover art, and artist displayed prominently

• Go to Library, select songs (10 song limit), and "Add Selected to Queue," remove from queue with trash icon

• Songs play in the order they were added but you are able to drag and reorder

• Current song is highlighted in purple in the queue list

iOS Audio Tips: Use your device's physical volume buttons - the app volume slider may be limited in your device. Use device controls to mirror to Airplay TV or speakers.

Your personal library contains songs you've added from the Music Catalog and/or added yourself to the Library.

Adding Songs to Library

• From Music Catalog: Browse templates then tap "Copy to Library"

• Add New: Tap the "+" button to add a song

• Note: To use copyrighted music/lyrics in public, even for a house church size group, requires multiple licenses including copyright, synchronization, and mechanical licenses

Backup Your Library

• Periodically, use the Export button to save a backup of your library

• You can then Import the file if your Library is corrupted or deleted

Search Your Songs

• Type song titles, artists, or even lyrics content

• Results appear as you type in real-time

• Searches all song metadata and lyrics

Filter by Tags

• 1. Tap "Filter by Tags" to open the tag selector

• 2. Choose from current tags

• 3. Selected tags appear as blue badges

• 4. Clear individual tags or all at once

Bulk Actions

• Add to Queue: Select multiple songs and "Add Selected to Queue" (20 song limit)

• Selected Count: Always shows how many songs are selected

The Music Catalog contains template songs provided by Restoration Network Music that you can copy to your library. All the songs provided in the catalog are licensed to use freely in the app without copyright violation, royalties, or reporting requirements.

Browsing Templates

• View the complete catalog of available songs - listen on the website (https://restoration-network-music.com/)

• Professional recordings with artwork and lyrics

• Regular updates with new songs added

Filtering Templates

• Use the search bar for titles, artists, collection number, or scripture references

• Click "Filter by Tag" to browse by topics, books of the Bible, collection number, or themes

Copying to Your Library

• Preview: On the website https://restoration-network-music.com/

• Copy: Click "Copy to Library" to add to your Library, change cover art, tags, etc. 

You can include User Added songs in EkklesiaSing as long as you verify you own the rights to the lyrics, music, and cover art, or, have permission from the owner of these elements, or, you have appropriate licensing rights to use these in a gathering. Once this is verified, you can add your custom song. 

All User Added songs, including the mp3 and metadata, are saved to the users Google Drive. If you wish to add songs in addition to the Music Catalog you will need a Google Drive account (free 15GB data storage).

 Because your User Added songs are in a cloud drive, they are accessible from any device in which you have connected the EkklesiaSing app and your Google Drive account.

It is self evident that different assemblies of believers may have differing preferences for musical style. Although Restoration Network Music encourages church fellowships to create their own music in their own style preferences, we also recognize this can be a daunting task. Here is a plan to jump-start your music creation journey. 

Since Restoration Network Music has given explicit permission to create covers of all its music, much of the work has been done for you. Use the following simple steps to create your custom songs:

•  Create a free or paid account in Suno (or other similar AI music creation apps).

•  Open to edit any Restoration Network Music song in your Library and copy the lyrics.

•  Open your Suno account and select Custom at the top, paste the lyrics into the Lyrics window. Modify stylistic elements of the lyrics, ie, add or delete call and response lines. Modifications to fit the desired musical style are acceptable.

•  Detail your preferred musical style and specific details desired in the prompt for Styles. Periodically modify these prompts if the desired musical output is not meeting your expectations.

•  Use the Advanced Options if you have a preference for vocal gender, “weirdness”, or style influence.

•  Name your versions, 1Title for first pair of generated songs, 2 Title, for second pair, etc., to help keep track of those you prefer. You may modify the titles with “***” depending on how you rate it.

•  Keep tweaking Style prompts to fine tune your desired output. Additionally you can insert special prompts in [brackets] in the Lyric window to give specific prompts, add [instrumental] sections, and label parts of the song such as [chorus] or [bridge].

•  You can modify sections or extend from a selected point in time to change the ending.

•  Once satisfied with the product, download as an mp3 (or WAV file but you will have to convert to an mp3 for EkklesiaSing).

•  You can do a free, simple Mastering through app.bakuage.com. Once completed save this file, and do any further editing to the sound file. 

• Use the “+ Add Song” to add the mp3 to EkklesiaSing, complete the other metadata fields, cover art, etc., update the lyrics to include any minor changes in wording in your cover song.

Present lyrics full-screen through screen mirroring on your device for house church singing or personal use.

Opening Presentation Mode

• Lyric size and font can be edited in the Settings

• In the Library, select songs to add to Queue. Drag to re-order 

• Device Orientation: Turn your device to landscape mode to initiate Presentation mode

• IMPORTANT! Wait until you are in Presentation mode before initiating screen mirroring.

• Return to non-Presentation mode by returning device to vertical orientation

Presentation Controls

• Next Song/Previous Song: Loads adjacent song tracks from Queue

• Auto Mode: Toggle to turn on/off Auto mode which automatically advances through each track in the Queue

• Play/Pause: Starts or Pauses music for current song in Presentation

• Previous Section/Next Section: Navigates current song through lyric sections (you can also scroll lyrics manually on the touch screen)

• Clean Display: Controls minimally noticeable for distraction-free viewing

Best Practices: Test songs in Presentation mode before presenting to check front size, section breaks, etc. Connect to TV or projector for group viewing.

Lyrics Display

• Set font, font size, line spacing for lyrics

• Highlight, or no highlighting, the next/previous section of lyrics to focus on current lyrics

• Up to three pre-sets can be saved, ie, Vertical for Home page viewing and Horizontal for Presentation mode.

What Works Offline

• Playing Songs: Full playback with lyrics and artwork

• Presentation Mode: Full-screen lyrics display

• Library Management: Browse and organize your downloaded songs

• Search: Find songs in your library

What Requires Internet

• Downloading New Songs: Initial song creation

• Music Catalog: Adding template songs

• Account Sync: Backing up your library changes

Managing Downloads

• Check device storage if downloads fail

• Pull down to refresh if sync seems stuck

Audio Issues

• Use physical device volume buttons instead of app slider

• Check that device isn't in silent mode

• Ensure audio isn't going to unwanted Bluetooth device

• Check audio permissions in device settings

Mirroring Problems

• Ensure devices are on same WiFi network

• Check device connectivity

• Some wireless speakers may have slight delay

Download Issues

• Storage Space: Check available device storage

• WiFi Connection: Large files need stable internet

• Cache Clear: Try refreshing the page if downloads stall

• Retry: Failed downloads can often be retried

App Performance

• Slow Loading: Check internet connection or try offline mode

• Crashes: Restart the app or refresh the browser page

• Sync Problems: Sign out and sign back in to refresh account sync

Common Error Messages

• "No songs found": Check filters or search terms

• "Failed to download": Check internet and storage space

• "Offline mode": Limited features until connection restored

Library: Your personal collection of songs that you have licenses for and can edit

Music Catalog: Template songs provided by Restoration Network Music that you can copy to Library

Template: A master song that can be copied to your library

Tags: Keywords that help organize and find songs by topic, Bible book, or theme

Queue: List of songs waiting to play on the home page

Presentation Mode: Full-screen lyrics display for small groups/house churches

PWA: Progressive Web App that can be installed like a native app

Caching: Storing songs on your device for offline access

Sync: Updating your library between your device and the server