Docs › Tools › Christmas Garland

Tools docs

Christmas Garland

An evergreen garland along the top, the corners or the frame of your stream.

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

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.

SettingValuesStarts as
placementtop, corners or frametop
fullness1 to 10060
lights0 to turn offon
ornaments0 to turn offon
bows0 to turn offon
berries0 to turn offon
styleclassic, glitter or matteclassic
accentclassic, frost, gold or woodlandclassic
animsteady or twinkletwinkle
speed1 to 10040
opacity5 to 100100
brightness0 to 10050

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.