Paramètres

Cette section décrit la page de configuration du plugin.

Lister les salons de tchat existants

Lorsque vous appuyez sur le bouton “Lister les salles”, toutes les salles de chat existantes sont listées. Vous pouvez alors les trouver et les modérer.

Fédération

Les paramètres suivants concernent la fédération avec d’autres instances Peertube et d’autres logiciels du fediverse.

Ne pas afficher les tchats distants

En cochant ce paramètre, votre instance n'affichera jamais les tchats sur les vidéos distantes.

Ne pas publier les informations de tchats

En cochant ce paramètre, votre instance ne publiera pas les informations de tchat sur le fédivers. Les instances Peertube distantes ne sauront pas qu'un tchat est associé aux vidéos.
Attention : si vous aviez déjà des tchats en cours, il est possible que les informations aient déjà été publiées. Il faudra attendre la prochaine mise à jour des vidéos pour que les informations soient dépubliées. De même, si vous désactivé ce paramètre, il faudra attendre que les vidéos soient mises à jour pour à nouveau publier les informations. Cette mise à jour intervient entre autre quand un live reprend ou s'arrête.
Attention : ce paramètre ne joue que sur la publication d'informations via le protocole ActivityPub. Il n'empêchera pas une application distante de détecter autrement la présence de tchat, et de tenter de s'y connecter.

External Authentication

See the detailed documentation page:

External Authentication

Configuration avancée de la chaîne

Les paramètres suivants concernent les options de chaîne avancées : les utilisateur⋅rices pourront personnaliser leurs chaînes, activer le bot de modération, …

Désactiver la configuration avancée des chaînes et le bot de modération

Si vous rencontrez un problème avec cette fonctionnalité, vous pouvez la désactiver.

Comportement en chat

Type de salon

Vous pouvez choisir d'avoir des salons séparés pour chaque vidéo, ou de les grouper par chaîne.

Ouvrir automatiquement le tchat

Quand on regarde une vidéo, le tchat va automatiquement s'ouvrir.

Montrer le bouton «ouvrir dans une nouvelle fenêtre»

Il y aura un bouton pour ouvrir le tchat dans une nouvelle fenêtre.

Montrer le bouton «partager le lien du salon»

Cette fonctionnalité permet d’activer une fenêtre modale “partager le lien du chat”. Avec cette modale, vous pouvez générer des URL pour rejoindre le tchat. Le tchat peut être personnalisé (mode lecture seule, utilisation du thème actuel, …).

Vous pouvez par exemple générer une URL en lecture seule et l’utiliser dans OBS pour intégrer le chat dans votre flux en direct !

Ce paramètre vous permet de choisir qui peut accéder à cette fenêtre modale.

Les utilisateur⋅rices peuvent activer le tchat pour leurs directs

Si coché, il y aura pour tous les directs une case à cocher dans les propriétés qui permettra d'activer/désactiver le tchat.

Le⋅a propriétaire de la vidéo pourra activer le tchat en ligne.

Activer le tchat pour tous les directs

Si coché, il y aura un tchat pour tous les directs.

Activer le tchat pour toutes les vidéos «non-direct»

Activer le tchat pour toutes les vidéos «non-direct»

Activer le tchat pour ces vidéos

Activer le tchat pour ces vidéos

Masquer les tchats pour les utilisateur⋅rices anonymes

Si coché, les utilisteur⋅rices non connecté⋅es ne verront pas les tchats. Cette fonctionnalité est encore expérimentale. Si vous l'avez activée, il est hautement recommandé d'également cocher «Ne pas publier les informations de tchats». Sinon certains outils tierces ne pourraient tenter d'ouvrir le tchat, et auraient des résultats imprédictibles.

Note : pour l’instant, c’est fonctionnalité masque simplement le tchat. Dans une future version, le tchat sera remplacé par un message précisant «merci de vous connecter […]». Voir les notes de publication de la version 5.7.0 pour plus d’informations.

Bannir l'IP des utilisateur⋅rices anonymes, quand iels sont banni⋅es des salons

