Operator guide

Wiki

Simple guide to every setting and control in Name Drop.

Quick start

Open Admin and fill in your giveaway name and keyword.
Add a Twitch channel and/or the YouTube Live Chat pop-out URL, then save.
Press Start collecting so viewers can enter by typing the keyword.
Add the OBS Overlay page as a Browser Source in OBS.
When you are ready, stop collecting, press SELECT on the overlay, and check Winners.

Giveaway / competition name: The title shown on the admin page and on the OBS overlay. Use something viewers will recognise, like “Headset giveaway”.
Entry keyword: The exact word viewers must type in chat to enter. Matching is case-insensitive, so “WIN” and “win” both count. Keep it short and unique.
Twitch stream URL or channel: Your Twitch channel name or full URL (for example https://twitch.tv/yourchannel). Name Drop reads public chat anonymously — no Twitch login is required.
YouTube Live Chat: Paste the Live Chat pop-out URL from YouTube Studio each time you go live (for example https://studio.youtube.com/live_chat?is_popout=1&v=…). A normal watch/live URL or bare video id also works. Name Drop reads the video id from the link and resolves the active chat automatically. Needed only if you want YouTube chat entries.
YouTube API key: A Google API key that can call the YouTube Data API. Required to poll YouTube chat. Leave blank if you only use Twitch.
OBS overlay labels: Rename the on-stream bar wording: entries label, winner label, Select / Continue button text, and the pool count suffix (e.g. “in pool”). Defaults match the original overlay copy.
Box colour: Fill colour of the OBS lower-third bar. Default is dark charcoal #282828. Use the colour picker or type a hex value, then save — the overlay picks it up on the next refresh.

Press Save settings after any change so collection and the overlay use the new values.

Start collecting: Turns the pool on. Chat messages that contain the keyword are added as entrants (one entry per username).
Stop collecting: Pauses new entries. Use this before you draw so the pool stays fixed.
Entrants / Winners counters: Live counts of people in the current pool and winners already picked for this giveaway.
Open OBS overlay: Opens the lower-third page you add as a Browser Source. The page uses a solid blue background for chroma key in OBS.
Winners list: Opens the winners page so you can review who has already been selected.
Clear entrants: Empties the current pool but keeps winners and settings. Useful between rounds of the same giveaway.
Reset entrants + winners: Clears both the pool and the winners list. Settings stay in place.
Manual entry: Type a username and press Add to put someone in the pool without chat — handy for testing or DM entries.

Add a Browser Source pointing at your site’s /overlay URL (for example https://yoursite.example/overlay).

Blue screen background: The page is solid pure blue (#0000FF). In OBS, enable a Chroma Key filter on the Browser Source and key out blue so only the lower-third box remains.
Floating lower third: The bar sits as a rounded box near the bottom centre — not stretched edge to edge — so it reads as a floating lower third. Its fill colour is set under Admin → Box colour (default #282828).
Custom labels: Entries / winner labels, Select / Continue button text, and the pool suffix are editable in Admin so the bar wording matches your show.
SELECT button: Runs a fast rolodex spin: names scroll down until a random entrant is picked. That name is removed from the pool, added to winners, and shown in yellow until you press Continue. Needs at least one entrant. Button text is customisable.
CONTINUE button: Appears after a winner is selected. Clears the yellow winner highlight and returns the overlay to the scrolling entrant list so you can draw again. Button text is customisable.
Pool count: Shows how many people are still eligible on the overlay (number + your pool suffix).

Winners list: Names selected from the raffle, newest first, with the time they were picked.
Reset winners: Clears only the winners history. Entrants in the pool are left alone.