﻿TwitchControlN v2.0.2 (English help below) Jul. 2023
Hilfe Deutsch

TwitchControl ist ein Freewaretool, mit dem man bequem die Channel-Parameter "Titel", "Kategorie", "Sprache" und Tags seines
Twitch - Kanals ändern kann, ohne die Webseite zu öffnen. (Delay ist momentan noch nicht aktiv)

INSTALLATION:
Den Inhalt des zip-Files in einen Ordner kopieren und ggf. eine Verknüpfung zu TwitchControlN.exe erzeugen.
TwitchControlN.exe starten.

Beim ersten Start wird man in der App zu einem Twitch-Login-Dialog geleitet, wo man sich mit seinem Account anmelden
und die App autorisieren muss. Die Daten werden dabei ausschliesslich zu Twitch geschickt und nicht gespeichert.
Ist der Login erfolgreich und die Autorisierung erfolgt, wird ein "Token" in der Registry gespeichert, das es
erlaubt, die Channel-Setting mit der App zu verändern.

Hiernach ist es empfohlen, TwitchControl neu zu starten, denn es wurde ein Beispiel-Preset für "Fortnite" erzeugt.

Mit dem Button "New Preset" werden ggf. bereits ausgefüllte Felder gelöscht und man kann Daten für ein neues Preset eingeben.
Wird ein vorhandens Preset in der Liste angeklickt, erscheinen seine Einstellungen rechts in den Feldern "Preset Name",
"Stream Title", "Game", "Sprache", "Delay" und bis zu 10 Tags in schwarze Labels. Diese können beliebig verändert
werden und mit dem Button "Save Preset" auf dem PC gespeichert werden.
Man kann einzelne Pressts mit dem Button "Delete Preset" löschen, nachdem man sie in der Liste angeklickt hat.

Seit Twich-API v6 ist es nicht mehr möglich, einen Freitext für sein Spiel einzutragen. Es werden nur zugelassene
Spiele/Apps akzeptiert, deren Schreibweise man finden muss. TwitchControlN bietet hierfür 2 Methoden, die mit den
Radio Buttons "Wild but old / Exact Match" ausgewählt werden können. Dann klickt mat in das Feld "Game" und kann
Eingaben machen. Ergebnisse erscheinen in einem Popup-Feld automatisch oder nach Betätigen der ENTER-Taste.
"Wild but old" findet viele Spiele auch mit Teilstrings, es fehlen aber viele neue Titel. Bei "Exact Match"
wird alles gefunden, was in Twitch registriert ist, die Schreibweise muss aber absolut exakt sein. Die Twitch-API 
erlaubt leider keine Wildcards oder unvollständige Suchbegriffe.
Wird ein Spiel in der Liste doppelgeklickt, wird es übernommen. Dass es eine gültige ID hat, sieht man ander kleinen
Zahl über dem "Game" Eingabefeld.

Der Button "ACTIVATE" übermittelt die eingegebenen Parameter "Title", die Game_ID als Zahl, die Sprache und die Tags
für den angemeldeten User zu Twitch.

Wenn ein Firewall-Dialog auftaucht, der um Erlaubnis fragt, ob TwitchControlN über das Netzwerk zu kommunizieren,
dies erlauben. Nach ca. 1s wird der Erfolg/Misserfolg der Übermittlung angezeigt.
Die Änderungen sind ab sofort auf dem Channel aktiv. Um neue Tags zu sehen, muss man die Seite neu laden.
Falls ein Fehler auftritt, kommt eine ausführliche Fehlermeldung von Twitch.

Alle Daten werden in der Registry unter HKCU\Software\TwitchControlN gespeichert.

GAME-SWITCHING PER DESKTOP-SHORTCUT
-----------------------------------
Wird TwitchControlN mit einem Startparameter gestartet, der den Preset Namen enthält, wird das entsprechende Preset
ohne jegliche Ausgaben umgeschaltet. TwitchControlN startet hierbei unsichtbar und beendet sich danach.

Shortcuts zum versteckten Umschalten werden mit dem Menüpunkt "File" - Generate Quick - Shortcut of selected" erzeugt.
Der Shortcut auf dem Desktop hat ein transparentes Twitch-Icon und trägt den Namen des entsprechenden Presets.

