Firewall or security suite blocking RTMP
Outbound RTMP/RTMPS blocked by firewall, antivirus network shield, or corporate policy.
Settings reference
What each OBS Studio setting changes, which numbers are safe starting points for your upload and hardware, and how output, video and audio settings interact once you record and stream at the same time. For interactive recommendations, use the Settings Generator.
457 published pages in this section.
Game Capture fails to hook the process
Game Capture never attaches, or logs a hook failure for the target process.
Game Capture shows a black screen
Game Capture preview and output stay black while the game is visible on the desktop.
High CPU from scene processing plus encode
CPU is high from filters, browser sources, and software encode combined.
Hotkey conflicts with games or OS
OBS hotkeys do not fire because the game or OS captures the same keys.
Incorrect canvas or output scaling
Output looks cropped, stretched, or letterboxed from canvas/output mismatches.
Invalid or leaked stream key
Stream fails to connect because the stream key is wrong, revoked, or accidentally exposed.
Laptop multi-GPU capture and encode problems
Laptop iGPU/dGPU affinity causes black capture, wrong encoder GPU, or terrible performance.
Linux Wayland capture limitations
On Wayland, classic X11 capture methods fail; PipeWire portal capture is required.
Linux X11 composite window capture issues
XComposite Window Capture fails for some toolkits or when compositing is disabled.
macOS Accessibility permissions for hotkeys
Global OBS hotkeys fail on macOS without Accessibility / Input Monitoring grants.
macOS Screen Recording permission for OBS
OBS captures stay black on macOS until Screen Recording permission is granted and OBS relaunched.
Microphone or desktop clipping / distortion
Harsh distortion from levels hitting 0 dB / red in the OBS meters.
Monitoring delay in headset
You hear yourself or game monitoring late in headphones while the stream mix is fine.
Monitoring echo heard by viewers or locally
Echo or hollow repeat caused by Monitor and Output routing mistakes.
Showing 346–360 of 457.