Documentation
Getting started with Stream Craftr
Follow these steps to connect Stream Craftr to OBS and build your first control board. Most users are up and running in under 10 minutes.
Before you begin
What you'll need
OBS Studio 28 or later
OBS WebSocket 5 is built into OBS 28+. No separate plugin needed. Download free from obsproject.com.
A supported device
Stream Craftr runs on Windows 10/11. Install the app from the Microsoft Store before you start.
An account
Sign in with Google to sync your layouts across devices automatically.
1
Enable websocket
Turn on the WebSocket server in OBS
Stream Craftr communicates with OBS using its built-in WebSocket server. You only need to enable this once.
1
Open OBS Studio
2
Click Tools → WebSocket Server Settings
3
Check Enable WebSocket server
4
Note the Server Port (default: 4455)
5
Optionally set a Server Password
6
Click OK
2
Download the app
Get Stream Craftr on your device
Stream Craftr is a native app, no browser required. Install it from the Microsoft Store for the best performance and lowest latency.
3
Connect to OBS
Point Stream Craftr at your OBS instance
Stream Craftr communicates with OBS using its built-in WebSocket server. You only need to set this once.
1
Open Stream Craftr and create an account
2
If connection doesn't open automatically click the settings icon in the left hand sidebar
3
Enter the WebSocket URL (typically ws://127.0.0.1:4455)
4
Enter your OBS WebSocket password if you set one
5
Tap Save — the status dot turns green when live
4
Create a Button
Build your first control button
Once connected, tap the Edit button in the sidebar to create a new control button. Each button can trigger one or more OBS actions.
1
Tap the + Add Button button
2
Give the button a name (e.g. "Gaming")
3
Choose a color form the color picker
4
Tap Add Action and choose an action type
5
Tap Save. Your button appears in the grid immediately
5
Review action types
What can buttons do?
Every button is made of one or more actions. Each action tells OBS to do something specific. Choose from several action types:
Scene Switch
Instantly cut to any OBS scene. Choose the target scene and optionally override the transition type (Cut, Fade, custom etc.) for this button specifically.
Show / Hide Source
Toggle any source in your active OBS scene: graphics, cameras, browser sources, text overlays. Enable auto-hide so the source disappears after it finishes playing.
Media Action
Play, restart, or stop a media source in OBS. Use this for sound effects, alert videos, or countdowns that you want to trigger on demand.
Delay
Pause the macro for a set number of seconds before the next action runs. Useful for timed intros, holding a scene, or syncing with audio.
6
Build a macro
Chain actions into a single button press
Macros let you automate complex sequences. For example "Intro Sequence" → Switch to Starting Soon scene → Play intro video → Wait for video to finish → Switch to Main Camera scene. One tap, fully automated.
1
In the button editor, tap Add Action multiple times to stack actions
2
Long-click and drag to reorder the action sequence
3
While a macro is running, a progress queue appears. Cancel queue items mid-sequence
7
Organize layouts
Create multiple layouts for different streams
Layouts let you keep entirely separate button boards for different types of content. Switch between them instantly without losing your setup.
1
Tap the layout icon in the sidebar to open the layout selector
2
Tap + New Layout and give it a name (e.g. "Gaming", "Podcast")
3
Switch layouts live during a stream, your buttons update instantly
4
Enter Edit Mode (long-press any button) to reorder or delete buttons
Troubleshooting
Having trouble?
Try these fixes first. If you're still stuck, email us at support@streamcraftr.com.
Stream Craftr says "Connection failed" or won't connect
Make sure OBS is running and the WebSocket server is enabled (Tools → WebSocket Server Settings → Enable WebSocket server). On Windows and macOS, confirm the URL is ws://127.0.0.1:4455. If you changed the port in OBS, update it in StreamCraftr to match.
Password error — authentication failed
Double-check the password in Stream Craftr matches exactly what's set in OBS. Passwords are case-sensitive. If unsure, clear the password in OBS and leave the field empty in Stream Craftr.
Scene and source lists are empty in the button editor
Stream Craftr loads scenes live from OBS. Make sure you're connected (green status dot) before opening the button editor. If you recently added a scene, reconnect to refresh the list.
OBS crashes or disconnects mid-stream
Stream Craftr will detect the dropped connection and show a reconnect prompt. Restart OBS and tap Reconnect in Stream Craftr. Your button layout is preserved — nothing is lost.
Still stuck?
Email us at support@streamcraftr.com and we'll help you get set up. Include your platform (Windows / macOS), your OBS version, and a brief description of the issue.