This guide walks you through setting up LiveSuite widgets in OBS Studio. It’s easier than you think!
Prerequisites
- OBS Studio installed
- Your token’s mint address
- A LiveSuite widget URL
First, choose which widget you want to use. Head to the Widgets documentation to see all available types.
Common widget URLs look like:
- Timer:
https://livesuite.app/widgets/obs-timer/YOUR_MINT_ID
- Market Cap Goal:
https://livesuite.app/widgets/marketcap-goal/YOUR_MINT_ID/1000000
- Holder Count:
https://livesuite.app/widgets/holder-count/YOUR_MINT_ID
Replace YOUR_MINT_ID with your actual token mint address.
You can find your mint address on pump.fun or in your token’s URL. It’s the long string of characters after /token/.
Step 2: Add Browser Source in OBS
- In OBS Studio, right-click in your Sources panel
- Select Add → Browser Source
- Give it a name (e.g., “Stream Timer” or “Market Cap Goal”)
- Click OK
In the Browser Source settings:
- URL: Paste your widget URL here
- Width: Set to
1920 (or your stream resolution width)
- Height: Set to
1080 (or your stream resolution height)
- Check Shutdown source when not visible (saves resources)
- Custom CSS: Leave blank unless you need custom styling
- Click OK
Step 4: Position and Size
Your widget should appear in your preview. You can:
- Drag it to position it where you want
- Resize it by dragging the corners
- Adjust transparency if needed
For overlays, smaller sizes work better. Try starting with 400-600px width and adjust to fit your design.
Step 5: Test It
- Make sure your token is live on pump.fun
- Check that the widget is updating (viewer counts, timers, etc. should change)
- Preview your stream to see how it looks
You can add multiple widgets to the same scene:
- Repeat steps 2-4 for each widget
- Position them in different locations
- Name them clearly so you can find them later
Common combinations:
- Timer + Market Cap Goal
- Token Stats + Ranking
- Holder Count + Creator Fees Goal
Common Issues
Widget not showing:
- Check that the URL is correct (including the mint ID)
- Make sure your token is currently live
- Try refreshing the browser source (right-click → Refresh)
Widget not updating:
- Widgets update every few seconds, so small delays are normal
- If it’s been stuck for more than 30 seconds, check your internet connection
- Make sure “Shutdown source when not visible” is checked
Widget too big/small:
- Adjust the width/height in browser source settings
- Or resize it directly in OBS by dragging the corners
Transparency issues:
- Widgets support transparent backgrounds by default
- If you see a white background, check your widget’s settings or try a different widget type
Advanced: Custom Styling
Some widgets support URL parameters for custom styling. Check the widget documentation for available parameters.
Example:
https://livesuite.app/widgets/obs-timer/YOUR_MINT_ID?color=ffffff&fontSize=24
Saving Your Setup
Once you have your widgets configured:
- Save your scene in OBS
- Your widget configurations are saved automatically
- They’ll load the next time you open OBS
If you’re logged into LiveSuite, you can also save widget configurations in your dashboard for easy reference.
For Timers:
- Position: Top-left or bottom-left corner
- Size: Medium (400-600px width)
- Use: All streams
For Market Cap Goals:
- Position: Near token info or center
- Size: Medium to large (500-800px width)
- Use: When approaching milestones
For Rankings:
- Position: Top-right corner
- Size: Small to medium (300-500px width)
- Use: When in top rankings
For Holder Counts:
- Position: Bottom overlay area
- Size: Small (300-400px width)
- Use: Community-focused streams