Twitch flashbang

Funny little app to torture streamers. Viewers donate, streamer go blind.

(WINDOWS ONLY!)

Made by me because I was bored and this sounded funny. My first REAL project :)

⚠️ PHOTOSENSITIVE EPILEPSY WARNING! ⚠️

If you suffer from photosensitive epilepsy and are prone to seizures, You probably shouldn't use this app.

IF YOU ARE A STREAMER OR YOUTUBER THAT PLANS TO USE THIS IN FRONT OF AN AUDIENCE, PLEASE PUT A WARNING SO PEOPLE KNOW WHAT HELL THEY'RE ABOUT TO EXPIRIENCE!

Install, game settings and recording settings

This app can be downloaded on the releases page here. I have yet to test recording and streaming the app so right now, you will have to figure it out yourself. To run this over games, the game will have to be set to borderless fullscreen as exclusive fullscreen does what its name suggests and overriding that is detectable (and even bannable) by most games. There is no exception to this rule :(

Capturing on OBS

To get started, make sure the flashbang overlay is active! Learn to do that here!

To capture the flash on obs, add another window capture and add the flashbang (null) window to winow capture and set the capture method to BitBlt (Windows 7 and up):

If you did it correctly, your screen on OBS should go completely black... Don't worry though! I have a fix for this! Right click window capture you just made, and select filters:

That should open up this window:

Now all you do is click the + icon at the bottom left, add a luma key filter and set the Luma Max and Luma Min Smooth options to 1.0. Set everything else to 0.0. If done right, your luma key window should look like mine:

And voila! The overlay is now invisible untill the flashbang is triggered! Now it should overlay any game properly without you needing to use display capture!

❗NOTE: MAKE SURE TO PUT THE OVERLAY WINDOW CAPTURE SOURCE ABOVE EVERYTHING. IF YOU WANT YOUR CHAT AND SUBSCRIPTION MESSAGES TO STILL BE VISIBLE THROUGH THE FLASH, PUT THEM ABOVE LIKE SO:

Usage

Upon opening the app (TwitchFlashbang.exe), you will be greeted by four different things:

• The donation handler (WIP). This is where you select what API you will be using to trigger the events in the app.
  • As of now, streamlabs is the only option.
• The SocketAPI token box. This is where you will put your SocketAPI token (You must be logged into streamlabs to access your SocketAPI token). The text box is censored so no one can see your token being entered incase you are setting this up on stream.
• The settings. This is where you select what events you want to trigger the flashbang.
• The Ready , Test flash and the flashbang queue.
  • The Ready button will enable the application and enable the overlay. This means the flashbang is now active!
  • The Test flash button is mainly used for debugging and checking how well the flashbang effect works on your machine. If you are expiriencing issues with the flashbang effect, please make an issue as this app hasn't been tested with screen resolutions over 1920 x 1080.
  • Finally, the app has a flashbang queueing system. This exists half as to not absouloutely violate the machine that the app is running on and half because its way easier to program as a bug failsafe. If an event is triggered whilst the flashbang is active, the queue will increase. If the queue is not zero, you will get flashbanged, one after the other untill the queue is reduced to zero.

Connecting your account

In order to connect your account, first go to https://streamlabs.com/dashboard/settings/api-settings. You should be greeted by the following page. You will want to click on the API tokens tab:

Next, copy your SocketAPI token:

And paste it into the SocketAPI token box:

Make sure not to add spaces or any unnecessary characters

Finally, Choose your desired events, select streamlabs as a donation provider and hit Ready:

❗NOTE: IF YOU DO NOT SEE THIS MESSAGE POP UP, YOU HAVE NOT BEEN CONNECTED TO STREAMLABS. RESTART THE APP AND FIGURE OUT WHAT YOU DID WRONG.❗

You can also test the streamlabs connection with the test buttons on your dashboard. If you do not go blind, you did something wrong.

HAVE FUN GOING BLIND! 💥

Privacy and security

This app requires a streamlabs SocketAPI token (NOT TO BE MISTAKEN AS THE access_token). Some of you may be concerned as to what this app can do to your streamlabs account through this token and you're correct for doing so. This token only gives the app access to read certain "events" that happen to your streamlabs account (Such as donations or subscriptions). If you want to know more about what data this app will take, look here. I also spoke directly to the streamlabs API support team and they clarify the safety of the token here:

(Of course, personal information has been censored)

Will I be banned for using this?

NO.

You will not be banned for using the app. The overlay will not inject itself into your apps but rather run as a seperate window over all your games. This is theoretically undetectable and wont get you banned because the app is treated as any ordinary window (because it is) but just to be safe, I've been doing a bunch of playtesting and haven't encountered any bans or warns.

NOTE: YOUR ANTIVIRUS MAY PREVENT THE APP FROM OPENING. THIS IS BECAUSE THE FILE ISNT VERIFIED YET OR SOMETI, YOU WILL HAVE TO WHITELIST THIS APP OR TURN ON YOUR ANTIVIRUS.

Issues, Bug reports and suggestions

If you find a bug with the app, have a suggestion or just have a general issue with the app, please create a new issue on the issues section with the appropriate tags. They will be reviewed, answered or resolved if they can. Please also provide evidence or examples to any issue or problem you may be having as it makes it infinitely easier to find and fix the issue.

Please avoid posting known issues as they probably will be closed on post. Here are a list of known issues:

• The flashbang overlay doesn't properly fit the screen
• The app locked at 60 FPS.
  • There might be an option to change this later but as of know, the flashbang effect is dependent on the framerate of the overlay. This is how the overlay works and I can't really do much about it (Note: If the Win32 version is developed, this may not be a limitation). If you're streaming or recording, 60 FPS should already be fine for your viewers as usually videos and streams aren't recorded at more than 60 FPS. If you're using a 60hz monitor, the flashbang effect may look a little choppy but otherwise, its still fine.