ProPresenter-PCO-Live-Auto-Control

What is this?

Planning Center Services has a feature called "Live". This feature lets you click through the items in the plan and the production team can see where they are at in the service flow. If you use Planning Center Services Live then it will record the actual times on songs and items so next time you use them they will be accurate. Pro Presenter has the ability to display Planning Center Live, but you have to manually click next everytime you change songs or slides. This is tedious.

This script watches ProPresenter and automatically advances Planning Center Live status when the item is changed in ProPresenter.

Demo Video

Download

• The latest binary download is always here

• You can see the changelog here

• Or you can build and run with your locally installed python:

  curl -O https://raw.githubusercontent.com/pastorhudson/ProPresenter-PCO-Live-Auto-Control/main/src/PcoLive.sh && chmod +x PcoLive.sh && ./PcoLive.sh -t

  Once you get "Success" then you can run PcoLive.sh with other command line options listed below.

Setup

• Go to https://api.planningcenteronline.com
• Create a Personal Access Token. You must have access to control Services Live in Planning Center Services for this to work
• Edit the config.ini

[app]
;Get your Planning Center application_id and secret at https://api.planningcenteronline.com/oauth/applications
application_id = pco_app_id
secret = pco_app_secret
;Default is localhost 127.0.0.1 this is for running the program on the same machine as ProPresenter
pro_presenter_ip = 127.0.0.1
pro_presenter_port = 50001

Quick Start

• Add your Planning Center API Keys to config.ini
• Enable Network under ProPresenter Preferences / Network. Note the Port Number and IP or use the defaults.
• Run PcoLive
• Select the service type
• Select the plan
• The program will sync Services Live according to the current ProPresenter item until you close it.

---

Command-Line Options

This utility provides several options for interacting with the PCO Live service. You can use these options to perform various operations like testing the utility, specifying a service type ID, or a plan ID.

Usage

PcoLive [options]

Options

• -t, --test
  Description: Enables the test mode.
  Behavior: Returns the string 'SUCCESS' and exits.
  Example: python main.py --test

• -s, --service_type_id SERVICE_TYPE_ID
  Description: Specifies the service type ID.
  Details: The service type ID is used to identify a specific type of service in the PCO Live system. If you use service type ID without specifying plan ID you will be prompted to choose a plan from a list. Example: python main.py --service_type_id 12345

• -p, --plan_id PLAN_ID
  Description: Specifies the plan ID.
  Details: The plan ID is used to identify a specific plan within a service type in the PCO Live system. You must specify a service type ID if you are specifying a plan ID. Example: python main.py --service_type_id 12345 --plan_id 67890

Examples

1. Run in Test Mode (Verifies that the install is working):

   PcoLive --test

2. Run in Interactive Mode:

   PcoLive

3. Specify Only Service Type ID (with plan selection happening interactively):

   PcoLive --service_type_id 12345

4. Specify Both Service Type and Plan IDs:

   PcoLive --service_type_id 12345 --plan_id 67890

5. Auto Select Next Plan ID (a service type ID must be provided):

   PcoLive --service_type_id 12345 --plan_id next

Notes

• If no arguments are provided, the utility will prompt for service type and plan selections interactively.
• In case of any issues with Planning Center API keys, ensure they are correctly set in the config.ini.
• This program is free. Use at your own risk.
• This program assumes you have some technical ability to configure and run a command line program.

---

About Me

I'm a pastor in south-west PA who likes to build stuff. I run a website called https://pcochef.com full of "recipes for doing ministry" with Planning Center.