A collaboration with Yuuki to build a customizable bullet chat widget for use as a StreamElements Custom Overlay. This widget displays chat messages scrolling across the screen with various animation and styling options. Created after Yuuki noted the lack of a fully functional StreamElements overlays for bullet-style chat. We were unable to quickly find a free/shared version of the code needed to make this work so we are posting it here for others who may want to use it.
- Direction Control:
- Choose whether messages come from the left side, right side, or randomly from both sides
- Animation Controls:
- Speed: Control how fast messages move across the screen
- Duration: How long messages stay visible
- Fade Out: Toggle whether messages fade out at the end
- Fade Duration: Control how long the fade out takes
- Styling Options:
- Font Family: Select from Google Fonts
- Font Size: Customize the text size
- Username Color: Custom color for usernames (with opacity control)
- Message Color: Custom color for message text (with opacity control)
- Background Color: Optional message background with customizable color and opacity
- Preview Feature:
- Simple checkbox option to enable/disable the style preview
- Creates a sample message showing how your settings will look
- Preview is clearly labeled with "[PREVIEW]" text
- Only visible in the editor (not seen by viewers) unless you hit SAVE while checkbox enabled
-
Create a New Custom Widget:
- Go to your StreamElements dashboard
- Navigate to "My Overlays"
- Open an existing overlay or create a new one
- Click the "+" button to add a new widget
- Select "Custom Widget"
-
Add the Required Files:
- In the Custom Widget Editor, you'll see tabs for HTML, CSS, JS, FIELDS, and DATA
- Copy the contents of each file in this repository to the corresponding tab:
html.html→ HTML tabstyles.css→ CSS tabscript.js→ JS tabfields.json→ FIELDS tab
-
Save and Add to Overlay:
- Click "Done" to save the widget
- Resize and position the widget as needed in your overlay
- Make sure to hit SAVE after each change you want to see in OBS or your overlay preview window in a browser
- Left → Right: Messages appear from the left side and move right
- Right → Left: Messages appear from the right side and move left
- Both (Random): Messages randomly appear from either side
- Speed: Controls how fast messages move across the screen (1-50 pixels per frame)
- Duration: How long messages stay visible before disappearing (1-10 seconds)
- Fade Out: When enabled, messages fade out at the end of their duration
- Fade Time: Controls how long the fade out animation takes (0.1-5 seconds)
- Message Font: Choose from hundreds of Google Fonts
- Font Size: Set the text size (10-100 pixels)
- Username Color: Custom color for usernames with opacity control
- Option to use Twitch's native username colors instead of custom colors
- Chat Text Color: Custom color for message text with opacity control
- Background Color: Custom color for message background with opacity control
- Messages are automatically spaced vertically to prevent overlap
- Minimum spacing between messages: 50 pixels
- Supports moderator message deletion
- Automatically removes messages when deleted by moderators
- Handles both single message deletion and user message deletion (timeout/ban)
- If messages aren't appearing, check your browser console for any error messages
- Make sure your chat is connected and working in StreamElements
- Try refreshing the widget if settings changes aren't taking effect and be sure to save any changes in stream elements before trying to preview them
For more information on custom widgets in StreamElements, refer to:
- StreamElements Custom Widget Documentation
- StreamElements Custom Widget Events
- StreamElements Widget Structure
-H37🧬
