Lists

What this page is

Lists holds the lists you show in OBS — "a running line or a column. Several lists in one place — each with its own content, format, speed and look". Every list in the table carries its own link, so two lists can sit in different places on the screen at the same time.

The section used to be called Ticker: a running line is now one of the formats rather than the point of the module.

How to set it up

1. Open Lists. Press Create widget — the list appears named New list and opens straight away.
2. The editor opens on Text. Source decides where the content comes from:
   • My own text — the phrases you type. Phrases is one box for all of them: "One phrase per line. They run in a loop, one after another."
   • Top donors — who gave the most, counted by the app itself. Period is this stream, last 24 hours, last 7 days, last 30 days, last year or all time, and How many to show sets the length. Amounts come in your base currency.
   • Carousel challenges — the cards your carousel can drop, so viewers see what they are donating for. Colour by rarity paints each card in its group's rarity colour, and Shuffle the order mixes them.
3. Separator is picked from a list — a dot, a dash, a bar, a middle dot, a diamond, a star, No separator, or Custom with a box of your own. "Shown between phrases."
4. Open Motion. Format is Running line or Column.
5. For a running line, Direction is to the left or to the right. For a column it is no movement, downwards or upwards — a long column can scroll on its own.
6. A column also asks Rows in frame: "How many rows fit the OBS source. The rest scroll past." The source in OBS has a fixed height, so this decides where the list is cut.
7. The Speed slider runs from 10 to 400 px/s: "pixels per second: the higher the value, the faster the list moves."
8. The rest of the left column is the look. Backdrop — Background Color, Vertical Padding, Corner Radius, Bar Border, Shadow and Glow. Font and color — Text Color, Font Size, Font, Font Weight, Text Case, Letter Spacing, Text Shadow. Separator and gap — Separator Color and Gap Between Phrases, which is also the gap between rows of a column.
9. Styling above that list changes the whole look at once: the built-in Neon, Minimal and Retro, plus templates of your own. The same three looks exist in every overlay and use the same colours, so applying Neon everywhere gives one picture. Apply applies the chosen one, the name field with Save stores the current look, Delete removes a template.
10. The preview above the settings keeps running while you edit: "The preview runs at the real speed. Its width matches this box, not the stream — in OBS the list is as wide as the source."
11. The name of the list is the field in the editor header, next to Back to list.
12. Press Save. Back to list leaves without saving, and Reset Customization drops the look you built.
13. In the table each row shows what it holds, followed by its link and the Copy button. That link goes into a Browser Source in OBS.
14. The switch at the left of the row (Enabled) takes a list off the screen without deleting it. The overlay clears itself, so the source in OBS needs no reloading.
15. Duplicate copies the list together with its content and its look. Delete asks first: "List "{name}" and its design will be deleted. Its OBS link will stop working."

What it cannot do

• Top donors and Carousel challenges need the parts that feed them. The carousel source is hidden when the carousel module is not installed, and top donors stay empty until someone has actually donated.
• Top donors are summed in your current base currency. If you changed the base currency at some point, donations counted in the old one are left out — they cannot be added to the new ones without inventing a rate.
• Carousel challenges show the card text only: no rarity name, no chance, no price.
• One phrase takes one line of the box. A phrase cannot be wrapped over two lines, and blank lines are dropped.
• Your own phrases run in the order they are written and go round forever. Shuffle the order works for carousel challenges only.
• Speed takes nothing below 10 or above 400 px/s.
• Colour, font and size belong to the whole list: single words cannot be styled apart, and text is shown exactly as typed. The one exception is Colour by rarity, which paints carousel cards by their group.
• Where the list sits and how wide it is come from the Browser Source in OBS — in OBS the list is as wide as the source.
• Lists are not grouped: each one is its own link, and they do not queue or wait for one another.