TWITCH YOUTUBE DLL REQUIRED OBS Meld

GIVEAWAY

A Streamer.bot extension to create giveaways on Twitch. Includes an overlay and dock for OBS and is extremely customizable.

Included overlay and dock for OBS
Display win chances
Set various requirements
- Followage, Watchtime, Loyalty Points
Extremely customizable

Quick Access

Copy what you need to get started. Follow the setup guide below for detailed instructions.

Action Import String

Import the actions into Streamer.bot.

Loading…

Overlay & Dock URLs

If you want, you can add a browser source overlay and/or a dock to your streaming software like OBS. Check the preview here

Overlay

A browser source overlay that displays the current giveaway state and all their participants.

https://tawmae.xyz/overlays/giveaway-overlay

Dock

A browser source dock that you can add as a custom dock in OBS or use in a browser. Allows to quickly manage giveaway and participants.

https://tawmae.xyz/overlays/giveaway-dock

Setup Guide

Copy the Action Import String

Copy the Action Import text from Quick Access.

Import the actions into Streamer.bot

In Streamer.bot click Import in the top menu. Paste the text into the Import String field. Click Import at the bottom.

Enable the commands

Open the Commands tab. Find the imported group. Right-click the group and click Enable All.

Open the Settings UI once

Open the action [GIVEAWAY] 0 - Settings. Right-click the Test trigger and hit Test Trigger. Click Save.

NoteIf the TawmaeUI.dll is missing, you’ll be asked to auto-download. That popup window may appear behind the Streamer.bot window, so make sure to check if nothing appears.

Start WebSocket Server

If you want to use overlay and/or OBS dock, go to the tab Servers/Clients → WebSocket Server. Enable Auto Start WebSocket Server. Address 127.0.0.1. Port 8080. Optional password. Leave Enforce All Requests unchecked. Start the server.

Copy Browser Source URL

Copy the Browser Source URL from Quick Access.

Add Browser Source in OBS

In OBS, create a new Browser Source, name it whatever you want. Then paste the copied URL into URL and set the Width and Height to your OBS canvas size (e.g. 1920x1080)

NoteIf you want to have the browser source in multiple scenes, don't create a second browser source. Instead, use nested scenes or source clones.

Copy Dock URL

Copy the Dock URL from Quick Access.

Add Custom Dock in OBS

In OBS, in the menu bar, click on Docks -> Custom Browser Docks. In an empty row, enter any name and paste the copied URL into URL in there. Then you can place the dock anywhere in your OBS layout.

NoteIf you don't want it in OBS, you can also open it on any browser.

Done!

You can now customize everything and use the commands and the dock to create and manage your giveaways!

Overlay & Dock

Overlay

A browser source overlay that displays the current giveaway state and all participants on your OBS canvas (or Meld, whatever).

Browser Source URL:
https://tawmae.xyz/overlays/giveaway-overlay

Dock

You can either add this URL as a custom OBS dock or open it in a browser to quickly manage your raffles, instead of resorting to commands like a caveman or cavewoman.

Dock URL:
https://tawmae.xyz/overlays/giveaway-dock

Commands

User Commands

!enter <Entry Count (optional)> Access Everyone: Enter the giveaway. Allows to enter the number of entries you want to use, which is optional. Entering no number either adds 1 entry or the max. possible entries, depending on your settings.

Example!enter 5
!giveaway Access Everyone: Posts the info about the currently active giveaway into chat.

Example!giveaway

Mod Commands

!startGiveaway <Title (optional)> Access Mods Only: Start a giveaway. You can enter a title, but you don't have to.

Example!startGiveaway Witcher 3 Steam Key
!pickWinner Access Mods Only: Picks a random winner.

Example!pickWinner
!lockGiveaway Access Mods Only: Locks the giveaway and prevents users from entering.

Example!lockGiveaway
!unlockGiveaway Access Mods Only: Unlocks the giveaway and allows users to enter again..

Example!unlockGiveaway
!endGiveaway Access Mods Only: Ends the giveaway without clearing the overlay. This does not refund loyalty points.

Example!endGiveaway
!cancelGiveaway Access Mods Only: Cancels the current giveaway. This will refund any invested loyalty points.

Example!cancelGiveaway
!clearGiveaway Access Mods Only: Ends the giveaway and clears the overlay. This does not refund loyalty points.

Example!clearGiveaway

Settings UI

General

Configure some general stuff, idk what to write.

Time Limit Toggle whether to enable a time limit when creating the raffle (in seconds). Once the time has run out, it will automatically lock the giveaway. You can still always unlock it afterwards.
Remove Picked Winner From List Toggle whether to remove a picked winner from the participants list, so they can't win again. This will still keep them in the overlay though, so you can see all previous winners.
Time To Claim Win When picking a winner, you can put them on a countdown to actually claim their prize. Time in seconds. If they fail to claim, you can pick a new winner.
Auto-Max Entries When typing '!enter', it adds a single entry by default. Enabling this will default to the max. possible entries instead. So if a user has 5 possible entries, it will fill all 5 entries without specifying a number. Accounts for loyalty points balance too.
Followers Only Toggle whether to only allow followers to enter and set the days of minimum followage.
Points Price You can set a loyalty points price for entries. Requires my TWITCH POINTS extension to be installed.
Watchtime Toggle whether only users with a minimum watchtime are allowed to enter a giveaway. Requires my extension TWITCH WATCHTIME to be installed. Watchtime in minutes.

