StreamElements Custom Widget

Stream Pet - Golden Retriever Puppy

An adorable interactive golden retriever puppy for your stream! 16 chat commands, 6 event reactions, 11 bubble themes, and 22 unique animations. For Twitch & YouTube.

Live Demo User Guide Get on Etsy

Features

16
Commands
6
Events
11
Bubble Themes
22
Animations

11 Bubble Themes

Clean White
Hello world!
Kawaii Pink
Hello world!
Dark Gamer
Hello world!
Pastel Dream
Hello world!
Retro Pixel
Hello world!
Neon Cyber
Hello world!
Cozy Forest
Hello world!
Ocean Breeze
Hello world!
Sunset Glow
Hello world!
Midnight Galaxy
Hello world!
Bubblegum
Hello world!

User Guide

Everything you need to set up and customize your Stream Pet widget

🚀

Quick Start

  1. Click the install link you received after purchasing on Etsy. This will automatically create a new overlay in your StreamElements account.
  2. Go to StreamElementsMy Overlays (streamelements.com/dashboard/overlays).
  3. Find the "Stream Pet - Golden Retriever" overlay and click Edit.
  4. Click on the widget layer to select it. The settings panel will appear on the left side.
  5. Use the Settings panel to customize your pet:
    • Adjust pet size and animation speed
    • Enable/disable individual chat commands
    • Set permissions (who can use commands)
    • Choose a bubble theme or create your own
    • Customize bubble text templates for each event
    • Configure auto-sleep timer
  6. Click Save and add the overlay URL to OBS as a Browser Source.
💡 Tip: Set your OBS Browser Source size to match your canvas (e.g. 1920x1080). The pet will appear at the bottom center of the overlay by default — you can reposition it in OBS.
🐾

Pet Settings

Pet Size

Controls the size of the puppy on screen.

  • Setting: Pet size (px)
  • Range: 200px – 1000px
  • Default: 530px

A larger pet is more visible but takes more screen space. For 1080p, 400–600px works great.

Animation Speed

Controls how fast the puppy animations play.

  • Setting: Animation speed
  • Range: 0.5x – 3.0x
  • Default: 1.6x

Higher values make the puppy more energetic. Lower values create a calmer, more relaxed feel.

⌨️

Chat Commands

Your viewers can control the puppy using chat commands. Each command triggers a unique animation. All command names are customizable in the settings — change !pet to !pat, !boop, or anything you like.

⚠️ Important: Cooldown is per user, per command. If a viewer uses !dance, they must wait for the cooldown before using !dance again, but can immediately use !play.
CommandAnimationCan Disable?
!idleReturns to idle state, resets sleep timerAlways on
!petPet the puppy lovinglyYes
!playPlay time! Fetch and funYes
!danceHappy dance movesYes
!sleepCurl up for a nap (loops)Yes
!loveShow some loveYes
!angryGrumpy puppy modeYes
!drinkDrink some waterYes
!hungryTime for treatsYes
!excitedSuper excited zoomiesYes
!scaredSomething spooked the pupYes
!sleepyGetting drowsy...Yes
!tiredLong day, needs restYes
!twerkWiggly tail danceYes
!helloFriendly greeting waveYes
!thuglifeCool puppy attitudeYes
!crySad puppy tearsYes
💡 Tip: Animations play in a queue. If multiple viewers send commands at once, they play one after another — no animations are lost! After the queue is empty, the puppy returns to idle.
🔒

Permissions & Cooldown

Who Can Use Commands

Setting: Who can use commands

  • Everyone — all viewers (default)
  • Subscribers — subs, mods & streamer
  • Moderators — mods & streamer only
  • Streamer only — just you

Permissions apply to all chat commands. Stream events (follow, sub, etc.) always trigger regardless of this setting.

Command Cooldown

Setting: Command cooldown (ms)

  • Range: 1,000ms (1s) – 300,000ms (5min)
  • Default: 60,000ms (1 minute)