En activant cette option, à chaque fois qu'un⋅e utilisateur⋅rice anonyme est banni⋅e d'un salon, son IP sera également bannie du serveur de tchat. Attention : si votre instance est ouverte aux inscriptions, un⋅e utilisateur⋅rice pourrait créer un salon piégé, y inviter des personnes, et automatiquement bannir les IPs des utilisateur⋅rices anonymes. La liste des IPs bannie n'est pas enregistrée, et sera effacée au redémarrage du serveur, ou si vous changez certains paramètres du plugin. Les IPs bannies sont journalisées dans les journaux du serveur Prosody, donc les admins du serveur peuvent éventuellement utiliser des outils externes (comme par exemple fail2ban) pour bannir les IPs plus largement.

Note importante : Si vous activez cette fonctionnalité, et que vous utilisez un reverse proxy personnalisé devant Peertube, merci de vous assurer que vous avez correctement configuré celui-ci pour faire suivre les IPs réelles des utilisateur⋅rices à Peertube. Sinon cela pourrait bloquer tous les utilisateur⋅rices anonymes d’un coup.

Personnalisation de l’apparence

Jeu d'avatars

Vous pouvez choisir parmi plusieurs jeux différents les avatars par défaut qui seront utilisés pour les utilisateurs du tchat.

Sepia (mascotte Peertube) : Générateur d’avatars Peertube de David Revoy, Licence CC-By

Sepia

Chats : Générateur d’avatar de chat de David Revoy, Licence CC-By

Chats

Oiseaux : Générateur d’avatar d’oiseaux de David Revoy, Licence CC-By

Oiseaux

Fennecs (mascotte Mobilizon) : Générateur d’avatar fénnec/mobilizon de David Revoy, licence CC-By

Fénnecs

Abstrait : Générateur d’avatar abstrait de David Revoy, licence CC-By

Abstraits

Anciens avatars Sepia (ceux inclus dans les versions précédentes du plugin) : Basé sur le travail de David Revoy, licence AGPL-v3

Anciensavatars

Si vous ne voyez pas le changement immédiatement, cela peut être dû au cache de votre navigateur. Effacez le stockage de session de votre navigateur ou redémarrez-le.

Thème ConverseJS

Vous pouvez choisir le thème à utiliser pour ConverseJS :

  • Thème Peertube : il s’agit d’un thème spécial, conçu spécialement pour l’intégration dans Peertube.
  • Thème ConverseJS par défaut : c’est le thème ConverseJS par défaut.
  • Thème ConverseJS concord : il s’agit d’un thème fourni par ConverseJS.

Détection automatique des couleurs

Essaie de détecter automatiquement les couleurs du thème courant de l'utilisateur⋅rice.
Quand ce paramètre est activé, le plugin essaie de détecter automatiquement les couleurs à appliquer au thème du tchat.
Si cela ne fonctionne pas correctement pour certains de vos thèmes Peertube, vous pouvez désactiver cette option. Vous pouvez rapporter les bugs sur le gestionnaire de ticket . N'oubliez pas de préciser pour quel thème cela ne fonctionne pas.

Attribut de style de l'iframe du tchat

Styles additionnels à appliquer sur l'iframe du tchat.
Exemple : height:400px;

Paramètres avancés du tchat

Utiliser le serveur Prosody installé sur le système

Le plugin est livré avec une AppImage qui est utilisée pour exécuter le serveur XMPP Prosody. Si cet AppImage ne fonctionne pas, vous pouvez vous rabattre sur la version de Prosody qui est packagé pour votre serveur. Installez simplement le paquet prosody.

Ce paramètre ne devrait être utilisé que si le plugin est cassé et en attente d’un correctif.

Désactiver Websocket

