Skip to content

Easily slide images from the top, bottom, left, or right side of the screen

License

Notifications You must be signed in to change notification settings

CrashKoeck/OBS-Image-Slider

Repository files navigation

OBS-Image-Slider

Easily slide images from the top, bottom, left, or right side of the screen in OBS Studio (or any other broadcasting software)

Crash on the interwebs
Twitter | Twitch | YouTube | Patreon | Discord


Setup

  • Download the latest Source Code (zip) file from this page
  • Extract the zip file on your computer
  • Replace image.png with your image (be sure to rename your image to image.png)
  • Set how long you want the animation to last in the slide_duration_in_seconds.txt file (in seconds)
  • Add one of the 4 HTML files as a Browser Source in OBS Studio (or whichever broadcasting software you are using). The different file names indicate which edge the image will slide in from
    • slide-from-bottom.html
    • slide-from-top.html
    • slide-from-left.html
    • slide-from-right.html
  • In the Browser Source properties (near the bottom), be sure to check Shutdown source when not visible and Refresh browser source when scene becomes active

How to use

If you've done everything properly in the Setup section, all you have to do it turn on or off the visibility of the browser source for it to work

NOTE: This will not work in Chrome/Firefox/etc. It is only designed to work in broadcasting software


Ways to use this

  • You can have the browser source always visible on a specific scene so whenever your switch to that scene, it will automatically activate the slider
  • You can set up a Stream Deck Multi-action to activate the browser source, delay for however many seconds you'd like, then deactivcate the browser source when the animation is complete. For example, if you put 10 in slide_duration_in_seconds.txt, the delay you'd put in the Stream Deck Multi-action should just be a bit more to make sure the animation completes smoothly, so 10500 would be 10.5 seconds, giving an extra 0.5 seconds for the animation to complete smoothly.

Misc. Details

  • The image will automatically centre on the screen. If it slides from one of the side, it will centre vertically. If it slides in from the top or bottom, it will centre horizontally
  • The image will automatically scale to never be larger than the screen size
  • The animations are 100% CSS
  • The image is eased in, meaning it will accelerate and decelerate to make it smoother
  • With timing, the frist 25% of the duration will be sliding in and the last 25% is sliding out. So, a 4 second duration will be 1 second sliding in, 2 seconds still, 1 second sliding out

Future Plans

  • Instead of multiple HTML files, you will be able to choose which direction you want to move in a configuration file
  • Exe file for easy configuration that will allow you to enter duration in seconds, how long slide in is, how long slide out it, choose direction for slide, and image selection

Support