On your own server (recommended)
Running WorshipDeck on a server or computer on your church network is the main way to use it. The operator console, the congregation screen, and the phone remote then open in a browser. You need Go 1.24 or later and Node.js 22.12 or later.
-
Get the code
Clone the repository, then run
npm installin it. -
Set it up
npm run setupcreates.envwith fresh secrets, creates the database with the SDAH hymnal and the KJV Bible and no layouts, and prints the admin password it generated. Running it again is safe: it never overwrites an existing.envor database. -
Start it
npm run spa:buildand thennpm startserve everything from port3000. Open that address in a browser and sign in asadmin.
git clone https://github.com/wiradeltaid/worship-deck.git cd worship-deck npm install npm run setup npm run spa:build npm start
.env unique to your installation and out of any repository, and back up the database and the uploads folder. The security page lists what to check.
To work on the code instead, npm run dev runs the Go API on port 3000 and the React development server on port 5173.
Windows desktop installer (experimental)
Use the installer on a church media computer running Windows 10 or Windows 11 (64-bit).
-
Download the installer
Download
WorshipDeck-0.1.2-x64-setup.exefrom the GitHub releases page. -
Run the installer
The installer is in English and Indonesian and follows the Windows display language, and it shows the MIT license text before installing. WorshipDeck installs into your user profile and keeps application data in
%LocalAppData%\WorshipDeck, so you do not need administrator rights. -
Open WorshipDeck
WorshipDeck opens as its own desktop window, with its own taskbar entry and icon, not a browser tab. On first launch, it creates its local SQLite database and loads the Seventh-day Adventist Hymnal (695 hymns) and the King James Version. Both are in English. It starts with no layouts: build them on the canvas or import slides from PowerPoint.
data.db), your layouts, and your uploaded announcement flyers are kept. On uninstall, WorshipDeck asks whether to also delete your locally stored data folder; the default answer is No, so your data is kept unless you choose to delete it. Your first service
This walkthrough takes about 10 minutes. Do it before the service day to check your computer and projector setup.
-
Create a service
Open WorshipDeck and go to Services → New.
-
Paste the order of service
Paste the service text into the intake box. For example:
SABBATH, OCTOBER 10, 2026 Opening Song: SDAH #159 The Old Rugged Cross Verse Reading: John 3:16-17 Sermon: Pr. Arthur Pendelton "Steady Light" Closing Song: SDAH #249 Praise Him! Praise Him!
-
Generate the slides
Click Parse. The parser looks up the hymn numbers in the local hymnal and builds the slide plan. Any line it does not recognize stays visible for you to review.
-
Open the operator console
Click Present. The operator console opens on your main screen.
-
Open the congregation screen
In the top bar of the operator console, click Project to and select your display (e.g. Open on external screen or Open as window). If opening as a window, drag it to the second screen or projector and press F11 to make it full screen without borders.
-
Test the controls
Press Space to move to the next slide, and press B to check that the screen blanks.
What you should see
When everything is set up:
- The operator screen shows the dark console with the current slide, the next slide, and the order of service.
- The congregation screen shows the slide text centered on a 16:9 canvas, with no window borders or buttons.
- Pressing B turns the congregation screen black, and the operator console keeps your current slide highlighted.
Frequently Asked Questions
Does WorshipDeck require an internet connection during services?
No. WorshipDeck is local-first. Slide plans, the 695-hymn SDAH corpus, the 31,102-verse KJV Bible, and presentation windows run entirely on your local machine and offline network without external cloud calls.
How do I project to a second screen without window borders?
Click Project to in the console header and select your external sanctuary monitor. In Chrome or Edge, the Window Management API launches a borderless 16:9 window directly on that screen. If opened as a standard window, drag it over and press F11.
Where are my database and uploaded flyers stored?
All database records are stored in data.db next to the server (or in %LocalAppData%\WorshipDeck\data.db on desktop). Media assets and flyers live in the uploads/ directory. See the Data, Backup & Sync guide for details.
Can I import existing PowerPoint slides?
Yes. You can import slides from an existing .pptx file into the canvas editor, or export your complete WorshipDeck slide plan to an offline PowerPoint presentation with fonts embedded under ECMA-376 standards.