The cooldown is per user, per command. This means:

  • User A uses !dance → User A must wait 1 min to !dance again
  • User A can still use !play immediately
  • User B can use !dance right away

The !idle command bypasses cooldown and permissions entirely.

🎉

Stream Events

The puppy automatically reacts to stream events with a unique animation and a customizable speech bubble. Events have higher priority than chat commands — they jump to the front of the animation queue.

EventAnimationDefault Bubble TextVariables
Follow Celebrates {name} just followed! {name}
Subscribe Sub reaction {name} just subscribed! {name}
Donation Thankful reaction {name} donated {amount}! {name} {amount}
Raid Excited welcome {name} raided with {viewers}! {name} {viewers}
Cheer Cheerful reaction {name} cheered {amount} bits! {name} {amount}
Gift Sub Gift celebration {name} gifted {amount} subs! {name} {amount}

Per-Event Toggle

Each event has its own enable/disable checkbox:

  • Show bubble on Follow
  • Show bubble on Sub
  • Show bubble on Donation
  • Show bubble on Raid
  • Show bubble on Gift Sub
  • Show bubble on Cheer

Disabling hides the bubble but the animation still plays.

Custom Bubble Text

Each event has its own text template field. Use variables to include dynamic data:

  • {name} — viewer's username
  • {amount} — donation/bits/gift count
  • {viewers} — raid viewer count

Example: Change donation text to Woof! Thanks {name} for ${amount}!

💬

Bubble Theme & Customization

Preset Themes

Setting: Bubble theme (dropdown)

Choose from 11 ready-made themes:

  • Clean White — minimal, light
  • Kawaii Pink — soft pink, rounded
  • Dark Gamer — dark bg, neon green
  • Pastel Dream — lavender, rounded
  • Retro Pixel — cream, sharp corners
  • Neon Cyber — very dark, cyan neon
  • Cozy Forest — soft green, natural
  • Ocean Breeze — light blue, calm
  • Sunset Glow — warm peach, orange
  • Midnight Galaxy — dark, purple glow
  • Bubblegum — bright pink, playful

Default: Midnight Galaxy

Custom Theme

