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