AkiBot documentation

Les overlays, pas à pas

Un overlay, c’est une page qu’OBS affiche par-dessus ton live : les alertes, le chat, une barre d’objectif, le jeu en cours. Tout se règle sur le tableau de bord. Rien à installer.

Créer l’overlay

Sur le tableau de bord, ouvre ta chaîne, puis Overlays OBS, et Créer un overlay. Donne-lui un nom qui te parle, « Écran de jeu » ou « Pause ». Il en faut un par scène qui change vraiment ; pour le reste, un seul suffit.

Seuls le streamer et ses modérateurs principaux peuvent créer ou modifier un overlay. Il s’affiche sur ton direct, je ne voulais pas que toute l’équipe de modération puisse y toucher.

Le mettre dans OBS

  1. Copie l’adresse de l’overlay (bouton Copier).
  2. Dans OBS : Sources, +, Navigateur. Colle l’adresse, mets la taille de l’overlay (1920 × 1080 par défaut).
  3. Coche Contrôler l’audio via OBS, sinon tu n’entendras pas les sons d’alerte dans ton live.

Cette adresse vaut accès : quelqu’un qui l’a peut l’afficher chez lui. Si elle passe dans un clip ou une capture, Nouvelle adresse la remplace et l’ancienne meurt tout de suite. Il faudra recoller la nouvelle dans OBS.

Le composer

Ouvrir l’éditeur d’overlay ouvre l’éditeur dans un onglet. Il est fait pour un écran d’ordinateur, pas pour un téléphone. On y ajoute des widgets (alertes, chat, jeu du chat, barre d’objectif, train de la hype, sondage et prédiction, pub, mur d’emotes, étiquette, derniers événements, générique de fin, tirage au sort, musique en cours, texte, compteur, citation, image, clip, widget fait main), on les place à la souris, on les empile en calques. Ctrl+Z annule.

Ce que tu changes arrive dans OBS sans recharger la source. Tu peux garder OBS ouvert à côté et régler en direct.

Si tu ne veux pas partir de rien, La galerie propose des overlays partagés par d’autres streamers. Gratuits, et tu les retouches comme tu veux une fois repris.

Régler une alerte

Une boîte d’alertes a une variante par événement : follow, abonnement, réabonnement, abonnement offert, bits, raid, points de chaîne. Chacune a son message, son image ou son GIF, son son, sa durée, sa disposition et son animation d’entrée.

Le son s’envoie depuis l’éditeur : 2 Mo au plus, 10 secondes au plus, 30 sons par chaîne. Un son plus long est coupé à 10 secondes à l’écran.

Émuler joue l’alerte dans l’éditeur avec de faux pseudos, pour juger la longueur d’une ligne sur ce qu’elle contiendra vraiment. Sur la page Overlays OBS, Alerte d’essai en envoie une jusqu’à OBS.

Une alerte par palier : les déclinaisons

Un abonnement palier 3 mérite autre chose qu’un follow. Une déclinaison, c’est une autre version de l’alerte, qui ne joue que si sa condition est remplie :

Jusqu’à 10 déclinaisons par événement. Quand plusieurs conviennent, c’est la plus exigeante qui passe. Si la base est éteinte, seules les déclinaisons jouent.

La barre d’objectif

« 12 / 20 abonnés » qui avance en direct. Elle peut suivre :

Une date se tape à l’heure de Paris. La barre avance à chaque alerte, sans attendre, et se recale toute seule chaque minute. Les alertes émulées ou rejouées ne la font pas bouger. Le titre, l’objectif, les chiffres et leur place, les couleurs, le dégradé, la forme : tout se règle.

Les widgets du live

Ils ne montrent rien tant qu’il ne se passe rien, et c’est voulu : on les pose une fois, ils apparaissent quand il faut.

Les dons

Les dons que tu reçois sur Ko-fi, StreamElements, Streamlabs ou TipeeeStream deviennent des alertes, avec leur message. L’argent ne passe pas par AkiBot : il va de la plateforme à toi, comme avant. AkiBot ne voit passer que l’annonce du don.

  1. Dans le tableau de bord, ta chaîne Twitch, page Dons.
  2. Colle la clé de ta plateforme, puis Brancher. La page dit où la trouver. Je l’essaie tout de suite chez la plateforme : une faute de copier-coller se voit là, pas au premier don qui ne s’affiche pas.
  3. Pour Ko-fi, c’est Ko-fi qui prévient. Colle son « Verification Token » dans AkiBot, puis l’adresse que je te donne dans Ko-fi, champ « Webhook URL ».

Les clés sont gardées chiffrées et ne reviennent jamais dans la page. Celle de StreamElements ouvre tout ton compte StreamElements : si elle a fuité, change-la chez eux et recolle la nouvelle.