Avec Peertube >= 5.0.0, ce plugin va essayer d'utiliser Websocket pour les connexions au tchat. Si le navigateur de l'utilisateur⋅rice ou sa connexion n'est pas compatible, le navigateur va automatiquement passer au protocole BOSH.
Mais, dans de rare cas, cela pourrait échouer. Par exemple si vous avez un reverse proxy devant votre Peertube qui ne permettrait pas les connexions Websocket. Dans ce cas, vous pouvez cocher cette option pour désactiver les connexions Websocket.

Port Prosody

Le port qui va être utilisé par le serveur Prosody.
Changez-le si ce port est déjà utilisé sur votre serveur.
Vous pouvez fermer ce port sur votre pare-feu, il ne sera pas accédé par le monde extérieur.
Note : cela pourrait changer dans un futur proche, car il est prévu d'ajouter des paramètres pour autoriser les connexions externes.

Url Peertube pour les appels d'API

Merci de ne pas toucher à ce paramètre si vous ne savez pas ce que vous faites.
Dans de rare cas, le serveur Prosody ne peut appeler l'API de Peertube en utilisant l'url publique. Vous pouvez utiliser ce paramètre pour personnaliser l'url que les modules Prosody utiliseront pour les API Peertube (par exemple, en mettant «http://localhost:9000» ou «http://127.0.0.1:9000»).

Si ce paramètre est laissé vide, et que vous utilisez Peertube >= 5.1, le plugin va utiliser les valeurs de votre fichier de configuration Peertube pour devenir sur quelle interface et quel port les requêtes doivent être faites.

En dernier recours, cela utilisera l’URI publique de votre instance. Donc les appels d’API passeront à traver Nginx. Cela peut échouer dans certains cas : par exemple si vous êtes dans un conteneur Docker pour lequel le hostname publique ne résoud pas sur la bonne IP. Dans ce cas, essayez de changer le paramètre “Url Peertube pour les appels d'API”, en mettant http ://127.0.0.1 :9000 (si c’est bien le port 9000 qui est utilisé par votre Peertube, demandez aux administrateur⋅rices de votre instance si vous ne savez pas).

Enregistrer les salons par défaut

Si coché, le contenu des salons sera enregistré par défaut. Quand un⋅e utilisateur⋅rice rejoint un salon, iel pourra voir ce qui a été dit avant.
À noter qu'il est toujours possible d'activer/désactiver cette fonctionnalité pour un salon spécifique, en changeant ses paramètres.

Expiration des journaux de salon

Vous pouvez choisir combien de temps le contenu des salons est gardé sur le serveur. La valeur peut être :
  • 60 : le contenu sera sauvegardé pour 60 secondes. Vous pouvez remplacer 60 par n'importe quelle valeur entière.
  • 1d : le contenu sera sauvegardé pour 1 jour. Vous pouvez remplacer 1 par n'importe quelle valeur entière.
  • 1w : le contenu sera sauvegardé pour 1 semaine. Vous pouvez remplacer 1 par n'importe quelle valeur entière.
  • 1m : le contenu sera sauvegardé pour 1 mois. Vous pouvez remplacer 1 par n'importe quelle valeur entière.
  • 1y : le contenu sera sauvegardé pour 1 année. Vous pouvez remplacer 1 par n'importe quelle valeur entière.
  • never : le contenu ne sera jamais effacé.

Autoriser les connexions aux salons via des comptes XMPP externes

En activant cette option, il sera possible de se connecter aux salons en utilisant des comptes XMPP externes via des clients XMPP.
Attention, activer cette option peut demander une configuration au niveau du serveur et des enregistrements DNS. Pour en savoir plus, merci de vous référer à la documentation: Autoriser les connexions avec des comptes XMPP externes.

Port Prosody serveur vers serveur

Le port à utiliser pour les connexions XMPP s2s (server to server).
Il est recommandé d'utiliser le port standard 5269. Sinon vous devrez configurer un enregistrement DNS spécifique .

Interfaces réseau pour les connexions serveur vers serveur

Les interfaces réseau sur lequelles écouter pour les connexions s2s (server to server).
Une liste d'IP séparées par des virgules (les espaces seront retirés). On pourra utiliser «*» pour écouter sur toutes les IPv4, et «::» pour toutes les IPv6.
Exemples de configuration possible:
  • *, ::
  • *
  • 127.0.0.1, ::1
  • 172.18.0.42

