Connect Your Systems to Your Screens

Display your order of service, stage plots, and stage layouts on backstage and green room screens. DisplayCache automatically selects the next upcoming service plan from Planning Center Services, so your screens always show the right plan without manual switching.

Connecting Planning Center

1. Go to Integrations in the DisplayCache web admin and click Planning Center.
2. Open api.planningcenteronline.com/oauth/applications in a new tab and create a new Personal Access Token.
3. Copy the App ID and Secret from Planning Center.
4. Paste them into the connection form in DisplayCache and click Connect.
5. DisplayCache will test the connection automatically. If successful, you will see a "Connected" badge and your service types will load.

Creating a Display

1. Once connected, click Add Display.
2. Choose a Display Type:
   • Order of Service — the full service plan with items, sequences, and durations.
   • Stage Plot — team member positions with photos and roles.
   • Stage Layout — a simplified stage view.
3. Select a Service Type from the dropdown (e.g., "Sunday Morning", "Wednesday Night"). DisplayCache automatically picks the next upcoming plan for that service type.
4. Click Sync to generate the display content.
5. Add the synced content item to a playlist or assign it directly to a device.

Configuration Options

Option	Values	Description
Layout	Single Column, Two Columns, Three Columns	How the order of service items are arranged on screen. Two and three column layouts show more items at once.
Scroll Speed	Slow, Medium, Fast	How quickly the display auto-scrolls through items.
Show Sequences	On / Off	When enabled, sequence groupings (Pre-Service, Worship, Message, etc.) are shown as section headers.
Show Durations	On / Off	When enabled, the planned duration for each item is displayed.
Show Photos	On / Off	For stage plot displays, shows team member profile photos.

How Content Appears on Displays

The order of service renders natively on screen with your service type name as the heading, the service date, and each item listed with its title, description, and optional duration. Stage plots show team members arranged with their names, roles, and photos. The content refreshes automatically every few minutes to pick up last-minute changes.

Display birthdays, events, milestones, volunteer schedules, and custom data from your TouchPoint church management system. Data is rendered natively on screen with photos, badges, and rich formatting.

Connecting TouchPoint

