Docs › Tools › Confetti

Tools docs

Confetti overlay

Falling confetti over your stream, for New Year’s, Christmas, birthdays and any other celebration.

The overlay lets small pieces of confetti fall over your stream: rectangles, dots and long streamers that spin and tumble as they go. It is drawn by the page itself, with no pictures to download, over a transparent background. It needs no account and no key, and it asks no other service for anything. It is not tied to one holiday, so it suits any celebration at any time of year.

Build it

Open the Confetti builder, from the Tools page or from the Celebrations section of Seasonal tools. Both lead to the same builder. The preview at the top is the real overlay. Change a setting and it reloads a moment later. Copy URL and Open work as soon as at least one shape is ticked. See Add a tool to OBS for the browser source.

Christmas and New Year’s looks

The Christmas and New Year’s buttons fill in a set of colors, the shapes, the density and the speed in one go. Christmas is red, green, gold and white. New Year’s is gold, champagne, silver and white with a touch of violet, and is a little denser and faster. Party colors goes back to the starting look. A look is only a starting point: change any setting afterwards. The link you copy carries the plain settings, not the name of the look. A link such as /tools/confetti-builder.html?preset=christmas opens the builder with that look already filled in.

Colors

Piece colors
Up to six. Each piece takes one of them, picked at random. Use Add a color and Remove the last.

The fall

Shapes
Tick Rectangles, Dots and Streamers. All three are ticked to start, and at least one has to stay ticked.
Density
From 1 to 100. The start is 50. How many pieces are on screen at once, for the size of the frame. A bigger frame holds more pieces at the same density, up to a limit.
Speed
From 1 to 100. The start is 50. How fast the pieces fall. Each piece falls a little faster or slower than the others.
Direction
From 60 degrees left to 60 degrees right. The start is straight down. Which way the pieces drift as they fall. A piece that drifts out of one side comes back in at the other.

Landscape and portrait

The overlay works out how many pieces to show from the size of the browser source, so set the source to the size of your stream’s frame, such as 1920 by 1080 for landscape or 1080 by 1920 for portrait. In the builder, Landscape and Portrait only change the shape of the preview, and they are not part of the link.

Performance

Use it with other overlays

Confetti is its own browser source. It does not depend on any other seasonal overlay, so you can add it beside Fireworks, Event Countdown or any other overlay as separate sources and stack them in the order you like.

Advanced: change it in the link

Everything the builder does is a setting in the link after the #. Your browser does not send that part to our server. Only settings you change are written, so a link with no settings at all is the starting confetti.

SettingValuesStarts as
colorsup to six colors joined by dashes, such as ff4d6d-ffd23fpink, yellow, green, blue, violet
density1 to 10050
shapesany of r (rectangle), c (dot), s (streamer)rcs
speed1 to 10050
direction-60 to 60 degrees, negative drifting left0

A setting that is missing or not valid takes its start value, and a number outside its range is held to the nearest end of it. A value in colors that is not a color is skipped.