﻿TwitchControl v 1.21 (English help below) Mar. 2020
Hilfe Deutsch

TwitchControl ist ein Freewaretool, mit dem man bequem die Channel-Parameter "Titel" und "Game" seines
Twitch - Kanals ändern kann, ohne die Webseite zu öffnen.

ACHTUNG!: Wegen eines geplanten Updates der twitch-API ist es möglich, dass dieses Programm nach dem 20. April 2020 nicht mehr funtioniert. In diesem Fall prüft 75r.de/software immer wieder nach einem Update.

INSTALLATION:
Den Inhalt des zip-Files in einen Ordner kopieren und ggf. eine Verknüpfung zu TwitchControl.exe erzeugen.
[curl.exe wird nur intern vom Programm benutzt.]
TwitchControl.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.
Es kann hierbei zu IE-Javascript Fehlermeldungen kommen. Diese ggf. ignorieren. (Ab v1.20 sollten keine mehr kommen).
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.
Hierzu den Button "Save Token" klicken.

Hiernach ist es empfohlen, TwitchControl neu zu starten, denn dann werden Beispiel-Presets erzeugt.

Es sind fünf Beispielpresets enthalten, die auf der linken Seite in einer Liste aufgelistet werden.
Wird ein Preset angeklickt, erscheinen seine Einstellungen rechts in den Feldern "Preset Name", "Title" und "Game".
Diese können beliebig verändert werden und mit dem Button "Save" auf dem PC gespeichert werden.
Man kann einzelne Pressts mit dem Button "Delete" oder alle Presets auf einmal mit dem Button "Delete All"
löschen.

Der Button "Activate" übermittelt die eingegebenen Parameter "Title" und "Game" für den angegebenen Channel zu Twitch.
Wenn ein Firewall-Dialog auftaucht, der um Erlaubnis fragt curl.exe über das Netzwerk zu kommunizieren, dies erlauben.
Nach 2-3 Sek. wird der Erfolg der Übermittlung angezeigt.
Die Änderungen sind ab sofort auf dem Channel aktiv.
Falls ein Fehler auftritt, öffnet sich Notepad mit dem Twitch-Output.

Das Programm merkt sich die letzte Fenstergrösse und seine Position.
Alle Daten werden in der Registry unter HKCU\Software\TwitchControl gespeichert.

Leider gibt es keine Möglichkeit, die Channel-Sprache mit der Twitch-API einzustellen (oder ich habe sie nicht gefunden).

Um TwihcControl die Erlaubnis weider zu entfernen, seinen twitch-account zu verwalten, die Anmerkungen im Menü
"Help" - "Disconnect TwichControl from..." befolgen.

NEU (ab v1.21):
Angepasst für twitch API-version 5.
Kompatibilität des eingebauten Browsers verbessert (nur Anmeldug/Token).
Fehler "please fill out all 5 fields" behoben bei twitch - login.

NEU (ab v1.08):
GAME-SWITCHING PER STARTPARAMETER
Wenn TwitchControl mit einem Startparameter, der einem vorhandenem Presetnamen in Anführungszeichen entspricht, gestartet,
wird das entsprechende Preset ohne jegliche Ausgaben umgeschaltet, es gibt auch keine Fehlerausgaben.
[Fehlerausgaben sind in der Datei %temp%\out.txt festgehalten.]
- Das Preset mit dem entsprechenden Namen muss mit der normalen version von TwitchControl angelegt sein
- starte z.B.:
  Pfad_zum_Programm\Twitchcontrol.exe "CS GO"
  aus der Kommandozeile, einer Stapeldatei (.bat) oder aus Midikey2Key (http://75r.de/midikey2key)
- Der Presetname muss exakt dem gespeicherten entsprechen und in Anführungszeichen stehen, falls er Leerzeichen beinhaltet!


To do:
Logout von twitch, um einen anderen Account zu behandeln.

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
Download: 75r.de/software
=============================================================================================================
English help

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

ATTENTION: Due to a planned change of the twitch api it is possible, that this program will not longe work than
april 20th, 2020. In this case check 75r.de/software after some days.

INSTALLATION:
Copy the contents of the zip-file into a folder and make a shortcut to TwitchControl.exe if You wish.
[curl.exe is only used by the app internally.]
Start TwitchControl.exe.

At 1st start you will be redirected to a twitch-login-dialogue 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.
IE-javascript erros can occur, please ignore these.
Is Your login successfully and the app-authorization has been done, a "token" will be stored in Your registry,
which allows You to edit Your channel-settings.
To store the token, click "Save Token".

Now it is recommended to end and start TwitchControl again, so some example-presets will be generated.

There are 5 presets for demonstration in list on the left side. You just need to fill in Your channel-name (like it
appears in an URL like "www.twitch.tv/Your_Channel_Name") and save it.
When You click on a preset, it's settings appear on the right in the fields "Preset Name", "Title" and "Game".
You can change all of these and save it on Your PC with the button "Save".
You can delete single presets with the button "Delete" or all presets at once with the button "Delete All".

The Button "Activae" will submit the given parameters "Title" and "Game" and for the connected channel to Twitch.

If the windows firewall asks for allowing curl.exe to communicate thru networks, do so.
After 2-3 sec. You will get a confirmation of Your changes on twitch.
If an error occurs, notepad will open and show You twitch's response.

The program will store the last window position and -size.
All data are stored in Your registry under HKCU\Software\TwitchControl.

Unfortunately there is no way to manipulate the channel's language with the twitch-API (or I did not find it).

NEW (from v1.08):
GAME-SWITCHING BY START-PARAMETER
If TwitchControl is started with a start-parameter, which is a existing preset-name and surrounded by " when it contains whitespaces,
this preset will be switched silently without any output (even in an error case).
[You can check for errors in the file %temp%\out.txt.]
- The preset with this name must be created regularely wit6h TwitchControl
- start with i.e.:
  path_to_app\Twitchcontrol.exe "CS GO"
  from the command-line, a batch-file (.bat) or from Midikey2Key (http://75r.de/midikey2key)
- The presetname must be exactly equal to the one that was saved and must be surrounded by " if it contains whitespaces!


To do:
Logout from twitch to edit a different twitch-account.

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

Download: 75r.de/software
=============================================================================================================
CHANGELOG
-------------------------------------------------------------------------------------------------------------
Mar. 2020
v1.21
Fixed for twitch api-version 5
Better compatibility of built-in browser (for activation/token only)
Error "please fill out all 5 fields" fixed at twitch - login.
-------------------------------------------------------------------------------------------------------------
Jul. 2018
v1.08
Added response to startparameter for silently switching Games by commandline or MidiKey2Key
(see: http://75r.de/midikey2key)
-------------------------------------------------------------------------------------------------------------
Jul. 2018
v1.07
Fixed the problem "no authorisation-dialogue at first start"
-------------------------------------------------------------------------------------------------------------
Jan. 2017
v1.06
Fixed Problem when the files were copied into a path with whitespaces
(problems with whitespaces in the user's name are not tested yet and still possible. Please give feedback, if so.)