⏱️ Viewer Timeouts
The Viewer Timeouts widget lets viewers playfully timeout other chatters using Juice, adding a fun competitive element to your stream.
Overview
Viewers can spend Juice to timeout other chatters for a set duration. It's a playful way to interact and creates entertaining moments on stream.
Default Cost: 5 Juice per second of timeout
How It Works
- Viewer types:
!timeout @username 60(60 seconds) - Juice is calculated based on timeout duration
- Target user is timed out in chat
- Alert appears on overlay (optional)
- Target's chat is silenced for the duration
Settings
Basic Settings
| Setting | Description | Default |
|---|---|---|
| Cost per Second | Juice per second of timeout | 5 |
| Max Length | Maximum timeout duration (seconds) | 600 |
| Enabled | Master toggle | On |
| Enable Alerts | Show timeout alerts on overlay | On |
Protection Settings
Consider who should be protected from timeouts:
- Moderators (usually protected)
- VIPs (optional)
- Subscribers (optional)
Setup Instructions
Step 1: Enable Viewer Timeouts
- Go to Widgets → Viewer Timeouts in your dashboard
- Toggle Enabled to ON
- Set your cost per second
- Set maximum timeout length
Step 2: Add Alert Overlay (Optional)
- Copy the Timeout Alerts overlay URL
- In OBS, add a Browser Source
- Paste the URL
- Set dimensions: 400 x 200 (recommended)
- Position where you want alerts to appear
Step 3: Configure Protections
- In the Timeout settings, review protection options
- Moderators are typically protected by default
- Decide if VIPs/subs should be protected
Commands
| Command | Description |
|---|---|
!timeout @user <seconds> | Timeout a user |
!police @user <seconds> | Alternative command |
Examples
!timeout @SomeViewer 30
!timeout @AnotherUser 120
!police @ChatUser 60Cost Calculation
| Timeout Duration | Cost (at 5 Juice/sec) |
|---|---|
| 10 seconds | 50 Juice |
| 30 seconds | 150 Juice |
| 60 seconds | 300 Juice |
| 5 minutes | 1,500 Juice |
| 10 minutes | 3,000 Juice |
Timeout Alerts
When enabled, alerts show:
- Who initiated the timeout
- Who got timed out
- Duration of the timeout
- Fun animation/visual
Alert Positioning
- Go to Timeout settings
- Adjust overlay X/Y coordinates
- Or use the visual position editor
Protection System
Who's Protected
By default:
- The streamer (you)
- Moderators
Consider protecting:
- VIPs
- Subscribers
- Specific users
Adding Protection
Protected users cannot be timed out by other viewers. Configure this in the widget settings.
Use Cases
Friendly Competition
- Chat wars between friend groups
- Protecting "team members"
- Playful rivalries
Engagement
- Rewards viewers who participate
- Creates memorable moments
- Encourages Juice spending
Moderation Tool
While meant for fun, it can also:
- Help manage rowdy chatters
- Give trusted viewers moderation-lite powers
- Add consequences to chat games
Troubleshooting
Timeout Not Working
| Issue | Solution |
|---|---|
| "User protected" | Target may be mod/VIP/protected |
| Command ignored | Check widget is enabled |
| Insufficient Juice | Viewer needs more Juice |
| Duration too long | Check max length setting |
Alert Issues
| Issue | Solution |
|---|---|
| No alert showing | Check alerts enabled, verify overlay URL |
| Alert wrong position | Adjust X/Y coordinates in settings |
| Alert stuck | Refresh the browser source |
Permission Issues
- Ensure the Citrus bot has moderator permissions
- The bot needs timeout powers to execute timeouts
Best Practices
- Set Reasonable Limits: Don't allow 24-hour timeouts
- Protect Key People: Mods and VIPs should usually be protected
- Make It Fun: Frame it as entertainment, not punishment
- Balance Costs: Too cheap = spam, too expensive = unused
- Monitor Usage: Watch for abuse or targeting
FAQ
Q: Can timed-out users still see the stream? A: Yes, they can watch but can't chat for the duration.
Q: Can someone timeout themselves? A: Depending on settings, potentially yes (for comedic effect).
Q: Do timeouts stack? A: Platform-dependent. Usually the longest duration takes effect.
Q: Can moderators be timed out? A: By default no, but you can configure this in settings.
Q: What if someone abuses timeouts? A: You can disable the widget or timeout/ban the abuser.
Q: Does this actually timeout on Twitch/Kick? A: Yes, it executes a real timeout through the platform.