In this step by step guide I will walk you through the setup of this application. I won't talk about how to install OBS or the required obs-websocket plugin. These have their own guides.
1. Preparation/requirements:
- Install OBS.
- Install obs-websocket.
- Make sure Java 8 (or greater) is installed.
2. Installation of OBS Scene Timer on the same computer as OBS:
EXE application
- Download the latest version of obs-scene-timer.exe file from obs-scene-timer on BitBucket.
- Run OBS Scene Timer by double-clicking this obs-scene-timer.exe file.
JAR application
- Download the latest version of obs-scene-timer.jar file from obs-scene-timer on BitBucket.
- Run OBS Scene Timer by double-clicking this obs-scene-timer.jar file.
If you work from the command line, run: java -jar obs-scene-timer.jar
- If on Linux: you might need to make it executable first, by running chmod +x obs-scene-timer.jar in the same directory as the file.
- If on Windows: the application will run without requiring any additional actions from the user.
3. Setup OBS Scene Timer configuration:
- Run OBS Scene Timer and go in the menu to File -> Settings
- Edit the configuration values to suit your needs.
If you are running OBS Scene Timer on another computer as OBS itself, than you must set the right IP address:
- Edit the value OBS websocket address to: ws://localhost:4444 and replace localhost in this value with the correct IP address of the computer on which OBS is running.
- Hit Save and restart OBS Scene Timer
4. Use the application: Prepare for streaming:
- Start OBS.
- Run OBS Scene Timer by double-clicking this obs-scene-timer.exe or obs-scene-timer.jar file.
- When the connection to OBS is successful, all scenes will be loaded in OBS Scene Timer.
- For each scene, a time limit can be specified by entering a number in the input box right of the scene name. This number is the time limit for the scene in seconds.
- Hit 'Tab' or click on another box to make sure the new value has been loaded. This value will also be saved to the configuration (user.properties file) almost immediately.
- If you don't want to specify a time limit for a scene, just leave the value at 0 and no countdown will be shown.
5. Use the application: During streaming:
- Make sure OBS and OBS Scene Timer are running, otherwise execute steps 4.1 and 4.2 from Use the application: Prepare for streaming
- Now, the current active scene in OBS will be displayed in the main window in OBS Scene Timer. You will see a timer counting up and the current active scene name displayed at the top of the window.
- Whenever the active scene changes in OBS, OBS Scene Timer will react on this by restarting the timer from 0 and also displaying the new active scene name at the top of the screen.
- When a time limit/duration greater than 0 is specified for the current active scene, a countdown will also be displayed. When this countdown reaches zero, this means the scene has reached it's time limit. Visual warnings will be showed in OBS Scene Timer.
OBS Scene Timer will not change anything in OBS itself. It will only request information about the current active scene and the scene list.