Read Me

This little program started out as a tool for a streamer friend who needed a way to automatically display his current stream game and stream title in OBS. (instead of manually editing the text field in OBS) . this was achieved by calling the twitch API retrieving the game and title and writing it to 2 files. ( streamgame.txt and streamtitle.txt) these 2 files can then be read in by OBS and will automatically update whenever the game and stream title are changed in the twitch dashboard.

While it still has this feature, it has since grown a little bit.

i personally use it to check if my fav streamers are online and see what they're playing, as well as who is watching. i then have the option to watch the stream by clicking the watch button. depending if 'VLC' or 'browser' is checked, it'll open the stream in vlc or the default browser.

NOTE: to use VLC, streamlink needs to be installed, as well as the latest VLC. 

streamgame.txt and streamtitle.txt files will appear in the directory where the stream monitor executable (streaminfo.exe) is located.

INSTALLING
==========
just unzip the files in a folder and that's it. 

UPGRADING
=========
overwrite the old install with the files in the zip. Or, if you want to retain the old version, unzip the files in a new folder. the 'favstreams.txt' file can be copied over from the old install to restore the list of your fav streamers


CONFIGURATION
=============
by default daafies' stream monitor is configured to view streams in the default webbrowser. no configuration is needed for this. 


However, to use VLC instead of the browser, you'll need to install VLC and streamlink first. Then in settings, set the streamlink path to point to the streamlink.exe, e.g D:\Program Files (x86)\Streamlink\bin\streamlink.exe

you'll also need to authorize streamlink to use your twitch account to watch streams. To do this, click the 'get OAuth' button. This will open a browser windows where you can 'Authorize' streamlink to use your twitch account. When authorized you'll be presented with the twitch OAuth token. copy/paste this token into 'OAuth token' field next to the 'get OAuth' button.  

press 'OK' to save the new configuration.     

you are now ready to watch streams in VLC. 


CUSTOM OPTIONS
==============
for advanced users, there is a custom command line options box. 
2 things to note. 
	1) you HAVE to pass in the oauth-token inside this custom options box. even if you've done the configuration steps above. 
	2) use %streamname%  as wildcard for the stream you want to watch. the stream monitor will replace %streamname% with the actual stream name.
	
here's an example of a custom option box (note, you leave out the call to the streamlink executable. you only enter whatever comes after it)

	-p "C:\Program Files\VideoLAN\VLC\vlc.exe --width=600 --height=340 --file-caching=5000 --meta-title=%streamname%" --twitch-oauth-token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx twitch.tv/%streamname% "480p, 360p, best, 720p60, 1080p60"

internally this will result in the following command, when trying to watch bobross stream:

	streamlink.exe -p "C:\Program Files\VideoLAN\VLC\vlc.exe --width=600 --height=340 --file-caching=5000 --meta-title=bobross" --twitch-oauth-token xxxxxxxxxxxxxxxxxxxxxxxxxxxxxx twitch.tv/bobross "480p, 360p, best, 720p60, 1080p60"

for more details on streamlink and vlc command line options, refer to their documentation.