Subsection 5.5
5.5 Carousel
Notice: Note: Docs are currently being updated for v1.45.0.
Created Last edited
The carousel is a slideshow of your own images on a transparent background. It plays them one after another with a transition between each, and can run all the time or pop up every few minutes. Set it up on ⧉ Overlays → Carousel in the control panel. Each panel on that page has its own section below.
Ways to use it
- Sponsor and partner logos, rotating in a corner.
- Social media cards: your YouTube, Discord or TikTok handles.
- Event promos: an upcoming league race or charity stream, with start and end dates so it disappears by itself afterwards.
- Your branding: car liveries, team graphics or animated GIFs.
- A pop-up reminder: set it to appear every few minutes, play through once, then hide.
Preview
The Preview panel plays the carousel as it looks on stream, on a black background. Its title shows which image is on screen, or "No images yet". The preview keeps playing even while the overlay itself is hidden between appearances.
If an image hasn't reached its start date or has expired, a warning appears under the preview (and on the Dashboard).
Under the preview is the carousel's address, http://localhost:8767/carousel, with a Copy button. Add it to OBS as a Browser Source at 2560 × 1440. Everything around the images is transparent. On a 1080p canvas, scale the source down to fit.
Every copy of the overlay, the preview and the control panel follow the same clock, so they always show the same image.
Images
Click Add images… or drag files onto the panel. PNG, JPG, GIF and WebP work, up to 20 MB each. Animated GIFs play in full and start from their first frame each time they come up.
Each image in the list has:
- A status dot: green when it's in the rotation, red when it's off, hasn't started yet or has expired. The image on screen is marked ▶ ON SCREEN.
- Name: a label to help you find it. It's only shown in the control panel.
- Show: untick it to take the image out of the rotation without deleting it.
- Emphasis: tick it to make the image's edge stand out, then pick an effect (see Look).
- Start / end dates: tick it to show the image only between two dates. Off by default.
- ⠿ to drag it to a new place in the order, and ✕ to remove it.
Timing
- Transition: Crossfade (the default), slide left, slide right, slide up, slide down, zoom, blur, wipe, or cut (no transition).
- Time on screen per image: from 2 to 120 seconds. The default is 8.
- Transition length: from 0.2 to 3 seconds. The default is 0.9.
Show it every few minutes instead of all the time turns the carousel into a pop-up. It's off by default. Each time it appears, it starts from the first image, plays through, then hides.
- Show every: from 1 to 60 minutes. The default is 10.
- Each time, play all the images: once (the default), twice or 3 times.
While this is on, the panel shows when the carousel next hides and when it's back.
Size & position
Carousel size sets the frame the images play in:
- Landscape: 1920 × 1080, 1600 × 900, 1280 × 720 (the default), 960 × 540 and 640 × 360 (16:9), or 1200 × 900 and 800 × 600 (4:3).
- Portrait: 1080 × 1920, 720 × 1280, 540 × 960 and 405 × 720 (9:16), or 600 × 800 (3:4).
- Square: 1080 × 1080, 720 × 720 or 500 × 500.
- Custom size…: any width up to 2560 and height up to 1440 pixels.
Position puts the frame in one of nine spots: the corners, the middle of each edge, or the centre (the default). Distance from the edge sets the gap in pixels, 40 by default.
Move up / down and Move left / right nudge the carousel from that spot, for example middle right but a little higher, so you don't have to move the OBS source. Reset fine placement puts it back.
Images sets how each image fits the frame:
- Fit (the default): shows the whole image, with empty space if its shape doesn't match.
- Fill: fills the frame and crops the edges.
Look
- Rounded corners: from 0 (square) to 60 pixels. The default is 12.
- Opacity (the carousel only): from 10% to 100%, default 97%. This is separate from the other overlays.
- Emphasis colour: the colour used by the emphasis effects. The default is a bright blue.
Tick Emphasis on an image in the Images list to make its edge stand out, and pick one of these effects. They're kept subtle so they don't pull attention from the stream:
- Clean frame: a solid outline and shadow, with no motion.
- Soft glow: a halo that breathes very slowly.
- Pulse: the outline brightens every few seconds.
- Shimmer: a small highlight travels around the edge.
- Corner brackets: broadcast-style corners.
- Flash: a soft white flash now and then.
- Colour cycle: the outline slowly shifts colours, ignoring the emphasis colour.