Ko-fi et Streamlabs préviennent tout de suite, StreamElements et TipeeeStream sont relus toutes les huit secondes. Un don n’est jamais joué deux fois, et brancher une plateforme ne rejoue pas ses anciens dons. Un don marqué privé arrive sans son message.

Dans la boîte d’alertes, l’événement Don est allumé d’office. Il se règle comme les autres, avec des versions à partir d’un montant (« dès 20 € », compté dans la devise du don). Le merci dans le chat se règle dans « Messages d’événements ». Le widget Étiquette sait montrer le dernier don ou le plus gros du live, la liste et le générique les comptent. Et ?don donne ton lien de dons dans le chat.

La musique en cours

Le morceau que tu écoutes, à l’écran : la pochette, le titre, l’artiste, une barre qui avance. Spotify, Deezer, YouTube Music et Apple Music, dans le navigateur. Les applications de bureau, non.

C’est l’extension En Écoute qui lit ce qui joue dans ton navigateur et l’envoie à AkiBot. Il en faut la version 1.1 au moins.

  1. Dans l’éditeur, ajoute le widget Musique en cours.
  2. Dans son panneau, section Lien pour l’extension En Écoute : Copier.
  3. Installe En Écoute dans le navigateur où tu écoutes ta musique (Chrome, Brave, Edge, Opera, Vivaldi ou Firefox). Clique sur son icône, colle le lien.

Le panneau dit ensuite ce que l’extension envoie, et depuis quand. Si deux navigateurs jouent en même temps, c’est celui qui a lancé sa musique en dernier qui passe.

En barre, la pochette est à côté du titre. En carte, elle prend toute la largeur au-dessus. En minimal, il ne reste que le titre et l’artiste. La couleur suit le service, vert pour Spotify, violet pour Deezer, rouge pour YouTube Music et Apple Music, sauf si tu en choisis une.

En pause, le widget part au bout de trois secondes. Pas tout de suite : entre deux morceaux, le lecteur passe un instant en pause et le widget clignoterait. Le délai se règle, et tu peux aussi le laisser affiché. Navigateur fermé, il disparaît trente secondes plus tard.

Ce lien écrit sur ton live. Quelqu’un qui l’a peut y afficher le titre qu’il veut : garde-le comme l’adresse d’un overlay. Régénérer le lien coupe l’ancien tout de suite, il faudra recoller le nouveau dans l’extension.

Le dock, à côté de la scène

Le dock n’est pas un overlay : c’est une petite page qu’on met à côté de la scène dans OBS, pas dedans. On y voit ce que la chaîne a reçu, avec Rejouer sous chaque alerte. Et trois boutons : passer l’alerte qui joue, mettre les alertes en pause (elles attendent et partent à la reprise), couper leurs sons.

  1. Dans l’onglet Overlays OBS, carte Le dock pour OBS, Afficher l’adresse puis Copier.
  2. Dans OBS : Docks, Docks de navigateur personnalisés. Un nom, l’adresse, Appliquer.

Cette adresse commande tes alertes, ne la montre pas en live. Si c’est arrivé, Nouvelle adresse et l’ancienne ne marche plus. La pause et les sons coupés tiennent jusqu’à ce que tu les rallumes, ou jusqu’au prochain redémarrage d’AkiBot.

Les variables d’une alerte

Dans un message, {user} devient le pseudo, {bits} le nombre de bits, et ainsi de suite. Voici celles de chaque événement, avec ce que l’éditeur affiche quand on émule. Une variable que l’événement n’a pas reste écrite telle quelle, pour que tu voies la faute.

Follow

Message de départ : {user} suit la chaîne.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Lyra

Abonnement

Message de départ : {user} s’abonne, sous-titre {details}.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Kenji
{details}Une ligne toute faite, qui ne dit que ce qui est vrai pour cet abonnement : « Palier 3 · 6 mois d’un coup », « 7 mois · Prime ». C’est la plus sûre.Palier 3 · 6 mois d’un coup
{palier}« Prime », « Palier 1 », « Palier 2 » ou « Palier 3 ».Palier 3
{niveau}Le palier en chiffre : 1, 2 ou 3. Un abonnement Prime vaut 1.3
{avance}Les mois payés d’un coup. 1 pour un abonnement ordinaire, d’où l’intérêt de {details}, qui ne l’écrit que s’il y en a plus.6
{message}Le mot laissé avec l’abonnement, les bits, la récompense ou le don. Souvent vide, et toujours vide pour un don que la personne a voulu privé.vide

Réabonnement

