EkklesiaSing is a worship music 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 in your browser, 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

• Sign in with your Replit account to save your personal library

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

Main Controls

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

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

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

• Next/Previous Sections: 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

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

• Songs play in the order they were added but 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. 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"

• Create New: Tap the "+" button to create a song

• Note: To use copyrighted music/lyrics in public, even house church size, 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" (10 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

• 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 make your own editable version

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

Opening Presentation Mode

• Lyric size and font can be edited in the Settings

• On the Home page, add desired songs 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

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

• Previous Section/Next Section: Navigates current song through lyric sections

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

Best Practices: Test songs 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 the next/previous section of lyrics to focus on current lyrics

• Up to three pre-sets can be saved

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

• "Unauthorized": Sign in to access personal features

• "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

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