Documenting RenewedVision's undocumented network protocols with examples
This document refers to ProPresenter 6.
Both the Remote Control and the Stage Display protocols are unencrypted text-based websocket connections from the client to the ProPresenter instance.
Note, if both the Remote Control and the Stage Display interface are enabled in ProPresenter, they both operate over the Remote Control network port.
ws://[host]:[port]/remote
COMMAND TO SEND:
{"action":"authenticate","protocol":"600","password":"control"}
EXPECTED RESPONSE:
{"controller":1,"authenticated":1,"error":"","action":"authenticate"}
COMMAND TO SEND:
{"action":"libraryRequest"}
EXPECTED RESPONSE:
{
"library": [
"/Path/To/ProPresenter/Library/Come Alive (Dry Bones).pro6",
"/Path/To/ProPresenter/Library/Pour Out My Heart.pro6",
"/Path/To/ProPresenter/Library/Away in a manger.pro6",
"... ALL PRESENTATIONS IN THE LIBRARY ..."
],
"action": "libraryRequest"
}
COMMAND TO SEND:
{"action":"playlistRequestAll"}
EXPECTED RESPONSE:
This request returns all playlists according to the following format.
{
"playlistAll": [
{
"playlistLocation": "1",
"playlistType": "playlistTypePlaylist",
"playlistName": "Testing",
"playlist": [
{
"playlistItemName": "Song 1 Title",
"playlistItemLocation": "1:0",
"playlistItemType": "playlistItemTypePresentation"
},
{
"playlistItemName": "Song 2 Title",
"playlistItemLocation": "1:1",
"playlistItemType": "playlistItemTypePresentation"
}
]
},
"action": "playlistRequestAll"
}
COMMAND TO SEND:
{
"action": "presentationRequest",
"presentationPath": "/Path/To/ProPresenter/Library/Song 1 Title.pro6",
"presentationSlideQuality": 25
}
presentationPath
is required but need not be the full path of the presentation. Specifying the filename (eg.Song 1 Title.pro6
) is good enough.presentationSlideQuality
is optional. It determines the resolution / size of the slide previews sent from ProPresenter. If left blank, high quality previews will be sent. If set to0
previews will not be generated at all. A good compromise is25
.
EXPECTED RESPONSE:
{
"action": "presentationCurrent",
"presentation": {
"presentationSlideGroups": [
{
"groupName": "[SLIDE GROUP NAME]",
"groupColor": "0 0 0 1", // RGBA scale is from 0-1
"groupSlides": [
{
"slideEnabled": true,
"slideNotes": "",
"slideAttachmentMask": 0,
"slideText": "[SLIDE TEXT HERE]",
"slideImage": "[BASE64 ENCODED IMAGE]",
"slideIndex": "0",
"slideTransitionType": -1,
"slideLabel": "[SLIDE LABEL]",
"slideColor": "0 0 0 1"
}
]
},
],
"presentationName": "[PRESENTATION TITLE]",
"presentationHasTimeline": 0,
"presentationCurrentLocation": "[PRESENTATION PATH]"
}
}
- NOTE: the response contains
presentationCurrent
as the action instead ofpresentationRequest
. This seems to be a bug in the ProPresenter response.
COMMAND TO SEND:
{
"action":"presentationCurrent",
"presentationSlideQuality": 25
}
EXPECTED RESPONSE:
Same response as requestPresentation
- NOTE: This action only works if there is an active slide. When ProPresenter starts, no slide is marked active, so this action returns nothing until a slide has been triggered.
COMMAND TO SEND:
{"action":"presentationSlideIndex"}
EXPECTED RESPONSE:
{"action":"presentationSlideIndex","slideIndex":"0"}
COMMAND TO SEND:
{"action":"presentationTriggerIndex","slideIndex":3,"presentationPath":"[PRESENTATION PATH]"}
EXPECTED RESPONSE:
{"slideIndex":3,"action":"presentationTriggerIndex","presentationPath":"[PRESENTATION PATH]"}
ws://[host]:[port]/stagedisplay
COMMAND TO SEND:
{"pwd":PASSWORD,"ptl":610,"acn":"ath"}
EXPECTED RESPONSE:
{"acn":"ath","ath":true,"err":""}
EXPECTED RESPONSE:
{"acn":"sys","txt":" 11:17 AM"}
EXPECTED RESPONSE:
{
"acn": "fv",
"ary": [
{
"acn": "cs", # CURRENT SLIDE
"uid": "[SLIDE UID]",
"txt": "[SLIDE TEXT]"
},
{
"acn": "ns", # NEXT SLIDE
"uid": "[SLIDE UID]",
"txt": "[SLIDE TEXT]"
},
{
"acn": "csn", # CURRENT SLIDE NOTES
"txt": "[SLIDE NOTES]"
},
{
"acn": "nsn", # NEXT SLIDE NOTES
"txt": "[SLIDE NOTES]"
}
]
}