Bekannet Probleme
Activieren mancher Spiele wie Battlefield 1 ergeben einen Error 400 ('Bad Requst').
Falsche game-ID? Bitte email an mich, wenn so etwas vorkommt!

To do:
- Prüfung, ob ein Desktop-Shortcut bereits besteht
- Tooltips
- Berechtigung für Dekay
- 'Clone Preset'
- 'Delete All Presets'
- Presetreihenfolge in der Liste änderbar machen
- Eingabemöglichkeit für bekannte game.IDs
- Nach Änderungen warnen, wenn nicht gespeichert

Kontakt: 77558@gmx.net (Der Abt), bitte Geduld mitbringen...
Folgt mir auf Twitter: twitter.com/der_abt
oder auf Twitch: wwww.twitch.tv/der_abt
75r.de/software
fs-addons.de
gtahack.de
midikey2key.de
=============================================================================================================
English help

TwitchControl is a freeware-tool, that can change the channel-parameters "title", "category" "language" and tags of Your
Twitch-channel quickly without using the twitch webpage.

INSTALLATION:
Copy the content of the zip-file into a folder and make a shortcut to TwitchControlN.exe if You wish.
Start TwitchControlN.exe.

At 1st start  a twitch-login-dialogue appears within the app. Here You can login with your
twitch-credentials and authorize this app to edit Your twitch-channel. The data are transfered directly to Twitch
and will not been stored.
Is Your login successfull and the app-authorization has been done, a "token" will be stored in Your registry,
which allows You to edit Your channel-settings.

Now it is recommended restart TwitchControl, since an example-preset "Fortnite" has been generated.

With the button "New Preset" already filed fields will be cleared and You can enter data for a new preset,
When You click on a preset, it's settings appear on the right in the fields "Preset Name", "Stream Title", "Game",
"Language", "Delay" and up to ten black Tag-Labels.
You can change all of these and save it on Your PC with the button "Save Preset".
You can delete single presets with the button "Delete Preset" after selecting it in the List.

Since Twitch-API version 6 it is not longer allowed to enter a free string for defining a game/app category.
You must choose a game from a pre-definde list. TwitchControlN has two methods to find these:
You choose a method using the radio-buttons "Wild but old / Exact Match". When enter a game/app name in the "Game"
field, a popup-field will appear, which shows the finds. You can force a search by using the ENTER key.

"Wild but old" can find many games using partial strings, but many new games are missing in this source.
"Exact Match" will find everything that is registered on Twitch, but it needs the EXACT spelling. There are no
wildcards and incomplete terms are not working (like with the other method).
When You doubleclick on a game in the list, it will be taken over and You can see it's valid game-ID as a small
number above the "game" field.

The button "ACTIVATE" transmitts "Stream Title", the Game-ID , the language and the tags to Twitch.

If a Firewall-Dialog appears, please click on "allow".
After 1s the success or failure will be shown in a messaegbox.
Changes will be present on the channel right away. To see new tags, the dashboard oage needs to be reloaded.

All data are stored in the registry in HKCU\Software\TwitchControlN.

GAME-SWITCHING BY DESKTOP-SHORTCUT
----------------------------------
When TwitchControlN is started with an argument that represents an existing preset-name, it will activate this preset
on twitch directy and invisible.
Shortcuts for this quick-switching can e generated on the desktop by using the menu "File" - Generate Quick - Shortcut of selected".
Shortcuts appear with an transparent Twitch-Icon and are named like the preset they are made for.

Known issues
Activating some games like Battlefield 1 run into an error 400 ('Bad Requst')
Wrong game-ID? Please report!

To do:
- check, if desktop-Shortcut allready exists
- Tooltips
- 'Clone Preset'
- 'Delete All Presets'
- Make the preset-order changeable
- Field for a known game-id
- After changes warn when not saved

Contact: 77558@gmx.net (Der Abt), please be patient...
Follow me on Twitter: twitter.com/der_abt
or on Twitch: wwww.twitch.tv/der_abt
75r.de/software
fs-addons.de
gtahack.de
midikey2key.de

=============================================================================================================
CHANGELOG
-------------------------------------------------------------------------------------------------------------
Jul. 2023
v2.0.1
Initial new relase