TWITCH Supports Twitch. YOUTUBE Supports YouTube. DLL REQUIRED This extension requires a .dll file (TawmaeUI.dll) in your Streamer.bot directory. On your first setup, it will ask to auto-download. You can download it manually at tawmae.xyz/dll. OBS Compatible with OBS and all other streaming softwares. Meld Compatible with Meld Studio and all other streaming softwares.

GIVEAWAY

5.0(5)

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
GIVEAWAY – Streamer.bot extension previewGIVEAWAY – Streamer.bot extension preview

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
1

Copy the Action Import String

Copy the Action Import text from Quick Access.

Copy the Action Import String
2

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.

Import the actions into Streamer.bot
3

Enable the commands

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

Enable the commands
4

Open the Settings UI once

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

If 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.
Open the Settings UI once
5

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.

Start WebSocket Server
6

Copy Browser Source URL

Copy the Browser Source URL from Quick Access.

Copy Browser Source URL
7

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)

If you want to have the browser source in multiple scenes, don't create a second browser source. Instead, use nested scenes or source clones.
Add Browser Source in OBS
8

Copy Dock URL

Copy the Dock URL from Quick Access.

Copy Dock URL
9

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.

If you don't want it in OBS, you can also open it on any browser.
Add Custom Dock in OBS
10

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
Giveaway Overlay Preview

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
Giveaway Dock Preview

Commands

User Commands

Command Permission Description Example
!enter <Entry Count (optional)>
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. !enter 5
!giveaway
Everyone Posts the info about the currently active giveaway into chat. !giveaway

Mod Commands

Command Permission Description Example
!startGiveaway <Title (optional)>
Mods Only Start a giveaway. You can enter a title, but you don't have to. !startGiveaway Witcher 3 Steam Key
!pickWinner
Mods Only Picks a random winner. !pickWinner
!lockGiveaway
Mods Only Locks the giveaway and prevents users from entering. !lockGiveaway
!unlockGiveaway
Mods Only Unlocks the giveaway and allows users to enter again.. !unlockGiveaway
!endGiveaway
Mods Only Ends the giveaway without clearing the overlay. This does not refund loyalty points. !endGiveaway
!cancelGiveaway
Mods Only Cancels the current giveaway. This will refund any invested loyalty points. !cancelGiveaway
!clearGiveaway
Mods Only Ends the giveaway and clears the overlay. This does not refund loyalty points. !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.
General settings

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.
Entries settings

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.
Appearance 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.

Chat Responses settings

Custom Triggers

Giveaway Started

Fires when a new giveaway is created.

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

Giveaway Entered

Fires when a user successfully enters the giveaway.

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

Giveaway Winner Picked

Fires when a winner is selected.

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

Giveaway Locked

Fires when the giveaway is locked (entries closed).

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

Giveaway Unlocked

Fires when a locked giveaway is reopened.

Variable Type Description Example
%title%
string The title of the giveaway. -
%totalParticipants%
int Total number of unique participants. -
%totalEntries%
int Total number of entries in the giveaway. -

Giveaway Cancelled

Fires when the giveaway is cancelled.

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

Giveaway Ended

Fires when the giveaway is formally ended.

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

Giveaway Participant Removed

Fires when a participant is manually removed from the giveaway.

Variable Type Description Example
%user%
string The display name of the removed user. -
%userId%
string The Twitch User ID of the removed user. -
%userName%
string The login name of the removed user. -
%entries%
int The number of entries the user had. -
%refundedPoints%
int Points refunded to the user (if any). -
%title%
string The title of the giveaway. -
%totalParticipants%
int Updated total number of unique participants. -
%totalEntries%
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

  • New: YouTube support added
  • Changed: New dock design with preset support

v1.0.5

  • 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

  • New: Added 'Giveaway Cleared' trigger

v1.0.3

  • 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 (5 reviews)

Reviews

When I turn on streamerbot, I get a notification to update on the screen, when I click on it, this page opens...where should I download the update?

Wunderbares Tool - nutzen es sehr gerne - vielen Dank dafür! Optisch und funktionell Mega. Vielen Dank.