CHURCH COUNTDOWN TIMER — USER GUIDE
Version: Pro / Free
Website: https://churchapp.ng
Support: support@churchapp.ng
Author: Chenzo David

============================================================
1) WHAT THIS SOFTWARE DOES
============================================================
Church Countdown Timer is a desktop app designed for church services, events, and live streams.

It gives you:
- A CONTROL screen (where you set the time and control the timer)
- An OUTPUT screen (what you show on a projector/TV/LED screen)
- Optional BROWSER OUTPUT link (for OBS / vMix Browser Source)
- Optional PHONE CONTROL page (control the timer from your phone on the same Wi-Fi)

The software is built for a clean, stable timer experience during live services.

============================================================
2) HOW THE APP OPENS (CONTROL + OUTPUT)
============================================================
When you start the app, it opens:

(A) Control Window
- This is where you Start / Pause / Reset / Stop
- Set your timer minutes/seconds
- Choose Output Mode
- Save Profiles and Display Presets

(B) Output Window
- This is the screen you show to the congregation or livestream
- It can be fullscreen on your second monitor

TIP:
If you have multiple monitors, place the Output Window on the display you want and click:
"Launch Fullscreen Output"

============================================================
3) BASIC TIMER CONTROLS
============================================================
Buttons:
- Start: begins countdown
- Pause: pauses countdown
- Reset: returns to the starting time
- Stop: stops the timer at 00:00

Keyboard Shortcuts (on Control window):
- Space = Start / Pause
- R = Reset
- S = Stop
- F = Fullscreen Output
- X = Exit Fullscreen
- O = Show Output window
- H = Hide Output window

============================================================
4) SETTING THE TIMER TIME
============================================================
You can set time in 2 ways:

(A) Quick Time Buttons
- 5 Minutes
- 10 Minutes
- 15 Minutes
- 30 Minutes

(B) Custom Time
- Enter Minutes + Seconds
- Click "Apply Time"

After applying time, the Output screen updates automatically.

============================================================
5) OUTPUT MODES (SCENES)
============================================================
You can switch what the output shows using Output Modes:

- Timer: shows the live countdown
- Black Screen: output goes black (useful between scenes)
- Message Only: show only a message on screen
- Times Up: force display "TIMES UP"

============================================================
6) OUTPUT MESSAGE (OPTIONAL)
============================================================
You can enable a message on the output:
- Turn on "Show message on output screen"
- Type your message (example: “Service begins shortly”)

This message shows under or alongside the timer depending on theme.

============================================================
7) WARNING CUE (OPTIONAL)
============================================================
Warning cue highlights the timer at the final seconds.

Example:
- Start warning at 10 seconds remaining

This is useful for production teams to prepare transitions.

============================================================
8) TIMES UP EFFECT + BEEP (OPTIONAL)
============================================================
When countdown reaches 00:00:
- TIMES UP can appear on screen (if enabled)
- Beep alert can play (if enabled)

TIMES UP stays visible until you Reset (depending on your settings).

============================================================
9) SAVED PROFILES (TIMER PROFILES)
============================================================
Profiles are saved timer presets (time only).

Example profiles:
- “Sunday Service Intro (10:00)”
- “Praise & Worship (20:00)”
- “Offering (05:00)”

How to use:
- Type a profile name
- Click “Save Current Timer”
- Click “Load” to use it anytime

============================================================
10) DISPLAY THEMES + BRANDING
============================================================
The Output Screen supports themes such as:
- Dark Glow
- Clean Light
- Church Gold
- Midnight Blue
- Emerald Stage
- Sunset Purple
- Minimal Contrast

Depending on your license plan, you may also get:
- Background image overlay
- Logo overlay
- Font selection
- Custom colors

============================================================
11) DISPLAY PRESETS (FULL VISUAL PRESETS)
============================================================
Display Presets save EVERYTHING about your display design:
- Theme
- Colors
- Font
- Background image
- Logo overlay

How to create:
- Enter preset name
- Click “Save Display Preset”
- Click “Apply” to load it anytime

Export/Import:
- Export Presets creates a JSON file you can share or backup
- Import Presets loads presets from JSON (merge or replace mode)

============================================================
12) OBS / vMix BROWSER OUTPUT (If Enabled)
============================================================
The app runs a local output server on your computer.
If browser output is enabled, you can open Output in a browser and use it in OBS/vMix.

Where to find the link:
- The app prints the URLs in the terminal / logs
- You can also see them from the app status tools (if included)

Typical local URLs:
- Output:  http://127.0.0.1:3579/output
- Phone Control: http://127.0.0.1:3579/control

LAN (Wi-Fi) URLs (example):
- Output: http://192.168.1.50:3579/output
- Control: http://192.168.1.50:3579/control

IMPORTANT:
Your phone must be on the same Wi-Fi network as the computer.

============================================================
13) PHONE CONTROL (If Enabled)
============================================================
Phone control allows you to control the timer from your phone browser.

Steps:
1) Make sure phone + computer are on same Wi-Fi
2) Open the control link in your phone browser:
   Example: http://192.168.1.50:3579/control
3) Use the buttons to start/pause/reset/stop

============================================================
14) LICENSE / ACTIVATION
============================================================
Free vs Pro:
- Some advanced features are locked for Pro
- Pro is activated using your email + license key

How to activate:
1) Open the app
2) Open the License page (inside the app)
3) Enter your email + license key
4) Click Activate

Once activated:
- The app unlocks Pro features
- License is cached locally for offline use (grace period may apply)

If you purchased online:
- You will receive your license key by email
- You can also retrieve it from the payment portal:
  https://churchapp.ng/licensing/pay/

============================================================
15) WHAT TO EXPECT DURING PAYMENT (CUSTOMERS)
============================================================
After payment:
- Status may show Pending for a short time
- Once verified, it becomes Paid
- License is generated automatically
- License key appears in the portal and is emailed to you

If it stays Pending:
- Click “Check Status” in the portal
- If needed, contact support with your Order Ref

============================================================
16) TROUBLESHOOTING
============================================================
Output window is on the wrong screen:
- Drag it to the correct monitor
- Click “Launch Fullscreen Output” again

Phone control not opening:
- Ensure both phone and PC are on same Wi-Fi
- Go to the app, on the side click network, it
shows you the urls on your right, copy the control url
and paste it on any browser..
- Scroll down, it will show you the Phone url link
to use on your mobile device...
- Use the LAN link (192.168.x.x) or the Second Port
- Make sure firewall allows local port 3579

OBS Browser Source not showing:
- Use the Output URL (not Control URL)
- Ensure the app is running
- On OBS, set width/height to match your scene

License not activating:
- Confirm email and license key match purchase
- Check internet connection for activation
- If still failing, contact support with Order Ref

============================================================
17) SUPPORT
============================================================
If you need help, send:
- Order Ref (example: CCT-20260304193817-XXXXXXX)
- Screenshot of your issue
- Your email used for purchase

Support Email: hello@churchapp.ng

============================================================
END OF GUIDE
============================================================