Discord

Schaltet Mikrofon und Ton in Discord stumm, regelt die Pegel und postet in Kanäle. Zeigt auf dem Display, wer im Sprachkanal ist und wer gerade redet.

Eigenschaft	Wert
Fach	Streaming & Chat
Schlüssel	discord (so heißt das Plugin in Makros)
Bei frischer Installation	aus (im Marktplatz einschalten)
Befehle	8
Einrichtung	4 Felder, dazu der Knopf „Mit Discord verbinden“

Wofür

• Mikrofon und Ton in Discord stumm schalten, mit leuchtender Kachel,
• Pegel von Mikrofon und Ausgabe per Schieberegler setzen,
• den Sprachkanal verlassen,
• Nachrichten in einen Kanal posten (über einen Webhook),
• auf dem Display zeigen, wer im Sprachkanal ist und wer gerade redet.

Zwei Wege

Das Plugin hat zwei Wege zu Discord, und der zweite ist der Ersatz für den ersten.

	Verbunden (die Steuerung von Discord)	Tastenkürzel
Was es braucht	die Verbindung (siehe unten), Discord läuft	dieselbe Tastenkombination, die du in Discord selbst eingetragen hast
Mikro und Ton stumm	ja, direkt, und die Kachel leuchtet richtig	ja, aber blind: Die Software weiß nicht, was daraus wurde
Pegel setzen	ja	nein
Sprachkanal verlassen	ja	nein
Wer im Sprachkanal ist	ja (Widget)	nein
Nachricht in einen Kanal	geht immer, über den Webhook, unabhängig vom Weg

Der Zustand des Plugins heißt verbunden nur, wenn die Verbindung steht. Ohne sie steht dort getrennt, auch wenn die Tastenkürzel gehen. Dass Discord zufällig läuft, ist keine Verbindung: Die wichtigen Befehle würden trotzdem scheitern, und ein grüner Punkt wäre gelogen.

Einrichten

Feld	Hinweis
Zugriffstoken (wird gesetzt)	geheim: wird nach dem Speichern nie wieder angezeigt
Kürzel für Mikro stumm (ohne RPC)	Beispiel: ctrl+shift+m
Kürzel für Ton stumm (ohne RPC)	Beispiel: ctrl+shift+d
Webhook-URL eines Kanals	geheim: wird nach dem Speichern nie wieder angezeigt

Verbinden

1. Starte Discord.
2. Plugins → Discord → Aktivieren → Einrichten, dann unten links Mit Discord verbinden.
3. Bestätige die Freigabe. Je nach Fassung fragt Discord in seinem eigenen Fenster oder die Freigabe geht über den Browser. Der Dialog nennt unten, was du tun sollst („bestätige es im Discord-Fenster“ oder „im Browser bestätigen, der sich gerade öffnet“). Du hast dafür etwa zwei Minuten.
4. Danach steht dort angemeldet als <Name>, und das Plugin ist verbunden. Das Zugriffstoken legt die Software selbst ab. Du trägst es nie von Hand ein.

Beim nächsten Start nimmt das Plugin das gespeicherte Token ohne Rückfrage wieder auf. Steht dort „Discord läuft — Token abgelehnt, neu verbinden“, drücke noch einmal Mit Discord verbinden.

Der Weg über Tastenkürzel

Das ist der Ersatz, wenn die Verbindung nicht geht (oder du sie nicht willst):

1. Lege in Discord unter Einstellungen → Tastenbelegungen je eine Tastenbelegung für Mikrofon stummschalten und Ton ausschalten an, zum Beispiel ctrl+shift+m und ctrl+shift+d.
2. Trage dieselben Kombinationen im Einrichtungsformular ein: Kürzel für Mikro stumm (ohne RPC) und Kürzel für Ton stumm (ohne RPC). Die Schreibweise steht unter Tastenkürzel schreiben.
3. Die Aktionen Mikro stumm/laut und Ton stumm/laut drücken dann diese Kombination. Außerdem lässt sich bei der Aktion selbst ein Ersatz-Kürzel angeben, das das gespeicherte überstimmt.

Ohne Verbindung und ohne Kürzel meldet die Software: „Nicht mit Discord verbunden und kein … hinterlegt - entweder verbinden oder dasselbe Kürzel eintragen, das in Discord unter Tastenbelegung steht“.

Der Webhook

Für Nachricht in Kanal posten: In Discord legst du für den Kanal einen Webhook an (Kanal bearbeiten → Integrationen → Webhooks → Neuer Webhook) und kopierst die Webhook-URL. Trage sie bei Webhook-URL eines Kanals ein. Sie gilt als geheim: Wer sie kennt, schreibt in deinen Kanal. Die Aktion nimmt zusätzlich ein Feld Webhook-URL (sonst aus den Einstellungen), um einen anderen Kanal zu meinen.

