SimpleCast User Guide

1. Introduction

Welcome to the SimpleCast documentation. SimpleCast is an intuitive and powerful live projection app designed to seamlessly display dynamic content in real time. Perfect for events, presentations, and performances, this application enables you to instantly synchronize multiple displays with ease.

Features & Release Notes

To see the full list of SimpleCast features and our version release history, please visit the Features & Changelog page.

2. Managing Content (Registration, Login & Assets)

Register and Login

To begin using SimpleCast, you must create a user account:

1. Navigate to the homepage and click on the Register button.
2. Fill in your credentials (Name, Email, Password) and submit the form.
3. Once registered, use the Login page to access your dashboard.

How to Add Songs

1. From the dashboard, go to the Songs section.
2. Click Add New Song.
3. Enter the song title, artist, and paste the lyrics.
4. Save the song. It is now available to be added to any schedule.

How to Add Schedules

Schedules help you organize content for a specific event or service:

1. Navigate to the Schedules tab.
2. Click Create Schedule and give it a date and a recognizable name (e.g., "Sunday Morning Service").
3. Click into the schedule to add songs, bible verses, and media items in the exact order you need them to be projected.

How to Add Media

1. Go to the Media section in your dashboard.
2. Upload your images, videos, or audio files.
3. These media files can now be projected directly or queued up in your schedules.

3. How to Go Live and Start Projecting

When you are ready for your event, projecting your content is easy and seamless:

1. Open your Dashboard or Workspace.
2. Click the Go Live or Open Projector button. This will open a new window or tab.
3. Drag this new projector window to your extended display (such as your church screen, TV monitor, or projector).
4. Make sure the projector window is set to full-screen mode.
5. On your main control screen, click on any song stanza, bible verse, or media item. The projector window will instantly update to show your active selection.

4. How to Use the Remote

The remote feature allows you to control the main presentation from a smartphone or tablet wirelessly:

1. Ensure your main computer is logged in and the projector window is actively projecting.
2. On your mobile device, log in to SimpleCast and navigate to the Remote section.
3. Select the active schedule or presentation.
4. Tap on the items (Next/Previous slide, specific lyrics, or verses) directly on your mobile screen.
5. The changes will be instantly reflected on the main projector screen via WebSockets/polling.

5. Keyboard Shortcuts

Navigate and control SimpleCast like a pro using these quick keyboard shortcuts natively inside the control dashboard:

Shortcut	Action
V + # + Enter	Jump to specific Verse (e.g., V3 + Enter for Verse 3)
C + # + Enter	Jump to specific Chorus (e.g., C1 + Enter for Chorus 1)
B + # + Enter	Jump to specific Bridge (e.g., B1 + Enter for Bridge 1)
# + Enter	Jump to specific line number (e.g., 9 + Enter for Line 9)
↑ / ↓	Move line selection block Up/Down
← / →	Navigate to Previous/Next song section
Ctrl/Cmd + C	Clear live output
Ctrl/Cmd + B	Black out (Blank Screen)
Ctrl/Cmd + Click	Select multiple Bible verses into a single slide view

6. Offline Mode

SimpleCast can be run completely offline, ensuring total reliability during your services even without internet access.

• Download Offline Package: Go to settings and download the self-contained offline bundle.
• Start the Python Server: Extract the package and run the included start_server.py or execute python3 -m http.server 8000 in the folder.
• Access Locally: Open your browser and navigate to http://localhost:8000.
• Data Sync: You can export your schedules from the cloud version (as a JSON file) and import them directly into your offline instance via the dashboard settings.

7. Token System & Economy

SimpleCast uses a pay-as-you-go Token economy. Instead of monthly subscriptions, you spend tokens only when necessary.

• Go Live: Initiating a live session deducts 30 tokens, granting a 24-hour projection pass. You get a 15-minute free look daily.
• Managing Library: Adding custom songs costs 5 tokens and creating new schedules costs 10 tokens. Adding a song to a schedule costs 3 tokens.
• Global Shared Library: Using community songs costs only 1 token, and creators earn a royalty of 2 tokens!
• Media Uploads: Adding pictures and videos uses 30 tokens.
• Wallet: You can track your usage and top up your tokens anytime from the Wallets section in the dashboard.

Read the full Token Guide

8. Install App (PWA)

SimpleCast is a Progressive Web App (PWA). You can install it on your device for quick access, offline caching, and a native app-like experience.

• Desktop (Chrome/Edge): Look for the "Install" icon in your browser's address bar or find "Install SimpleCast" in the browser menu.
• Mobile (iOS/Android): Tap the share button (iOS) or browser menu (Android) and select "Add to Home Screen".
• Benefits: Instantly launch the app, utilize cached files to save data, and enjoy a cleaner, full-screen interface.