SinusBot
Incluse avec Macro DeckPilotez la musique de vos instances SinusBot et affichez sur votre deck ce qu'elles jouent.
Deux widgets Lecteur de musique qui jouent un morceau, l'un en style Pochette pleine et l'autre en style Petite pochette, tous deux avec le nom et le logo de SinusBot dans l'en-tête
- Lecture, pause, morceau suivant et position sur n'importe quelle instance SinusBot
- Réglez le volume, la lecture aléatoire et la répétition
- Lancez un morceau de la bibliothèque du bot
- Affiche le morceau en cours dans le widget Lecteur de musique
- Ajoutez autant d'instances de bot que vous le souhaitez
SinusBot est un bot musical pour TeamSpeak et Discord que vous faites tourner sur votre propre serveur. L'intégration SinusBot relie Macro Deck à l'interface web de SinusBot : vous pouvez ainsi piloter ce que joue une instance du bot et voir le morceau en cours sur votre deck. Elle fonctionne avec tout SinusBot que Macro Deck peut joindre par le réseau, sur le même ordinateur, dans votre réseau local ou sur un serveur.
Ce que vous pouvez faire
- Lancer, mettre en pause, basculer, passer au morceau suivant ou précédent et aller à une position du morceau en cours.
- Régler le volume, l'augmenter ou le baisser, activer ou désactiver la lecture aléatoire et la répétition.
- Lancer un morceau précis de la bibliothèque du bot avec Play Track. Laissez le morceau vide pour le choisir au moment d'appuyer sur le bouton.
- Afficher le morceau, l'artiste et la pochette en cours dans le widget Lecteur de musique de Macro Deck, et utiliser le morceau, la position et le volume du bot dans des libellés grâce aux variables.
Quelques exemples de configuration :
- Une rangée de boutons avec Previous Track, Toggle Play/Pause et Next Track pour le bot de votre canal TeamSpeak. Le bouton de lecture indique si le bot joue.
- Un curseur lié à la variable de volume du bot,
sinusbot_<instance>_volume, pour baisser la musique pendant que vous parlez. - Un widget Lecteur de musique pour chaque bot, à côté de boutons dont la couleur suit la pochette grâce à la variable
music_player_<player>_album_color.
Plusieurs bots et fonctionnement
Chaque instance SinusBot que vous voulez piloter correspond à une configuration. Vous pouvez en ajouter autant que vous le souhaitez, y compris des instances sur différents serveurs, et choisir l'instance dans le champ Player de chaque action. Si vous laissez Player vide, l'action pilote la première. Chaque configuration a ses propres variables, nommées d'après le nom de la configuration, comme sinusbot_<instance>_volume.
Macro Deck vérifie la connexion lors de la configuration et charge les instances du bot. Pendant son fonctionnement, il lit régulièrement l'état de lecture. Quand le bot est injoignable un court instant, le deck continue d'afficher le dernier morceau ; s'il reste injoignable, la variable sinusbot_<instance>_is_connected vaut false et les actions ne font rien jusqu'à ce que le bot réponde de nouveau.
Ce qu'il vous faut
- Un SinusBot en marche dont l'interface web est accessible depuis Macro Deck, par exemple
http://your-bot:8087. - Un nom d'utilisateur et un mot de passe SinusBot.
- Au moins une instance créée dans l'interface web de SinusBot.
Configuration
Étape 1: Vérifiez l'interface web de SinusBot
Ouvrez l'interface web de SinusBot dans un navigateur et connectez-vous. Notez l'adresse avec le port, par exemple
http://192.168.1.20:8087, et vérifiez qu'il existe au moins une instance.Étape 2: Ouvrez l'intégration SinusBot
Dans Macro Deck, cliquez sur Intégrations dans la barre latérale, puis sur SinusBot. Dans l'onglet Aperçu, cliquez sur Ajouter une configuration dans la section Configuration. Activer l'interrupteur en haut à droite ouvre la même boîte de dialogue, et l'intégration est activée une fois la configuration terminée.
Étape 3: Saisissez le serveur et les identifiants
Dans la boîte de dialogue Connecter SinusBot, saisissez :
- URL du serveur : l'adresse de l'interface web de SinusBot, port compris.
- Nom d'utilisateur et Mot de passe : le compte avec lequel vous vous connectez à SinusBot.
Quand vous cliquez sur Continuer, Macro Deck teste la connexion et charge les instances.
Étape 4: Sélectionnez l'instance
À l'étape Sélectionner une instance, choisissez l'instance du bot sous Instance et cliquez sur Continuer. La configuration est enregistrée sous le nom SinusBot, avec le nom de l'instance entre parenthèses. Répétez ces étapes pour chaque autre instance que vous voulez piloter.
Étape 5: Ajoutez une action à un bouton
Sur la page Deck, cliquez sur un bouton. Le deck doit être déverrouillé : c'est le cas lorsque le bouton Verrouiller s'affiche en haut à droite. L'éditeur s'ouvre avec Appui court sélectionné. Cliquez sur + Ajouter une action, sélectionnez SinusBot à gauche de la boîte de dialogue Ajouter une action, choisissez Toggle Play/Pause et sélectionnez l'instance sous Player.
Étape 6: Appuyez sur le bouton
Appuyez sur le bouton de votre deck. Le bot lance ou met en pause la lecture, et le bouton affiche l'état actuel. Un widget Lecteur de musique réglé sur l'instance affiche le morceau en cours.
Actions13
Placez-les sur un bouton ou exécutez-les depuis un flux.
- Play
- Reprend la lecture.
- Pause
- Met la lecture en pause.
- Toggle Play/Pause
- Alterne entre lecture et pause, et affiche l'état actuel sur le bouton.
- Next Track
- Passe au morceau suivant.
- Previous Track
- Revient au morceau précédent.
- Refresh State
- Relit immédiatement l'état de lecture en cours.
- Set Volume
- Règle le volume de lecture (de 0 à 100 %).
- Volume Up
- Augmente le volume de lecture de 10 %.
- Volume Down
- Baisse le volume de lecture de 10 %.
- Seek
- Va à une position du morceau en cours, en secondes.
- Toggle Shuffle
- Bascule la lecture aléatoire, ou l'active ou la désactive.
- Set Repeat Mode
- Active ou désactive la répétition. SinusBot n'a qu'un seul mode de répétition : les deux options de répétition l'activent donc.
- Play Track
- Lance un morceau de la bibliothèque du bot. Laissez le champ vide pour choisir un morceau au moment d'appuyer sur le bouton.
Déclencheurs7
Un bouton ou un flux peut réagir à ces événements.
- Piste changée
- Un autre morceau a commencé (sous Music Player).
- Lecture démarrée
- La lecture a démarré ou repris (sous Music Player).
- Lecture en pause
- La lecture a été mise en pause (sous Music Player).
- Lecture arrêtée
- La lecture s'est arrêtée (sous Music Player).
- Volume changé
- Le volume du bot a changé, avec la nouvelle et l'ancienne valeur (sous Music Player).
- Lecteur connecté
- L'instance du bot est devenue joignable (sous Music Player).
- Lecteur déconnecté
- L'instance du bot n'est plus joignable (sous Music Player).
Variables8
Affichez ces valeurs sur des boutons et des widgets, ou utilisez-les dans des conditions.
sinusbot_<instance>_current_track_name,sinusbot_<instance>_current_artist,sinusbot_<instance>_current_album- Le morceau en cours et son artiste. SinusBot n'indique pas d'album :
sinusbot_<instance>_current_albumreste donc vide. sinusbot_<instance>_playback_state,sinusbot_<instance>_is_playing- Indique si le bot joue, est en pause ou arrêté.
sinusbot_<instance>_volume- Le volume de lecture en pourcentage. Vous pouvez aussi le modifier, par exemple avec un curseur.
sinusbot_<instance>_track_duration,sinusbot_<instance>_current_position,sinusbot_<instance>_progress_percentage- La durée du morceau et la position en secondes, et la progression en pourcentage. Vous pouvez modifier la position pour vous déplacer dans le morceau.
sinusbot_<instance>_album_art_url- L'adresse de la pochette en cours.
sinusbot_<instance>_device_name- Le nom de l'instance du bot.
sinusbot_<instance>_shuffle_enabled,sinusbot_<instance>_repeat_mode- Indique si la lecture aléatoire et la répétition sont activées.
sinusbot_<instance>_is_connected- Indique si Macro Deck peut joindre l'instance du bot.
Questions fréquentes
Puis-je piloter plusieurs bots ?
Oui. Ajoutez une configuration par instance SinusBot, y compris sur différents serveurs. Chaque action possède un champ Player pour l'instance qu'elle pilote, et chaque configuration a ses propres variables.
SinusBot doit-il tourner sur le même ordinateur ?
Non. Macro Deck communique avec l'interface web de SinusBot par le réseau : le bot peut donc tourner sur un serveur ou un autre ordinateur, tant que Macro Deck peut joindre son adresse.
La configuration indique qu'aucune instance n'a été trouvée. Que faire ?
Le compte n'a aucune instance utilisable. Créez d'abord une instance dans l'interface web de SinusBot, puis relancez la configuration.
Que se passe-t-il quand le bot passe hors ligne ?
Une courte interruption ne vide pas le deck : il conserve le dernier morceau un moment. Si le bot reste injoignable, la variable sinusbot_<instance>_is_connected vaut false, et Macro Deck continue d'essayer de le joindre.
Où mon mot de passe est-il stocké ?
Le mot de passe est stocké chiffré sur votre ordinateur et ne sert qu'à se connecter à votre SinusBot.
Plus dans Chat et voix
Discord
Incluse avec Macro DeckCoupez le micro et le son, rejoignez des canaux vocaux, modifiez vos réglages vocaux et publiez des messages par webhook dans Discord depuis votre deck.
Webhooks Discord
Incluse avec Macro DeckPubliez des messages enrichis avec des embeds et des mentions dans des salons Discord via des webhooks, avec un aperçu en direct.