Select "Custom" from the Bubble theme dropdown to unlock these settings:

  • Bubble text color — colorpicker (default: #333333)
  • Bubble background color — colorpicker (default: #ffffff)
  • Bubble border color — colorpicker (default: #e0e0e0)
  • Bubble border radius (px) — 0 to 30 (default: 12)
  • Bubble font family — any Google Font (default: Nunito)
  • Bubble font size (px) — 10 to 48 (default: 24)
  • Bubble padding (px) — 4 to 40 (default: 20)

When using a preset theme, these settings are ignored — the theme provides all styling.

Bubble Position

Fine-tune where the bubble appears relative to the pet:

  • Space above pet for bubble (px) — 0 to 200 (default: 170)
  • Bubble horizontal offset (px) — -200 to 200 (default: 0)
  • Bubble vertical offset (px) — -200 to 200 (default: 35)

Bubble Duration

How long the bubble stays visible after appearing:

  • Bubble display duration (ms) — 1,000 to 15,000
  • Default: 4,000ms (4 seconds)

If a new event triggers while a bubble is already showing, the new text replaces it and the timer resets.

💡 Tip: Toggle Preview bubble in the settings to see a test bubble without needing real events. Great for positioning and theme testing!
💤

Auto-Sleep

How It Works

When there's no activity for a while, the puppy automatically curls up and falls asleep with a looping sleep animation. This makes the widget feel more alive and natural.

The sleep timer resets on:

  • Any chat message (not just commands)
  • Any stream event (follow, sub, donation, etc.)
  • Any chat command

When the puppy is asleep and any command or event fires, it wakes up automatically and plays the requested animation.

Settings

  • Enable auto-sleep after inactivity
    Toggle on/off (default: on)
  • Sleep timeout (ms)
    Range: 30,000ms (30s) – 600,000ms (10min)
    Default: 180,000ms (3 minutes)

If you disable auto-sleep, the puppy will stay in idle mode forever until a command or event plays.

⚙️

All Settings Reference

Complete list of all configurable settings in the StreamElements editor:

SettingTypeDefaultRange / Options
Pet Settings
Pet size (px)Slider530200 – 1000, step 10
Animation speedSlider1.60.5 – 3.0, step 0.1
Permissions
Who can use commandsDropdownEveryoneEveryone / Subs / Mods / Streamer
Command cooldown (ms)Number600001,000 – 300,000
Sleep
Enable auto-sleepCheckboxOn
Sleep timeout (ms)Number18000030,000 – 600,000
Bubble – General
Enable alert bubbleCheckboxOn
Preview bubbleCheckboxOffToggle to test
Bubble themeDropdownMidnight Galaxy11 presets + Custom
Bubble display duration (ms)Number40001,000 – 15,000
Bubble – Position
Space above pet (px)Slider1700 – 200, step 5
Horizontal offset (px)Slider0-200 – 200, step 5
Vertical offset (px)Slider35-200 – 200, step 5
Bubble – Custom Theme
Text colorColor#333333Any color
Background colorColor#ffffffAny color
Border colorColor#e0e0e0Any color
Border radius (px)Number120 – 30
Font familyTextNunitoAny Google Font
Font size (px)Slider2410 – 48, step 1
Padding (px)Slider204 – 40, step 1
Bubble – Event Toggles
Show bubble on FollowCheckboxOn
Show bubble on SubCheckboxOn
Show bubble on DonationCheckboxOn
Show bubble on RaidCheckboxOn
Show bubble on Gift SubCheckboxOn
Show bubble on CheerCheckboxOn
Bubble – Event Text Templates
Follow bubble textText{name} just followed!{name}
Sub bubble textText{name} just subscribed!{name}
Donation bubble textText{name} donated {amount}!{name} {amount}
Raid bubble textText{name} raided with {viewers}!{name} {viewers}
Gift sub bubble textText{name} gifted {amount} subs!{name} {amount}
Cheer bubble textText{name} cheered {amount} bits!{name} {amount}
Chat Commands (x16)
Each command has:A text field (trigger word, e.g. !dance) + an enable checkbox. The !idle command is always enabled.
💡

Tips & FAQ

What size should I set the Browser Source in OBS?

Set it to match your stream canvas — typically 1920x1080. The pet will appear at the bottom center. You can resize and reposition the source in OBS as needed.

Commands are not working in chat. What do I check?

1) Make sure the command is enabled in settings. 2) Check permissions — if set to "Mods only", regular viewers can't use it. 3) Check cooldown — the user might still be on cooldown. 4) Make sure the overlay is active in StreamElements and the Browser Source is visible in OBS.

The puppy is stuck on the sleep animation. How do I wake it up?

Type any chat command (like !pet) or trigger any stream event. The puppy wakes up automatically. You can also use !idle which always works regardless of permissions or cooldown.

Can I change the command names?

Yes! Every command trigger word is customizable. In the settings, find the command you want to rename and type a new trigger. For example, change !pet to !pat or !boop. Commands must start with !.

The bubble text doesn't show viewer names. What's wrong?

Make sure you're using the correct template variables: {name} for the viewer name, {amount} for donation/bits/gift count, and {viewers} for raid viewer count. These are case-sensitive and must include the curly braces.

How do I test bubble themes without real events?

Toggle "Preview bubble" to ON in the settings. A test bubble will appear immediately so you can see how your chosen theme looks. Toggle it back OFF when you're done.

Can I use this on YouTube?

Yes! The widget works with both Twitch and YouTube through StreamElements. Chat commands and events are supported on both platforms.

Multiple commands at the same time — what happens?

Animations play in a queue. They are processed one at a time in order. Stream events (follow, sub, donation, etc.) have higher priority and jump to the front of the queue. After all queued animations finish, the puppy returns to idle.

🤎

Need Help?

If you have any questions, issues, or feature requests, feel free to reach out!