Skip to content

A Browser overlay for OBS that plays a sound, shows a gif, and displays a list of new followers from Twitch!

License

Notifications You must be signed in to change notification settings

RemiCELLARD/twitch-alert-overlay

 
 

Repository files navigation

screenshot of stream alert overlay

Twitch Alert Overlay

A simple follower alert overlay for OBS that displays a list of the latest followers approximately every 60 seconds.

Parameters

login

Default joekombo. Enter the login name for a Twitch user.

volume

Default 25. Percentage from 0 to 100.

sound

Default guitar. Must match a filename found in docs/sounds

gif

Default guitarkitty. Positioned in the bottom left of screen. Must match a filename found in docs/images.

clientid

Required. Create an application at dev.twitch.tv and use that client id for clientid.

clientsecret

Required. Create an application at dev.twitch.tv and use that client id for clientsecret.

Example

https://joekombo.github.io/twitch-alert-overlay/?login=joekombo&clientid=[your client id]&clientsecret=[your client secret]

Testing notifications are working using another streamer name

Use another streamer's login name to test that notifcations are working. Example: login=summit1g

Note: Be patient. The notifications may take up to 60 seconds to show for the first time. Before going live change name back to your login!

Application Settings

I use the following application settings at dev.twitch.tv to obtain my Client ID and Secret. The Client ID and Secret can be found near the bottom.

screenshot of dev.twitch.tv settings

Run locally

Clone the project using git. And then change the directory to the project folder.

git clone https://github.com/joekombo/twitch-alert-overlay
cd twitch-alert-overlay

Install the depedencies using npm and use npm start to serve the files.

npm install
npm start

Go to web browser and view the page.

Example URL:

http://localhost:5000/?login=joekombo&clientid=[your client id]&clientsecret=[your client secret]

Note: Some browsers require permission to play sound. Click the tab and select allow audio/video.

OBS

Create a Browser source, input the URL, and then set the width to 1920 and height to 1080.

Contributions

To contribute changes, please fork the repository, make the changes, and then create a pull request! Thank you!.

Note: This project uses Prettier to format the code automatically when new code is commited. No additional steps are needed for this to work. More details about how this is setup is found here.

Issues

Something not working, or you're getting errors? Then please submit an issue.

About

A Browser overlay for OBS that plays a sound, shows a gif, and displays a list of new followers from Twitch!

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 65.9%
  • CSS 27.8%
  • HTML 6.3%