ghostream/web/template/index.html

{{define "index"}}
<div style="max-width:720px;margin:0 auto; padding: 1rem">
  <h1>{{.Cfg.Name}}</h1>
  <p>
    {{.Cfg.Name}} est un service maintenu par le
    <a href="https://crans.org/">Crans</a> permettant de diffuser
    un contenu vidéo. Il a pour but d'être utilisé pour diffuser
    des séminaires ou évènements.
  </p>

  <h2>Comment je diffuse ?</h2>
  <p>
    Pour diffuser un contenu vous devez avoir des identifiants valides.
    Si le service est hébergé par une association, il est probable que
    vous deviez être membre de cette association.
  </p>

  <h3>Avec Open Broadcaster Software</h3>
  <p>
    <a href="https://obsproject.com/">Open Broadcaster Software</a>
    est une solution libre et open source de diffusion vidéo.
    Pour diffuser sur cette plateforme, allez dans les paramètres
    « <i>Stream (flux)</i> » :
  </p>
  <ul>
    <li>
      <b>Serveur :</b>
      <code>srt://{{.Cfg.Hostname}}:{{.Cfg.SRTServerPort}}?IDENTIFIANT:MOT_DE_PASSE</code>,
      avec <code>IDENTIFIANT</code> et <code>MOT_DE_PASSE</code>
      vos identifiants.
    </li>
  </ul>

  <p>
    Pour éviter les saccades, changez vos paramètres d'encodage dans
    « <i>Sortie</i> » avec un profil <code>baseline</code> et un
    règlage fin <code>zerolatency</code>.
  </p>

  <p>
    Votre stream sera alors disponible sur
    <code>https://{{.Cfg.Hostname}}/IDENTIFIANT</code>.
  </p>

  <h3>Avec FFmpeg</h3>
  <p>
    <code>
      {{/* FIXME replace with good SRT params */}}
      ffmpeg -re -i mavideo.webm -vcodec libx264
      -preset:v veryfast -vprofile baseline -tune zerolatency
      -acodec aac -strict -2 -f flv
      srt://{{.Cfg.Hostname}}:{{.Cfg.SRTServerPort}}?streamid=IDENTIFIANT:MOT_DE_PASSE
    </code>
  </p>

  <h2>Comment lire un flux depuis un lecteur externe ?</h2>
  <p>
    À l'heure actuelle, la plupart des lecteurs vidéos ne supportent
    pas le protocole SRT, ou le supportent mal. Un travail est en
    cours pour les rendre un maximum compatibles. Liste non exhaustive
    des lecteurs vidéos testés :
  </p>

  <h3>FFPlay</h3>
  <p>
    Si FFMpeg est installé sur votre machine, il est accompagné d'un
    lecteur vidéo nommé <code>ffplay</code>. Si FFMpeg est compilé
    avec le support de SRT (c'est le cas sur la plupart des distributions,
    sauf cas ci-dessous), il vous suffira d'exécuter :
  </p>

  <p>
    <code>
      ffplay -fflags nobuffer srt://{{.Cfg.Hostname}}:{{.Cfg.SRTServerPort}}?streamid=IDENTIFIANT
    </code>
  </p>

  <h3>MPV</h3>

  <p>
    MPV supporte officiellement SRT depuis le 16 octobre 2020.
    Néanmoins, la version stable de MPV est beaucoup plus vieille.
    Vous devez alors utiliser une version de développement pour
    pouvoir lire un flux SRT depuis MPV. L'installation se fait
    depuis <a href="https://mpv.io/installation/"> cette page</a>.
    Sous Arch Linux, il vous suffit de récupérer le paquet
    <code>mpv-git</code> dans l'AUR. Pour lire le flux, il suffit
    d'exécuter :
  </p>

  <p>
    <code>
      mpv srt://{{.Cfg.Hostname}}:{{.Cfg.SRTServerPort}}?streamid=IDENTIFIANT
    </code>
  </p>

  <h3>VLC Media Player</h3>

  <p>
    Bien que VLC supporte officiellement le protocole SRT,
    toutes les options ne sont pas encore implémentées,
    notamment l'option pour choisir son stream.
    Cette option n'est supportée que dans la version de développement
    depuis très récemment, grâce à un patch de l'un des développeurs
    de Ghostream.  Sous Arch Linux, il suffit de récupérer
    le paquet <code>vlc-git</code> de l'AUR. Avec un VLC à jour,
    il suffit d'exécuter :
  </p>

  <p>
    <code>
      vlc srt://{{.Cfg.Hostname}}:{{.Cfg.SRTServerPort}}?streamid=IDENTIFIANT
    </code>
  </p>

  <p>
    Ou bien d'aller dans Média -> Ouvrir un flux réseau et d'entrer l'URL
    <code>srt://{{.Cfg.Hostname}}:{{.Cfg.SRTServerPort}}?streamid=IDENTIFIANT</code>.
  </p>

  <h3>Le protocole n'existe pas ou n'est pas supporté.</h3>
  <p>
    La technologie SRT est très récente et n'est pas supportée par
    les dépôts stables. Ainsi, si vous avez Ubuntu &le; 20.04 ou
    Debian &le; Buster, vous ne pourrez pas utiliser de lecteur vidéo
    ni même diffuser avec votre machine. Vous devrez vous mettre à
    jour vers Ubuntu 20.10 ou Debian Bullseye.
  </p>

  <h2>Mentions légales</h2>
  <p>
    Le service de diffusion vidéo du Crans est un service d'hébergement
    au sens de l'article 6, I, 2e de la loi 2004-575 du 21 juin 2004.
    Conformément aux dispositions de l'article 6, II du même,
     conserve les données de nature à permettre
    l'identification des auteurs du contenu diffusé.
    Ce service est hébergé par {{.Cfg.LegalMentionsEntity}}, au
    {{.Cfg.LegalMentionsAddress}}.
  </p>
  <p>
    <b>En cas de réclamation sur le contenu diffusé</b>,
    la loi vous autorise à contacter directement l'hébergeur à
    l'adresse suivante :
    <pre>{{range $i, $element := .Cfg.LegalMentionsFullAddress}}{{$element}}<br/>{{end}}</pre>
    Vous pouvez également envoyer directement vos réclamations par
    courrier électronique à l'adresse <code>{{.Cfg.LegalMentionsEmail}}</code>.
  </p>
</div>
{{end}}