1. Go to Integrations → TouchPoint in the DisplayCache web admin.
2. Enter your TouchPoint Base URL (the address you use to log in, e.g., https://mychurch.tpsdb.com).
3. Choose your authentication method:
   • Personal Access Token (recommended) — create one in TouchPoint under Admin > My Data > User Access Tokens. Enter your TouchPoint username and the PAT token.
   • Username & Password — your standard TouchPoint login credentials.
4. Click Connect TouchPoint.
5. Use Test Connection to verify everything is working.

Setting Up the Loader Script (for Birthdays, Events, Milestones, Volunteers)

For built-in display types, DisplayCache uses a loader script installed in TouchPoint that automatically fetches the latest data scripts.

1. In TouchPoint, go to Admin > Special Content > Python.
2. Create a new script named exactly DisplayCacheLoader.
3. Copy the loader script from the DisplayCache integration page and paste it into TouchPoint.
4. Save the script in TouchPoint.
5. Back in DisplayCache, click Test Connection to verify the loader is detected.

Available Display Types

Creating a Display Output

1. Click + Add Display in the TouchPoint integration page.
2. Choose a Type (Birthdays, Events, Milestones, Volunteers, or Custom).
3. Configure type-specific settings (see table below).
4. Choose a Display Format, Size, and Layout.
5. Click Sync to generate the content item.
6. Add the content item to a playlist or assign it to a device.

Type-Specific Settings

Type	Settings
Birthdays	Days ahead (7, 14, 30), filter by involvement ID or saved search name, opt-out extra value field, show profile pictures, show age.
Events	Days ahead (7, 14, 30, 60), location filter (comma-separated room names), max events.
Milestones	Days ahead (7, 14, 30, 60), filter by involvement ID or saved search, milestone types (birthdays, wedding anniversaries, baptism anniversaries, membership anniversaries, custom date), custom date field name, opt-out field, show photos, show age on birthdays.
Volunteers	Involvement ID (the volunteer involvement to pull from), days ahead (7, 14, 30), show empty slots, show profile pictures.
Custom	Script name (your custom Python script in TouchPoint), display title, custom parameters, column detection. Use "Detect Columns" to auto-detect the data structure from your script output.

Display Formats

For Birthdays, Events, Milestones, and Custom:

Events also supports:

Volunteers has specialized formats:

All display types also support Size (Small, Medium, Large) and Layout (Single Column, Two Columns, Three Columns) configuration.

Display room schedules and upcoming event listings from your eSPACE facility management system. Mount a screen outside a room to show availability, or display all upcoming events in the lobby.

Connecting eSPACE

1. Go to Integrations → eSPACE in the DisplayCache web admin.
2. Enter the eSPACE API URL (usually https://app.espace.cool).
3. Enter your Organization Key from eSPACE Settings > API Settings.
4. Select your Event Timezone (Eastern, Central, Mountain, Pacific, etc.).
5. Click Connect eSPACE.
6. Use Test Connection to verify the connection is working.

Creating a Display Output

1. Click + Add Display.
2. Give the display a name (e.g., "Lobby Events" or "Room 201 Schedule").
3. Choose a Display Format:
   • Event List — a scrolling list of upcoming events with times and locations. Best for lobby screens.
   • Room Schedule — a single-room sign showing current availability, the current event, and upcoming events. Mount outside a room.
4. Configure Rooms:
   • All Rooms — shows events from every location, including rooms added in the future.
   • Specific Rooms — select individual rooms from the list. Best for room schedule displays.
5. Set the Time Period (today only, next 7 days, next 14 days, etc.) and Max Events.
6. Click Sync to generate the content item.

Configuration Options

Option	Values	Description
Display Format	Event List, Room Schedule	Event List scrolls through events. Room Schedule shows a focused single-room view.
Rooms	All Rooms or Specific Rooms	Filter events by location. "All Rooms" automatically includes future new rooms.
Time Period	Today only through Next 90 days	How far ahead to look for events.
Max Events	1–200	Maximum number of events to display.
Scroll Speed	Slow, Medium, Fast	Auto-scroll speed for Event List format.
Public Events Only	On / Off	When enabled, only public events are shown. Private events are hidden.
Size (Room Schedule)	Small, Medium, Large	Text size for room schedule displays. Large is readable from a distance.
Layout (Room Schedule)	Single Column, Two Columns	How events are arranged on room schedule displays.

How Content Appears on Displays

Event List: A scrolling list showing event name, room, start time, and end time, grouped by date. Auto-scrolls at the configured speed.

Room Schedule: Shows the room name prominently, whether it is currently available or occupied, the current event (if any), and upcoming events for that room. Ideal for mounting on a wall outside a meeting room.

Automate your live streaming workflow. When a broadcast goes live on BoxCast, assigned screens switch to the stream automatically. When it ends, they switch back to their regular content. Add countdown timers, configure multiple stream sources, and control show-before/show-after timing.

Connecting BoxCast

1. Go to Integrations → BoxCast in the DisplayCache web admin.
2. Enter your BoxCast Client ID and Client Secret. These are available in your BoxCast account settings under API access.
3. Click Connect.
4. Once connected, you can browse your channels and broadcasts, and import recorded broadcasts as content items.

Setting Up a Stream Hub

The Stream Hub is configured on a per-schedule basis, not in the BoxCast integration page. This is how you tell specific devices to switch to a live stream when a broadcast starts.

1. Go to Schedules in the web admin.
2. Create a new schedule or edit an existing one.
3. Add a schedule entry and set the Display Mode to Kiosk.
4. In the stream hub configuration, add one or more Stream Sources:
   • BoxCast — select a BoxCast channel. DisplayCache monitors it for live, upcoming, and recent broadcasts.
   • YouTube Live — paste a YouTube Live URL or channel.
   • Vimeo — paste a Vimeo Live URL.
   • HLS — paste any HLS (.m3u8) stream URL.
5. Configure timing:
   • Show Before (hours) — how many hours before a scheduled broadcast to switch the screen. A countdown timer displays until the broadcast starts.
   • Recent Hours — how long after a broadcast ends to keep showing it (the "show after" window), before switching back to regular content.
   • Show Countdown — toggle the countdown timer on or off.
6. Assign the schedule to the devices that should show the stream.

How It Works During a Broadcast

State	What the Screen Shows
Before broadcast	If within the "show before" window, the screen switches to the stream hub and shows a countdown timer with days, hours, and minutes until the broadcast starts.
Live	The screen shows the live stream in full screen. The switch happens automatically when BoxCast reports the broadcast is live.
Just ended	If within the "recent hours" window, the stream stays on screen so latecomers can catch the end or so the post-service message is visible.
No broadcast	The screen returns to its regular schedule and playlist content.

Importing Recorded Broadcasts

In the BoxCast integration page, browse channels and past broadcasts. Click Add as Content on any recorded broadcast to import it into your content library. You can then add it to playlists like any other content item.

Sync files from OneDrive personal folders, SharePoint document libraries, or Microsoft Teams channel files directly to your content library. PowerPoint, Word, and Excel files are automatically converted to images for display.

Connecting OneDrive

1. Go to Integrations → OneDrive in the DisplayCache web admin.
2. Click Connect OneDrive.
3. You will be redirected to Microsoft to sign in and authorize DisplayCache with read-only access to your files.
4. After authorization, you are redirected back to DisplayCache. A folder browser opens automatically.

Syncing a OneDrive Folder

1. Click + OneDrive Folder to open the folder browser.
2. Navigate through your OneDrive folders. You will see folder names and a preview of supported files in each folder.
3. When you find the folder you want, click Select "[folder name]".
4. The folder is added as a sync configuration. Give it a display name.
5. Choose a Sort Order (Name A-Z, Name Z-A, Newest first, Oldest first).
6. Click Sync Now to import the files into your content library.

Syncing SharePoint / Teams Files

1. Click + SharePoint / Teams to open the SharePoint browser.
2. Search for a SharePoint site by name. Teams channels store their files in SharePoint sites, so search for your team name.
3. Select a site, then choose a Document Library (e.g., "Documents", "Shared Documents").
4. Navigate to the folder you want and click Select.
5. Click Sync Now to import the files.

Configuration Options

Option	Description
Display Name	A friendly name for this sync (shown in your content library as a folder).
Sort Order	Name (A-Z), Name (Z-A), Newest first, or Oldest first. Determines which files are included when a folder has more than 200 files.

Auto-Conversion

PowerPoint (.pptx, .ppt), Word (.docx, .doc), and Excel (.xlsx, .xls) files are automatically converted to PDF and then to images for display. You do not need to export slides manually. Just drop the PowerPoint into the synced folder.

Sync Limits and Frequency

• Up to 200 files per synced folder.
• Maximum 10 MB per file.
• Sync is available on demand with a 15-minute cooldown between syncs.
• Supported file types: images (JPEG, PNG, WebP, GIF, SVG, HEIF), videos (MP4, MOV), PDFs, and Office documents.

How Content Appears on Displays

Synced files appear in your Content library under a folder named with the sync's display name (prefixed with the site name for SharePoint). Create a dynamic playlist pointing at the folder to automatically display all files, including newly synced ones.

Sync images, videos, and files from Google Drive folders to your content library. HEIC photos are automatically converted to JPEG.

Connecting Google Drive

1. Go to Integrations → Google Drive in the DisplayCache web admin.
2. Click Connect Google Drive.
3. You will be redirected to Google to sign in and authorize DisplayCache with read-only access to browse and download files.
4. After authorization, you are redirected back to DisplayCache. The folder browser opens automatically.

Syncing a Folder

1. Click + Add Folder to open the folder browser.
2. Navigate through your Google Drive. You will see folders and a preview of supported files.
3. Select the target folder by clicking Select "[folder name]".
4. Give the sync a display name and choose a Sort Order.
5. Click Sync Now to import the files.

Configuration Options

Option	Description
Display Name	A friendly name for this sync (shown in your content library as a folder).
Sort Order	Name (A-Z), Name (Z-A), Newest first, or Oldest first.

Sync Limits and Frequency

• Up to 200 files per synced folder.
• Maximum 10 MB per file.
• Sync is available on demand with a 15-minute cooldown between syncs.
• Supported file types: images (JPEG, PNG, WebP, GIF, SVG, HEIF/HEIC), videos (MP4, MOV), and PDFs.
• HEIC photos (common from iPhones) are automatically converted to JPEG.

How Content Appears on Displays

Synced files appear in your Content library under a [Google Drive] folder. Create a dynamic playlist pointing at the folder to auto-display new files as they are synced.

Import designs directly from your Canva account into the DisplayCache content library. Import as PNG (static image) or MP4 (animated video). Each user connects their own Canva account.

Enabling Canva for Your Organization

1. An admin goes to Integrations in the web admin.
2. On the Canva card, click Enable. This allows all users in the organization to connect their Canva accounts.

Connecting Your Canva Account

1. Go to Integrations → Canva.
2. Click Connect with Canva.
3. You will be redirected to Canva to authorize DisplayCache.
4. After authorization, your designs are loaded automatically.

Importing Designs

1. Browse your Canva designs in the grid view. Each design shows a thumbnail, title, and page count.
2. Click designs to select them (or use Select All).
3. Choose the export format:
   • PNG (static) — best for still images and slides.
   • MP4 (animated) — best for designs with animations or transitions.
4. Click Import. The selected designs are exported from Canva and added to your content library.

How Content Appears on Displays

Imported designs appear in your Content library like any other uploaded file. Add them to playlists, set display durations, and assign to devices. Multi-page designs import all pages as separate content items.

Display current weather conditions on Smart Display widgets. Weather data comes from OpenWeatherMap and refreshes every 15 minutes.

Getting an API Key

1. Go to openweathermap.org and create a free account.
2. Navigate to your API keys page and copy your key.
3. Note: New API keys can take up to 2 hours to activate after creation. If you get an authentication error, wait and try again.

Connecting Weather

1. Go to Integrations → Weather in the DisplayCache web admin.
2. Enter your API Key.
3. Enter the Latitude and Longitude of your location. You can:
   • Click Use My Location to auto-detect your browser's location.
   • Look up coordinates at latlong.net or Google Maps (right-click a location).
4. Click Connect. DisplayCache will test the API key before saving.

Using Weather on Displays

Weather data is available as a widget in Smart Displays. It does not create a standalone content item.

1. Go to Content → New Smart Display.
2. Add a Weather widget to the layout.
3. Position and size the widget wherever you want on the screen.
4. The widget shows current conditions (temperature, description, weather icon) for your configured location.
5. Data refreshes every 15 minutes automatically.

What Data Is Shown

• Current temperature in Fahrenheit
• Weather condition (sunny, cloudy, rain, snow, etc.)
• Weather icon matching the current conditions