# Installation d'OBS Studio sur Zorin OS (ou Ubuntu)

#### Avant propos

OBS Studio est le logiciel libre utilisé par la ville pour diffuser le conseil municipal, et d’autres manifestations, en direct. Cette prodédure décrit l’installation du logiciel et des plugins nécessaires à son fonctionnement, dans l’environnement qui est le nôtre.

#### Prérequis

→ ZorinOS peut-être téléchargé [en cliquant sur ce lien](https://zorin.com/os/download/). Choisir la version Core.

### Installation d’OBS Studio

1. Cette procédure nécessite l’installation préalable de [Zorin OS Core](https://wiki-dsi.echirolles.fr/Proc%C3%A9dures/Bureautique/zorin-installation), dans sa dernière version (version 17 au jour de la rédaction).
2. Ajouter le PPA permettant l’installation de la dernière version d’OBS Studio :
    
    ```
    sudo add-apt-repository -y ppa:obsproject/obs-studio
    sudo apt update
    ```

Installer la dernière version d’OBS Studio :

```
sudo apt install obs-studio
```

<div class="toolbar" id="bkmrk-"></div><p class="callout warning">Attention : **n’installez pas le paquet obs-plugins**</p>

### Installation de NDI

NDI (ou NDI-HX) est un protocole temps réel qui permet de découvrir les caméras compatibles connectées **sur le même réseau**, de récupérer le flux vidéo et de l’intégrer simplement à OBS. L’avantage de NDI, par rapport aux protocoles vidéo standard (RTSP, par exemple) est qu’il permet d’obtenir un flux en temps réel, et donc de ne pas avoir de décalage entre l’audio et la vidéo.

L’installation se déroule en deux temps :

#### 1. Installation du runtime NDI (propriétaire)

La procédure d'installation se trouve [sur cette page](https://github.com/DistroAV/DistroAV/wiki/1.-Installation) (voir section : Required Components - NDI Runtime / Linux)

<div class="toolbar" id="bkmrk--1"></div><div class="toolbar" id="bkmrk--2"></div><div class="toolbar" id="bkmrk--3"></div>#### 2. Installation du plugin DistroAV (anciennement OBS-NDI)

1. Télécharger le paquet depuis [cette page Github](https://github.com/obs-ndi/obs-ndi/releases/) (à la date de rédaction de cette documentation, il s’agit du paquet **distroav-6.1.1-x86\_64-linux-gnu.deb**).
2. L’installer.

Lancer OBS Studio et vérifier que, quand on rajoute une source (clic droit dans le dock « Sources »), le choix « Source NDI™ » est bien disponible dans le menu.

### Installation de PTZ Controls

PTZ Controls est un plugin qui permet de piloter les caméras depuis OBS Studio. La page Github du projet [se trouve ici](https://github.com/glikely/obs-ptz).

1. Télécharger la version la plus récente du paquet [depuis cette page](https://github.com/glikely/obs-ptz/releases) (à la date de rédaction de cette documentation, il s’agit du paquet **obs-ptz-0.17.0-x86\_64-linux-gnu.deb**).
2. Installer le paquet.

<p class="callout danger">Attention, le point 3 ci-dessous est important : il existe une dépendance mal documentée pour faire fonctionner PTZ Controls. Si vous ne l’installez pas, PTZ Controls n’apparaîtra pas dans le menu « Docks » d’OBS Studio !</p>

3. Conformément à l’alerte ci-dessus, installer ce paquet :
    
    ```
    sudo apt install libqt6serialport6
    ```

Lancer OBS Studio. Dans le menu « **Docks** », un nouveau dock « **PTZ Controls** » devrait être présent. Sélectionner le dock et le glisser en bas, entre « Sources » et « Mélangeur audio » par exemple.

<p class="callout success">→ Vous devriez disposer d’un OBS Studio opérationnel.</p>

<p class="callout info">Auteur original de cette documentation : [Nicolas Vivant](https://www.linkedin.com/in/vivant/).</p>