stream-concern user guide
stream-concern is a live streaming and recording application. This guide covers the app as it exists today on macOS: capturing your screen, cameras, capture cards, media files and images into scenes, mixing audio, and sending the result to a streaming service or a recording on disk.
macOS is the platform that is validated end to end today. Windows and Linux screen-capture backends exist and compile, but are not yet runtime-verified; cameras, capture cards and system-audio capture are macOS-only for now. Each page marks per-OS support where it differs, and the Not yet page lists features that are planned but not in this build.
Pages
- Getting started — install, first launch, the macOS permissions the app needs, and where your profile, scenes and logs live.
- Settings — draft edits, Apply/Cancel, base canvas, audio devices, output defaults, conflicts, and save errors.
- Sources — every entry in the Add source pull-down (displays, windows, webcams, capture cards, media files, images, text overlays, RTMP Server, Syphon/NDI interchange, the test pattern), what each OS supports, and each source’s properties.
- Web overlays — browser layers (chat, alerts, widgets): when they run at full rate, the background rate, Reload, crash and reconnect recovery, and the memory ceiling.
- Alert simulator — test follows, subscriptions, donations and raids in a web overlay’s alert box without going live.
- News crawl — a news-channel ticker layer: scrolling lanes, a badge, headline or clock over them, and items from a text file you edit while live.
- Scenes and the canvas editor — the scene list, scene transitions, the layer stack, and placing and sizing layers by direct manipulation.
- Undo and redo — which scene and layer edits can be undone, and which cannot.
- Audio and the mixer — mixer strips, the dB fader, meters, filters, desktop and application audio, multi-channel devices, monitoring, and the microphone input.
- Silence on this Mac — keep a game’s or the system’s audio off your speakers while the stream and recordings still carry it (macOS 14.2+).
- Windows and layout — the docked panels, detaching the mixer into its own window, mixer scrolling, which tool windows open outside the main window, and where their size and position are remembered.
- Outputs: streaming and recording — the Outputs panel, adding destinations and recordings, canvas presets, rate control, Twitch test mode, sharing an encoder, and running several outputs at once.
- Dynamic bitrate and reconnecting — how a stream follows a slow upload and comes back after a dropped connection.
- Control surfaces: MIDI and keyboard shortcuts — the actions a controller can run, the default keyboard shortcuts, and setting up a MIDI controller with Learn.
- Remote control: Stream Deck, Companion and other OBS controllers — the obs-websocket 5 compatible server, which Stream Deck plugins to use, the password, and what a controller can do.
- Recording — containers, encoders, ProRes, quality presets, filename templates, split policy, where files land, and A/V sync.
- Versions and licences — the alpha, beta and release channels, when an alpha or beta stops, what a licence and its year of updates allow, and entering a licence.
- Not yet — planned features that are not in this build.
For diagnosing problems (logs, permissions, stream failures, crash recovery),
see ../troubleshooting.md.