Message de départ : {user} se réabonne, sous-titre {details}.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Mo
{details}Une ligne toute faite, qui ne dit que ce qui est vrai pour cet abonnement : « Palier 3 · 6 mois d’un coup », « 7 mois · Prime ». C’est la plus sûre.7 mois · Prime
{mois}Les mois d’abonnement cumulés.7
{serie}Pour un réabonnement : les mois d’affilée, seulement si la personne a choisi de le partager, vide sinon. Pour une série de visionnage : le nombre de lives regardés d’affilée.7
{palier}« Prime », « Palier 1 », « Palier 2 » ou « Palier 3 ».Prime
{niveau}Le palier en chiffre : 1, 2 ou 3. Un abonnement Prime vaut 1.1
{avance}Les mois payés d’un coup. 1 pour un abonnement ordinaire, d’où l’intérêt de {details}, qui ne l’écrit que s’il y en a plus.1
{message}Le mot laissé avec l’abonnement, les bits, la récompense ou le don. Souvent vide, et toujours vide pour un don que la personne a voulu privé.toujours là

Abonnement offert

Message de départ : {user} offre {nombre} abonnement(s), sous-titre {details}.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Nine
{details}Une ligne toute faite, qui ne dit que ce qui est vrai pour cet abonnement : « Palier 3 · 6 mois d’un coup », « 7 mois · Prime ». C’est la plus sûre.Palier 2
{nombre}Le nombre d’abonnements offerts d’un coup.5
{destinataire}Qui reçoit l’abonnement, quand il n’y en a qu’un. Vide pour un don à plusieurs.vide
{duree}Les mois offerts à chaque personne. 1 la plupart du temps.1
{palier}« Prime », « Palier 1 », « Palier 2 » ou « Palier 3 ».Palier 2
{niveau}Le palier en chiffre : 1, 2 ou 3. Un abonnement Prime vaut 1.2
{total}Combien d’abonnements cette personne a offerts sur la chaîne, en tout. Vide pour un anonyme.25

Bits

Message de départ : {user} envoie {bits} bits, sous-titre {message}.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Ost
{bits}Le nombre de bits.500
{message}Le mot laissé avec l’abonnement, les bits, la récompense ou le don. Souvent vide, et toujours vide pour un don que la personne a voulu privé.gg pour le boss

Raid

Message de départ : Raid de {user}, sous-titre {viewers} personnes débarquent.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Vela
{viewers}Les personnes qui arrivent avec le raid.42

Points de chaîne

Message de départ : {user} utilise « {recompense} », sous-titre {message}.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Lyra
{recompense}Le nom de la récompense de points de chaîne, ou celui de Twitch pour les siennes (« Emote géante »).Hydrate-toi
{cout}Ce qu’elle a coûté, en points.500
{message}Le mot laissé avec l’abonnement, les bits, la récompense ou le don. Souvent vide, et toujours vide pour un don que la personne a voulu privé.vide

Power-up

Message de départ : {user} utilise « {powerup} », sous-titre {bits} bits.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Kenji
{powerup}Le Power-up utilisé : « Célébration », « Effet de message », « Emote géante », ou le nom d’un Power-up que tu as créé.Célébration
{bits}Le nombre de bits.300
{message}Le mot laissé avec l’abonnement, les bits, la récompense ou le don. Souvent vide, et toujours vide pour un don que la personne a voulu privé.vide

Série de visionnage

Message de départ : {user} : {serie} lives d’affilée, sous-titre {message}.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Nine
{serie}Pour un réabonnement : les mois d’affilée, seulement si la personne a choisi de le partager, vide sinon. Pour une série de visionnage : le nombre de lives regardés d’affilée.12
{points}Les points de chaîne que Twitch a donnés pour la série de visionnage.450
{message}Le mot laissé avec l’abonnement, les bits, la récompense ou le don. Souvent vide, et toujours vide pour un don que la personne a voulu privé.toujours là pour la suite

Don

Message de départ : {user} envoie {montant}, sous-titre {message}.

VariableCe qu’elle vautPar exemple
{user}Le pseudo de la personne, tel qu’il s’écrit sur Twitch. Pour un don anonyme : « Un anonyme ».Aster
{montant}Le montant du don, prêt à lire, avec sa devise : « 5,00 € », « 12,50 $US ».5,00 €
{valeur}Le montant du don en chiffre seul : 5, 12.5. C’est lui que comptent les versions « à partir de ».5
{devise}La devise du don, en trois lettres : EUR, USD.EUR
{message}Le mot laissé avec l’abonnement, les bits, la récompense ou le don. Souvent vide, et toujours vide pour un don que la personne a voulu privé.pour le café de la pause
{plateforme}Où le don a été fait : Ko-fi, StreamElements, Streamlabs ou TipeeeStream.Ko-fi

Garder une copie, ou passer un overlay ailleurs

Exporter télécharge l’overlay dans un fichier : son nom, sa taille, ses widgets. Jamais son adresse. Importer un fichier en refait un nouvel overlay, avec une adresse neuve.

Importé sur une autre chaîne, l’overlay laisse ses sons derrière lui. Un son envoyé appartient à la chaîne qui l’a envoyé, c’est la même règle que dans la galerie.

Rien ne s’affiche ?