refer to the github repo for progress

PP7+

C’est un client, une sur-couche logiciel pour ProPresenter 7 Il permet d’avoir des fonctionnalités en plus en utilisant l’api officielle de pp7. Parmi ces fonctionnalités il y a:

Installation de l’application

Voici un simple tuto pour installer l’application et la lancer sur votre machine. Le Tuto est valable uniquement pour MacOS et linux, pour un tuto sur un autre OS, demandez le moi par mail.

  1. Ouvrez un terminal et tapez cette commande pour récupérer l’application sur github:
    cd && git clone https://github.com/paolo944/pp7p.git
  2. Une fois téléchargé, allez dans le dossier de l’application avec la commande suivante:
    cd pp7p
  3. Allez dans les paramètres de l’application ProPresenter dans la rubrique réseaux/network
    Activez l'option TCP/IP tout en bas et l'option network tout en haut, une adresse ip apparaîtra en haut et vous pouvez choisir un numéro de port tout en bas sous l'option TCP/IP.
    Choissisez un numéro de port entre 40000 et 65000 pour éviter d'avoir des erreurs.
    Notez l'adresse ip, qui est de la forme: 192.168.0.0 et le port que vous avez choisi sous l'option TCP/IP. utilisez la commande suivante dans votre terminal pour créer le fichier de configuration:
    touch info.json
  4. Ouvrez ce fichier avec un éditeur de texte normal et remplissez le comme-ceci: {"host": "{adresse ip}","port": "{port}"} Notez bien les guillements qui sont importants et remplacez {adresse ip} par celle qui vous avez noté
    et {port} par celui que vous avez noté.
  5. Vous pouvez lancer la configuration de l’application avec la commande: bash config.sh A présent l’application se lancera automatiquement à chaque démarrage de la machine donc pas besoin de lancer ou de se soucier d’elle.

Utilisation

Il vous faut d’abord vous munir de l’adresse qui apparaîtra dans le terminal au moment du lancement de l’application, par exemple:

 * Running on http://127.0.0.1:5000
         * Running on http://10.192.8.80:5000

Il faut pas utiliser l’adresse commençant par 127 mais l’autre. La première adresse est locale, elle peut-être utilisé uniquement si vous êtes sur la même machine que celle sur laquelle vous avez lancé l’application.

Voici les adresses qui vont sont accessibles: - {adresse}/ - {adresse}/subtitles - {adresse}/prompt

Où {adresse} est l’adresse que vous avez trouvé plus haut. Dans l’exemple, les adresses seraient: - http://10.192.8.80:5000/ - http://10.192.8.80:5000/subtitles - http://10.192.8.80:5000/prompt

La page principale contient:

La page subtitles cotient les sous-titres actuels avec un format spécifique à Hillsong Paris, de façon à sauter une ligne sur deux. Il y a également 2 formats différents en fonction de si c’est pour une slide de louange ou de verset.

La page prompt contient un prompteur.

Bug report

Si vous rencontrez un bug ou quelconque souci, vous pouvez me contacter sur mon adresse mail: paul@mekhail.dev.

A venir prochainement

Gestion de comptes pour éviter à des extérieurs de pouvoir utiliser l'application principale.

For Others

Web client for ProPresenter

Web client for ProPresenter 7 with important informations like clock and Stage live messages.

To run the web app, the server (this app) must be running on the same network as the ProPresenter app. The server is not required to be on the same machin as the ProPresenter app.

⚠️ IMPORTANT: PLEASE READ CAREFULLY ⚠️

This app is still under developpement and can very likely crash. Please don’t use it in critical situations. Only in training and just for testing for now. If you have any question ou improvemnts, feel free to sumbit an issue on github or a pull request and i will to try to answer fastly or review your pull requests.

Requirements

Installation

Open a terminal and run the following commands

git clone https://github.com/paolo944/pp7_client.git
        cd pp7_client
        pip3 install -r requirements.txt

Configuration

You have to first enable network on ProPresenter by going into Settings->Network then Enable Network. The ip adress should appear should under. Write down also the port number of the ProPresenter app. Make sure that your machine is visible on your local network, so that other clients like your phone or the server if it’s not on the same machine as the ProPresenter app could communicate with it’s API.

After you have written down the ip adress and made sure the ProPresenter computer is visible on the local network, go in the file pp7_client/info.json and add this line

{
            "host": "{adresse ip}",
            "port": "{port}"
        }

Replace {ip adress} by the ip adress of the machine on which ProPresenter is running and {port} by the port number of ProPresenter.

If the server runs on the same machien as the ProPresenter app, just replace {ip adress} by 127.0.0.1 .

Running the app

To run the app, launch the script app.py.

On Mac-GNU/Linux:

# Make sure to be located in the project directory
        python3 app.py

On Windows PowerShell:

python app.py

A url wil appear in the terminal, go to it on any client which is on the same network to get the main client.

If you want the subtitles page which updates automaticly, go to the url/subtitles .

The subtitles are well suited for OBS if you create a scene using a web brower.

⚠️ DISCLAIMER ⚠️

The subtitles format is suited for my church’s specific formats, so will very probably have to adapt it to your format.

Older test versions

You can also look at other versions that I tried making

PP7P C version is a version completely written in C without any dependencies other than POSIX. It was meant to be fast and light. I abandonned this version because it took too much time to develop and was a little unecessary. It would be useful if you want to run it on something like raspberry pi pico, eventhough you would need to adapt it to the raspberry’s lib It works well but lacks some functionnalities like SSE management.

PP7 Client v1 It was the first version and is very similar to this one, but it uses http to communicate with the propresenter api instead of just tcp/ip and doesn’t manage SSE clients as good as this one.

Bug report

If there’s any issue, you can open an issue on github.
If needed, my email adress if: paul@mekhail.dev.