A Songleader's tool

This app puts the slides back in the hands of the songleader where they belong!

The idea is that the songleader has their iPad on their music stand on stage and they can choose any slide from any song on the playlist at any time.

Whatever slide is currently live is what the Audience's screen shows, and the songleader can select any slide from any song to play next.

It even works well with presentation clickers!

View more screenshots here: client/public/images/screenshots/March_2024/

🆓 God's Assembly Songbook™️ is free software and it's all Open-Source, because God gave me the talent and the good health to do it. I enjoy coding and this is one of the things that I like to do with the life that He gave me 🥳

You can double-click the file named gas-linux (or gas-win if you have Windows).

It should open up your default browser automatically, but if you need to go there manually, just type http://localhost into the URL bar.

On the settings page you will see the Application URL. Anyone can open that page in their browser as long as they're connected to the same network.

That's how the songleader can use it from their iPad on stage.

For the projector screen, simply click on the "Audience" tab at the home page and click the button to go to full-screen view.

You can go in and out of fullscreen view by pressing the F11 key in the browser.

You should not be making changes to the distributable code base. If you want to modify God's Assembly Songbook™️, you should either clone or fork the Git repository:

git clone https://github.com/adonai-reigns/Gods-Assembly-Songbook.git

In a Terminal from the Project's root directory:

1. docker compose up -d (or, if you have an old version of docker-compose:) docker-compose up -d

2. Direct your browser to http://localhost.

3. The API is accessible at http://localhost:3000/api.

Developers should use the cli tools on the Docker Container to add NPM packages instead of using the host terminal or IDE.

In a Terminal:

1. docker exec -it gods-assembly-songbook_dev_1 bash

2. cd api or cd client, depending whether you want to add packages to the API or the UI.

3. Use yarn add [package_name] to add the package, or if working on /api, use whatever other commands are recommended by the documentation of Nest.

4. Commit the changes to your Github fork as you would normally do on the host machine, eg: via the IDE etc.

1. ./GasDevServer_Build.sh

2. Three binary executable files will be generated into the folder /GodsAssemblySongbook:

• gas-linux
• gas-win
• gas-macos

3. You need to then copy the entire folder ./GodsAssemblySongbook to the computer where you want to run the app.

🙏 want more? read /ROADMAP.md

©️ God's Assembly Songbook - free software for church worship - available at www.github.com