Dossiers des certificats

Si ce champ est vide, le plugin va générer et utiliser des certificats auto-signés.
Si vous voulez utiliser d'autres certificats, vous avez juste à spécifier ici le dossier où Prosody peut les trouver. Note : l'utilisateur «peertube» doit avoir un accès en lecture à ce dossier.

Activer les connexions client vers serveur

Autoriser les clients XMPP à se connecter au serveur Prosody.
Cette option seule n'autorise que les connexions de clients sur le localhost.

Ce paramètre permet aux clients XMPP de se connecter au serveur Prosody intégré. Pour l’instant, cette option n’autorise que les connexions des clients sur le localhost.

Par exemple, cette option peut permettre à une instance Matterbridge (une fois qu’elle pourra utiliser une connexion anonyme) sur la même machine de faire le lien entre votre tchat et d’autres services tels qu’une salle Matrix.

Port Prosody client vers serveur

Le port à utiliser pour les connexions XMPP c2s (client to server).
Les clients XMPP devront utiliser ce port pour se connecter.
Changez ce port si le port est déjà utilisé sur votre serveur.
Pour l'instant, vous pouvez garder ce port fermé sur votre pare-feu, il sera inaccessible depuis l'extérieur (Prosody n'écoute que le localhost).
Note : cela pourrait prochainement changer, car il est prévu d'ajouter une fonction permettant d'activer les connexions externes.

Activer les composants externes personnalisés Prosody

Ce paramètre permet aux composants externes XMPP de se connecter au serveur. Par défaut cette option n’autorise que les connexions des composants sur localhost. Vous devez changer la valeur du paramètre «Interfaces réseau pour les composants Prosody externes» pour écouter sur d’autres interfaces réseau.

Cette fonction pourrait être utilisée pour connecter des ponts ou des robots.

Plus d’informations sur les composants externes de Prosody [ici] (https://prosody.im/doc/components).

Activer les composants externes personnalisés Prosody

Pour permettre l'utilisation de composants XMPP externes.
Cette option seule n'autorise que les connexions depuis le localhost.
Vous devez configurer les interfaces sur lesquelles écouter et ouvrir les ports sur votre pare-feu pour rendre cela disponible à des serveurs distants.
Cette fonctionnalité peut, par exemple, être utilisée pour connecter des bots aux salons.

Port pour les composants externe Prosody

Le port à utiliser pour les XMPP components.
Changez ce port s'il est déjà utilisé sur votre serveur.
Vous pouvez garder ce port fermé sur votre pare-feu si vous n'autorisez pas l'accès sur les interfaces autre que localhost.

Interfaces réseau pour les composants Prosody externes

Les interfaces réseau sur lesquelles écouter pour les composants externes.
Une liste d'IP séparées par des virgules (les espaces seront retirés). On pourra utiliser «*» pour écouter sur toutes les IPv4, et «::» pour toutes les IPv6.
Exemples :
  • *,::
  • *
  • 127.0.0.1,::1
  • 172.18.0.42

Composants externes

Les composants externes à déclarer :
  • Un par ligne.
  • Utilisez le format «nom_du_composant:passphrase_secrete» (les espaces seront retirés).
  • Vous pouvez ajouter des commentaires: tout ce qui se trouve après un caractère # sera retiré, et les lignes vides ignorées.
  • Le nom ne peut contenir que des caractères alphanumériques latins et des points.
  • Si le nom ne contient que des caractères alphanumériques, il sera suffixé avec le domaine XMPP. Par exemple, «bridge» deviendra «bridge.votre_domaine.tld». Vous pouvez aussi spécifier un nom de domaine complet, mais vous devrez vous assurer que votre configuration DNS est correcte.
  • N'utilisez que des caractères alphanumériques dans la passphrase secrète (utilisez au moins 15 caractères).