A powerful OBS Studio plugin that enables advanced BBCode text rendering and effects for text sources.
- BBCode Text Rendering: Format text with tags like [b]bold[/b], [i]italic[/i], [u]underline[/u]
- Text Effects: Color, shadow, glow, and advanced styling options
- Macros System: Save and reuse custom BBCode tag combinations
- Text Alignment: Control text positioning (left, center, right)
- Animation Effects: Dynamic text animations and transitions
- Image & Emote Support: Import custom images and emotes (Twitch compatible)
- Help Reference: Built-in BBCode tag reference window
\
src/
├── plugin-main.cpp # Main plugin entry point
├── bbcode-source.h # Source structure definitions
├── bbcode-source.cpp # OBS source registration
├── bbcode-source-new.cpp # Alternative source implementation
├── bbcode-parser.cpp # BBCode parsing logic
├── bbcode-renderer.cpp # Text rendering engine
├── bbcode-colors.cpp # Color palette management
├── bbcode-macros.cpp # Macro system and editor UI
├── bbcode-help.cpp # Help window implementation
└── plugin-support.h # Support utilities
data/
├── color_multiply.effect # Shader for color effects
└── locale/ # Translation files
\\
- CMake 3.28 or higher
- OBS Studio source code and dependencies
- Visual Studio 2022 (Windows) or compatible compiler
\\�ash
git clone https://github.com/StreamUPTips/SUP_BB_Code.git cd SUP_BB_Code
cmake --preset windows-x64
cmake --build build_x64 --config Release \\
\\�ash cmake --preset linux-x86_64 cmake --build build --config Release \\
\\�ash cmake --preset macos-universal cmake --build build --config Release \\
- Build the plugin (see Building section)
- Copy sup-bbcode.dll to %AppData%/obs-studio/plugins/sup-bbcode/bin/64bit/
- Copy shader files from data/ to %AppData%/obs-studio/plugins/sup-bbcode/data/
- Build the plugin
- Copy sup-bbcode.so to ~/.config/obs-studio/plugins/sup-bbcode/bin/64bit/
- Copy data files to ~/.config/obs-studio/plugins/sup-bbcode/data/
- Build the plugin
- Copy sup-bbcode.so to ~/Library/Application Support/obs-studio/plugins/sup-bbcode/bin/
- Copy data files to ~/Library/Application Support/obs-studio/plugins/sup-bbcode/data/
- Add a Text Source to your scene
- In the source properties, enable BBCode formatting
- Enter BBCode in the text field:
- [b]Bold Text[/b]\
- [i]Italic Text[/i]\
- [u]Underline[/u]\
- [c=FF0000]Red Text[/c]\
- Click "BBCode Help / Tag Reference" to see all available tags
- [b]Bold[/b]\
- [i]Italic[/i]\
- [u]Underline[/u]\
- [s]Strikethrough[/s]\
- [c=RRGGBB]Colored Text[/c]\
- [bg=RRGGBB]Background Color[/bg]\
- [size=20]Larger Text[/size]\
- [left]Left Aligned[/left]\
- [center]Centered[/center]\
- [right]Right Aligned[/right]\
- [shadow=2,RRGGBB]Shadow Effect[/shadow]\
- [glow=3,RRGGBB]Glow Effect[/glow]\
- [animate=shake]Animated Text[/animate]
See the help window in the plugin for a complete reference.
- Enable BBCode: Toggle BBCode processing on/off
- Refresh On Active: Automatically refresh when source becomes active
- Default Font: Set default font for all text
- Default Size: Set default text size
Save frequently used BBCode combinations as macros for quick insertion:
- Click "Edit Macros" button
- Create named macros with their BBCode tags
- Use macros in text with {macro_name}\
- libobs (OBS Studio core library)
- obs-frontend-api (for UI features)
- Windows API (for help window on Windows)
- C++20 standard
- Follow OBS project conventions
- Use provided CMake helpers
\\�ash cmake --preset windows-x64 cmake --build build_x64 --config Debug \\
Contributions are welcome! Please:
- Fork the repository
- Create a feature branch
- Make your changes
- Submit a pull request
[Specify your license - MIT, GPL, etc.]
- Initial public release
- Core BBCode parsing and rendering
- Macro system
- Text effects and styling
- Help reference window
Made with ❤️ by StreamUP Tips