Entries

Configure the max. entries for each user group and their priority.

Max. Entries Regular users, subscribers and VIPs can have different max. possible ticket counts. So for example regulars get 1 entry, Tier 1 subs 2 and VIPs 3. If a user has multiple roles, like a VIP who also is a Tier 1 sub, you can scroll down to the priority list and change their order. So if you move VIP above Tier 1 Subscribers, the subbed VIP will get the VIP entry count and vice versa.

Appearance

Change the appearance of the OBS overlay (not the dock).

Various I'm too lazy to write down every single appearance property, but it should be self-explanatory. Font, colors, texts, scrolling etc. pp. Hit 'Save' to apply the settings.

Chat Responses

Edit chat responses. Use a single hyphen to not post a message. Allows to use variables that are listed below each textbox. Reset to default by clicking the icon on the right.

Custom Triggers

Giveaway Started

Fires when a new giveaway is created.

%title% Type: string: The title of the giveaway.
%durationSeconds% Type: int: Duration of the giveaway in seconds.
%pointsCost% Type: int: The cost in points to enter (0 if free/disabled).
%pointsEnabled% Type: bool: Indicator if points are required to enter.
%createdBy% Type: string: The display name of the user who started the giveaway.

Giveaway Entered

Fires when a user successfully enters the giveaway.

%user% Type: string: The display name of the user entering.
%userId% Type: string: The Twitch User ID of the user.
%userName% Type: string: The login name (username) of the user.
%entries% Type: int: The user's total entries after this action.
%entriesAdded% Type: int: The specific amount of entries added in this action.
%maxEntries% Type: int: The maximum entries allowed for this specific user.
%winChance% Type: double: The user's probability of winning (percentage).
%title% Type: string: The title of the giveaway.
%totalParticipants% Type: int: Total number of unique participants.
%totalEntries% Type: int: Total number of entries in the giveaway.

Giveaway Winner Picked

Fires when a winner is selected.

%winner% Type: string: The display name of the winner.
%winnerUserId% Type: string: The Twitch User ID of the winner.
%winnerUserName% Type: string: The login name of the winner.
%winnerEntries% Type: int: Number of entries the winner had.
%requiresClaim% Type: bool: Indicator if the winner must manually claim the prize.
%claimSeconds% Type: int: Time in seconds allowed for claiming (if required).
%title% Type: string: The title of the giveaway.
%totalParticipants% Type: int: Total number of unique participants.
%totalEntries% Type: int: Total number of entries in the giveaway.
%winnersCount% Type: int: Total number of winners picked so far.

Giveaway Locked

Fires when the giveaway is locked (entries closed).

%title% Type: string: The title of the giveaway.
%totalParticipants% Type: int: Total number of unique participants.
%totalEntries% Type: int: Total number of entries in the giveaway.
%lockedBy% Type: string: The display name of the user who locked the giveaway.

Giveaway Unlocked

Fires when a locked giveaway is reopened.

%title% Type: string: The title of the giveaway.
%totalParticipants% Type: int: Total number of unique participants.
%totalEntries% Type: int: Total number of entries in the giveaway.

Giveaway Cancelled

Fires when the giveaway is cancelled.

%title% Type: string: The title of the giveaway.
%totalParticipants% Type: int: Total number of unique participants.
%totalEntries% Type: int: Total number of entries in the giveaway.
%refundedPoints% Type: int: Total amount of points refunded to users.
%cancelledBy% Type: string: The display name of the user who cancelled the giveaway.

Giveaway Ended

Fires when the giveaway is formally ended.

%title% Type: string: The title of the giveaway.
%totalParticipants% Type: int: Total number of unique participants.
%totalEntries% Type: int: Total number of entries in the giveaway.
%winnersCount% Type: int: Total number of winners.
%winners% Type: object: List of winner display names.
%endedBy% Type: string: The display name of the user who ended the giveaway.

Giveaway Participant Removed

Fires when a participant is manually removed from the giveaway.

%user% Type: string: The display name of the removed user.
%userId% Type: string: The Twitch User ID of the removed user.
%userName% Type: string: The login name of the removed user.
%entries% Type: int: The number of entries the user had.
%refundedPoints% Type: int: Points refunded to the user (if any).
%title% Type: string: The title of the giveaway.
%totalParticipants% Type: int: Updated total number of unique participants.
%totalEntries% Type: int: Updated total number of entries.

FAQ & Examples

What's the difference between dock and main Settings UI?

The dock for OBS allows you to quickly manage raffles without commands. The dock also allows to override certain settings (like time limit, points requirements, tickets).

Changelog

v1.0.6 latest

2026-04-06

New YouTube support added
Changed New dock design with preset support

v1.0.5

2026-04-01

New Added YT cache to support YouTube at a later point
New Added backup mechanisms for loyalty points once they support YouTube
Fix Fixed an issue with the 'Claim' action not disabling itself correctly in every case

v1.0.4

2026-02-20

New Added 'Giveaway Cleared' trigger

v1.0.3

2026-01-26

Fix Fixed an issue where refunds failed on cancellation when the the giveaway was created via dock and points requirements in dock and Settings UI mismatched

User Reviews

5.0 (6 reviews)

AboutSelphy 4/22/2026

The best Giveaway Extension i ever used! - The overlay looks so clean i just love it! - It's easy to setup and just need a few tweakings like text Messages