The overlay hangs an evergreen garland on your stream: swags of pine with strings of lights, glossy ornaments, bows and red berries. It goes along the top edge, across the four corners or all the way round the frame, and the middle of the picture is always left clear. 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.
Build it
Open the Christmas Garland builder from the Christmas & Winter section of Seasonal tools. The preview at the top is the real overlay on a checkerboard, so you can see where it is clear. Change a setting and it reloads a moment later. See Add a tool to OBS for the browser source.
Looks
Each button under Start from a look fills in every setting, and you can change any of them afterwards. Classic Christmas is a full swag along the top with red, gold and blue ornaments and twinkling colored lights. Winter Frost goes all the way round the frame in icy blue and silver, with glitter ornaments and no berries. Red and Gold hangs a swag across each corner in red and gold with steady warm lights. Woodland is a thick garland along the top with matte ornaments in earthy reds, amber and green and slowly twinkling amber lights. Opening the builder with ?preset=classic, winterfrost, redandgold or woodland after its address starts from that look.
Placement and fullness
- Placement
- The start is the top edge: one garland along it, hanging in swags. Corners hangs a swag across each of the four corners. Whole frame runs a garland along all four edges, pinned where they meet at the corners. However it is placed, the middle of the frame is never decorated.
- Fullness
- From 1 to 100. The start is 60. How thick and leafy the garland is, and how many ornaments and berries it carries.
Lights, ornaments, bows and berries
The pine stays where it is whichever of these you turn off, and turning one off never moves another.
- Lights
- On to start. A thin wire weaves along the garland with glowing bulbs spaced along it.
- Ornaments
- On to start. Glossy balls hang on short strings, kept apart from each other and from the bows. Along the bottom edge, where a hanging ball would leave the frame, they sit on the garland instead.
- Bows
- On to start. A bow sits at the low point of each swag.
- Berries
- On to start. Small clusters of red berries sit in the greenery.
- Ornament style
- Classic is glossy with a bright highlight. Glitter is less glossy and covered in small sparkling specks. Matte has almost no highlight.
- Color accents
- Classic is red, gold and blue ornaments with multicolored lights and a red bow. Winter frost is icy blue, silver and lilac with cool white lights. Red and gold is red and gold with warm lights. Woodland is earthy red, amber and green with amber lights.
- Light pattern
- Twinkle to start: each bulb swells and fades at its own pace and never goes fully dark. Steady keeps every bulb at full brightness.
- Twinkle speed
- From 1 to 100. The start is 40. It is not used with steady lights or with the lights off.
Opacity and brightness
- Opacity
- From 5 to 100. The start is 100. How see-through the whole garland is.
- Brightness
- From 0 to 100. The start is 50, which leaves the colors as drawn. Lower is darker and higher is lighter.
Landscape and portrait
The overlay works out its garland for 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. How thick the garland is and how big the decorations are follow the frame's shorter side, so a landscape frame and a portrait frame are decorated alike, and a portrait frame has fewer swags along its top and more down its sides. In the builder, Landscape and Portrait only change the shape of the preview, and they are not part of the link.
Performance
- The pine, the ornaments, the bows and the berries are drawn once when the source loads and when its size changes, not on every frame.
- The picture is drawn at no more than twice the size of the page and no more than a fixed number of pixels, which a very sharp phone screen would otherwise make heavier than the garland needs.
- The number of sprigs, ornaments, berry clusters and bulbs never passes a fixed limit, however long the edges are.
- Only twinkling lights move. Their frames stop while the page is hidden, such as a browser source that is not shown, and carry on when it is shown again. A viewer whose system asks for less motion sees the lights still.
Use it with other overlays
Christmas Garland is its own browser source. It does not depend on any other seasonal overlay, so you can add it beside Snowfall, Christmas Lights or Frosted Edges as separate sources and stack them in the order you like. If you add Christmas Lights as well, turn off the lights here so the two strings do not cross.
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 garland.
| Setting | Values | Starts as |
|---|---|---|
placement | top, corners or frame | top |
fullness | 1 to 100 | 60 |
lights | 0 to turn off | on |
ornaments | 0 to turn off | on |
bows | 0 to turn off | on |
berries | 0 to turn off | on |
style | classic, glitter or matte | classic |
accent | classic, frost, gold or woodland | classic |
anim | steady or twinkle | twinkle |
speed | 1 to 100 | 40 |
opacity | 5 to 100 | 100 |
brightness | 0 to 100 | 50 |
A setting that is missing or not valid takes its start value, and a whole number of up to four digits outside its range is held to the nearest end of it.