🎬 Media Share
The Media Share widget allows viewers to share YouTube videos and Twitch clips on your stream, creating engaging moments with curated content.
Overview
Viewers submit videos using the !media command. Videos are added to a queue and play on your Media Share overlay when approved.
Default Cost: 5 Juice per second of video
How It Works
- Viewer types:
!media <youtube-url> - Video is added to the Media Share queue
- Juice is calculated based on video length
- Streamer can approve, skip, or reject videos
- Approved videos play on the overlay
Settings
Basic Settings
| Setting | Description | Default |
|---|---|---|
| Cost per Second | Juice charged per second of video | 5 |
| Enabled | Master toggle for Media Share | On |
| Broadcast to Chat | Announce when media plays | Off |
| Auto-approve | Skip manual approval | Off |
Queue Settings
| Setting | Description |
|---|---|
| Max Queue Size | Maximum videos in queue |
| Max Video Length | Maximum allowed video duration |
| Min Video Length | Minimum required duration |
Supported Content
YouTube Videos
- Full videos
- Specific timestamps (using
?t=or&t=) - YouTube Shorts
Twitch Clips
- Clip URLs from Twitch
Coming Soon
- TikTok videos
- Twitter/X videos
Setup Instructions
Step 1: Enable Media Share
- Go to Widgets → Media Share in your dashboard
- Ensure the Enabled toggle is ON
- Set your cost per second
Step 2: Add Overlay to OBS
- Copy the Media Share overlay URL
- In OBS, add a Browser Source
- Paste the URL
- Set dimensions: 1280 x 720 or 1920 x 1080
- Enable audio from the browser source
Step 3: Configure Queue Settings
- Set maximum video length (recommended: 3-5 minutes)
- Set maximum queue size
- Choose auto-approve or manual approval
Commands
| Command | Description |
|---|---|
!media <url> | Submit a video to the queue |
!media skip | Skip current video (mods/streamer) |
!media queue | View current queue |
Examples
!media https://youtube.com/watch?v=dQw4w9WgXcQ
!media https://clips.twitch.tv/ExampleClip
!media https://youtu.be/dQw4w9WgXcQ?t=30Managing the Queue
Viewing the Queue
The Media Share queue is visible in your dashboard:
- Go to Widgets → Media Share
- See pending videos with preview thumbnails
- View submitter name and video length
Approving/Rejecting Videos
For each video in the queue:
- Approve: Add to playback queue
- Reject: Remove and refund Juice
- Preview: Watch before deciding
Skipping Videos
During playback, you can skip:
- Use the dashboard Skip button
- Use the
!media skipcommand (mods only) - Set up a hotkey/Stream Deck button
Cost Calculation
Media Share uses a per-second pricing model:
| Video Length | Cost (at 5 Juice/sec) |
|---|---|
| 30 seconds | 150 Juice |
| 1 minute | 300 Juice |
| 3 minutes | 900 Juice |
| 5 minutes | 1,500 Juice |
This helps balance engagement and prevents excessively long videos from dominating your stream.
Content Moderation
Age-Restricted Content
- YouTube age-restricted videos are blocked
- Twitch clips follow Twitch's content policies
Manual Review
We recommend keeping Auto-approve OFF so you can:
- Preview content before it plays
- Reject inappropriate videos
- Maintain control over your stream content
Word Filters
Video titles and descriptions are checked against your word filter settings.
Troubleshooting
Video Won't Play
| Issue | Solution |
|---|---|
| "Video unavailable" | Video may be region-locked or deleted |
| Black screen | Refresh the browser source |
| No audio | Check browser source audio settings |
| Stuck loading | Video may be too long or unavailable |
Queue Issues
| Issue | Solution |
|---|---|
| Queue full | Increase max queue size or clear queue |
| Wrong video playing | Check queue order in dashboard |
| Videos stuck | Refresh dashboard and browser source |
Cost Issues
- Video length is calculated when submitted
- If a video is rejected, Juice is refunded
- Skipped videos are not refunded
Best Practices
- Set Reasonable Length Limits: 3-5 minutes max recommended
- Use Manual Approval: Keep control over content
- Monitor the Queue: Stay aware of upcoming content
- Communicate Rules: Let viewers know what content is allowed
- Set Appropriate Costs: Balance accessibility and quality
FAQ
Q: Are refunds given for skipped videos? A: No, Juice is only refunded if you reject a video before it plays.
Q: Can I set different costs for different video lengths? A: Currently, cost is calculated per second uniformly.
Q: What happens if a video is deleted after submission? A: The video will fail to play and you can reject/remove it from the queue.
Q: Can viewers see the queue? A: Yes, the !media queue command shows pending videos.
Q: Is there a daily limit on submissions? A: Not built-in, but you can manage this through queue size limits.