Tipp: Lasse dieses Feld in der Aktion leer und halte die Adresse in den Einstellungen. Was in einer Belegung steht, wird gesichert und mit dem Konto abgeglichen, die Plugin-Einstellungen nicht. Siehe Datenschutz.

Erlaubt sind nur Adressen von discord.com, discordapp.com, ptb.discord.com und canary.discord.com über https. Ein Tastendruck soll nicht an eine beliebige Adresse gehen, die jemand in das Feld einfügt.

Befehle

Befehl	Name im Makro	Felder	Passt auf
Mit Discord verbinden	discord.connect	—	Taste
Mikro stumm/laut	discord.toggle_mute	hotkey Ersatz-Kürzel, falls nicht verbunden	Taste; die Kachel zeigt den Zustand
Ton stumm/laut	discord.toggle_deafen	hotkey Ersatz-Kürzel, falls nicht verbunden	Taste; die Kachel zeigt den Zustand
Mikrofon-Pegel setzen	discord.set_input_volume	value Pegel 0-100 * (beim Schieberegler kommt der Wert vom Regler)	Taste, Schieberegler
Ausgabe-Pegel setzen	discord.set_output_volume	value Pegel 0-100 * (beim Schieberegler kommt der Wert vom Regler)	Taste, Schieberegler
Sprachkanal verlassen	discord.leave_voice	—	Taste
Beliebiges Discord-Kürzel	discord.press_hotkey	hotkey Tastenkombination *	Taste
Nachricht in Kanal posten	discord.send_message	message Nachricht * webhook Webhook-URL (sonst aus den Einstellungen)	Taste

* ist ein Pflichtfeld.

• Mikro stumm/laut, Ton stumm/laut: Verbunden wird gelesen, was gerade gilt, und umgekehrt. Ohne Verbindung geht das Kürzel hinaus.
• Mikrofon-Pegel setzen, Ausgabe-Pegel setzen: 0 bis 100, beim Schieberegler vom Regler. Nur mit Verbindung. Ohne sie: „Dafür braucht es die Verbindung zu Discord - ein Tastenkürzel kann das nicht“.
• Sprachkanal verlassen: nur mit Verbindung.
• Beliebiges Discord-Kürzel: drückt jede Tastenkombination. Für alles, was du in Discord auf ein Kürzel gelegt hast.
• Nachricht in Kanal posten: über den Webhook, siehe oben.

Zustand auf der Kachel und Widget

• Mikro stumm/laut leuchtet, wenn dein Mikrofon stumm ist. Ton stumm/laut leuchtet, wenn du taub geschaltet bist. Das gilt nur mit Verbindung. Wer nur Tastenkürzel benutzt, schickt ins Blaue: Was aus dem Mikro wird, sieht niemand nach. Eine Kachel, die das Gegenteil zeigt, wäre schlimmer als eine dunkle.
• Das Widget Discord-Sprachkanal zeigt wer im Kanal ist, wer gerade redet und wer stumm ist. Es braucht die Verbindung. Ohne Verbindung steht dort nichts. Wer verbunden und in keinem Kanal ist, sieht „niemand“. Das ist eine Auskunft, kein Fehler. Die Namen sind die, die Discord im Kanal selbst zeigt (Servername vor Anzeigename vor Kontoname).

Widget	Größe (Zellen)	Felder
Discord-Sprachkanal	2 × 3	—

Wie Widgets auf das Display kommen, steht unter Das Display.

Wenn Discord die Verbindung ablehnt

Die Steuerung des Discord-Programms (rpc, rpc.voice.read, rpc.voice.write) gibt Discord nicht an jede Anwendung frei. Ohne Freigabe durch Discord dürfen diese Rechte nur der Besitzer der Anwendung und bis zu 50 eingetragene Tester (im Entwicklerportal unter App Testers) nutzen. Alle anderen bekommen invalid_scope. Das ist eine Regel von Discord, kein Fehler der Software.

Die einfache Anmeldung (wer du bist) ist davon nicht betroffen und steht jedem offen. Auch ohne Freigabe bleiben dir:

• die Tastenkürzel für Mikro und Ton,
• der Webhook zum Posten.

Betreibst du die Software mit einer eigenen Discord-Anwendung, trägst du dich im Entwicklerportal unter App Testers ein. Die Client-ID gehört der Anwendung und steht nicht in diesem Formular.

Gut zu wissen

• Das Plugin ist bei einer frischen Installation aus.
• Es erkennt über den Prozess Discord.exe, ob Discord läuft.
• Discord sitzt hinter Cloudflare, das Anfragen ohne brauchbare Kennung abweist (403 error code: 1010). Die Software sendet deshalb einen eigenen User-Agent.