- Python 3 installed on server (tested with python 3.11.6)
- Server, control computer/tablet, and ProPresenter must be on the same local network to avoid CORS issues in browser
- Classroom pager may be allowed access from any origin
- Make a new message in propresenter called
parent-pagerthat uses the fieldschild#androom - Make sure ProPresenter has network enabled and take note of the ip and port
- Create a new text file called
.envand add any of the following values:
# Rooms Configuration (comma separated)
ROOMS = "Room1,Room2,Room3"
# Minutes until a page should should be ignored
PAGE_TIMEOUT = "90"
# SSL/TLS Configuration
USESSLTLS = "false"
SSLCERT = "cert.pem"
SSLKEY = "key.pem"
# Server Configuration
# Server IP Address; use 0.0.0.0 for all connected interfaces
# Change port to 443 if using SSL/TLS
SERVERHOST = "0.0.0.0"
SERVERPORT = "80"
# Log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
LOG_LEVEL = "INFO"
#Pager blacklist (child numbers that should not be allowed to be sent)
BLACKLIST = "XXX,YYY,ZZZ"
# Message to return when an invalid child number is submitted
INVALIDCHILDNUMBER_MSG = "Invalid child number. Must be a 3 letters/numbers."
- Save the file in the ProPrePager project directory
- Put your
header_logo.png,footer_logo.png, andfavicon.icofiles in/html - By default, the server will validate child numbers to make sure they are exactly 3 digits and numbers only, if you have different requirements you will need to change the checks in
validChildNumber(c)at the top ofpager.pyas well as theINVALIDCHILDNUMBER_MSGerror message to match
- Start the server with
python3 pager.py
- To Build and start the container run
docker-compose up -d - Run
docker psto find your container and which ports you will use to connect to it - Docker settings can be changed in the
docker-compose.yml
- Open a web browser and navigate to the address of your server
- Select the room the child is in
- Type or scan the child's tag number
- Hit Submit
Currently all parent page requests are moderated manually from the /control webpage
- Make sure the ip address and port to the computer running ProPresenter is correct
- A green bar will indicate the webpage can communicate with ProPresenter
- When a page is queued, an alert sound will play
- Hit the
Sendbutton on the row with the number you wish to display
Open the /viewer webpage on your presentation PC or Mac and leave it in a place that the edge of the page is visible on a second monitor or behind your presentation software.
When a page is submitted, the screen will flash with a green border until the page is resolved (copied or cancelled):
- Click the Copy Page icon in the page list to copy the request to your computer's clipboard
- Paste the information into your presentation software (scrolling message, stage message, etc)
- The copied pages are in this format:
123 Room Name 1 456 Room Name 2....
- The copied pages are in this format: