Skip to content

Troubleshooting

Jump to bottom
Michael Sprick edited this page Sep 26, 2025 · 3 revisions

🛠️ OBS Studio Troubleshooting Guide

Having trouble with OBS Studio? This page lists common issues and how to fix them. Whether you're recording, streaming, or setting up scenes, these tips will help you get back on track quickly.

⚠️ Common Issues & Fixes

🎙️ No Audio in Recording or Stream

  • Check Audio Sources
    Go to Settings > Audio and ensure your mic and desktop audio devices are selected.

  • Verify Scene Sources
    Make sure your scene includes an Audio Input Capture or Audio Output Capture source.

  • Monitor Audio Levels
    Watch the audio mixer during playback—if levels are flat, the source may be muted or misconfigured.

  • Fix: Re-add the audio source
    Delete and re-add the audio source to refresh device detection.

🖥️ Black Screen for Display Capture

  • Windows Laptop Users
    OBS may be using the wrong GPU. Go to Graphics Settings in Windows and set OBS to use the Integrated GPU.

  • Fix: Run OBS as Administrator
    Right-click OBS → Run as administrator to allow full screen capture.

  • Try Game Capture or Window Capture
    If Display Capture fails, switch to Window Capture or Game Capture as a workaround.

🧊 Laggy or Choppy Video

  • Lower Output Resolution
    Go to Settings > Video and reduce the base and output resolution.

  • Adjust Bitrate
    In Settings > Output, lower the bitrate (e.g., 2500 kbps for 720p streaming).

  • Use Hardware Encoding
    If available, switch to NVENC or AMD encoder instead of x264.

  • Close Background Apps
    Free up CPU/GPU resources by closing other programs.

🌐 Stream Not Connecting

  • Check Stream Key
    Ensure your stream key is correct in Settings > Stream.

  • Verify Internet Connection
    Run a speed test and confirm stable upload speeds.

  • Firewall or Antivirus Blocking OBS
    Add OBS to your firewall exceptions list.

  • Try a Different Server
    Change the ingest server in your streaming platform settings.

🎛️ Scene or Source Not Showing

  • Check Source Visibility
    Make sure the eye icon next to the source is active.

  • Reorder Sources
    Drag the source to the top of the list if it's being hidden by others.

  • Fix: Duplicate Scene
    Right-click the scene → Duplicate to reset source behavior.

🧪 Diagnostic Tools

  • Auto-Configuration Wizard
    Run from Tools > Auto-Configuration Wizard to optimize settings.

  • Log Files
    Go to Help > Log Files > View Current Log to diagnose deeper issues.

  • OBS Analyzer
    Upload your log to OBS Log Analyzer for automated feedback.

🧰 Advanced Fixes

  • Reset OBS Settings
    Rename or delete the %APPDATA%\obs-studio folder to reset all settings.

  • Update Drivers
    Ensure your GPU, audio, and camera drivers are up to date.

  • Reinstall OBS
    Uninstall and reinstall the latest version from obsproject.com.

📚 Helpful Links

🛠️ AutoHotkey Troubleshooting Guide (v1 & v2)

Running into issues with your AutoHotkey scripts? This guide covers common problems in both v1.1 and v2.0, with clear fixes and links to deeper resources. Whether you're launching hotkeys, building GUIs, or automating workflows, this page helps you debug with confidence.

⚠️ Common Issues & Fixes

🚫 Script Won’t Run

Cause Fix (v1.1) Fix (v2.0)
Wrong version installed Check script syntax—v1 and v2 are incompatible Use #Requires AutoHotkey v2.0 at top of script
File extension is incorrect Ensure file ends in .ahk Same as v1
No default app for .ahk Right-click → Open with AutoHotkey Same as v1
Antivirus blocking script Whitelist AutoHotkey in your antivirus settings Same as v1

📚 Helpful Links

🛠️ AutoHotkey Troubleshooting Guide (v1 & v2)

Running into issues with your AutoHotkey scripts? This guide covers common problems in both v1.1 and v2.0, with clear fixes and links to deeper resources. Whether you're launching hotkeys, building GUIs, or automating workflows, this page helps you debug with confidence.

⚠️ Common Issues & Fixes

🚫 Script Won’t Run

Cause Fix (v1.1) Fix (v2.0)
Wrong version installed Check script syntax—v1 and v2 are incompatible Use #Requires AutoHotkey v2.0 at top of script
File extension is incorrect Ensure file ends in .ahk Same as v1
No default app for .ahk Right-click → Open with AutoHotkey Same as v1
Antivirus blocking script Whitelist AutoHotkey in your antivirus settings Same as v1

❌ Hotkeys Not Working

  • Check for Conflicts
    Make sure your hotkey isn’t already used by another app (e.g., Ctrl+Alt+Del).

  • Use Correct Syntax

    • v1: ^a::MsgBox You pressed Ctrl+A
    • v2: ^a => MsgBox("You pressed Ctrl+A")

  • Run as Administrator
    Some hotkeys (e.g., for system apps) require elevated privileges.

  • Fix: Reload Script
    Right-click the tray icon → Reload Script

🧊 GUI Not Displaying Properly

  • Check GUI Syntax

    • v1: Gui, Add, Text,, Hello
    • v2: myGui := Gui(), myGui.Add("Text",, "Hello")

  • Missing Show Command
    Always end GUI setup with Gui, Show (v1) or myGui.Show() (v2)

  • Fix: Resize or reposition GUI
    Use Gui, Show, w300 h200 or myGui.Show("w300 h200")

🧪 Variables Not Behaving

  • v1: All variables are loosely typed
    Use %var% for dynamic references.

  • v2: Strict typing and function scope
    Use var := "value" and avoid % for variable access.

  • Fix: Debug with MsgBox
    Insert MsgBox %var% (v1) or MsgBox(var) (v2) to inspect values.

🧩 Script Crashes or Freezes

  • Infinite Loops
    Add Sleep or ExitApp to prevent runaway loops.

  • Missing Return Statements
    Ensure each hotkey or function ends with Return (v1) or is properly scoped (v2).

  • Fix: Use ListLines or DebugView
    These tools help trace script execution.

🧰 Diagnostic Tools

  • ListLines
    Right-click tray icon → Open > View Lines Executed

  • Script Error Popups
    OBS-style error messages show line number and issue.

  • SciTE4AutoHotkey (v1 only)
    Editor with built-in debugger and syntax highlighting.

  • VS Code + AHK++ Extension (v2)
    Modern editor with IntelliSense and error hints.

🔄 Version Compatibility Tips

Feature v1.1 Syntax v2.0 Syntax
Hotkey ^a::MsgBox Hello ^a => MsgBox("Hello")
Variables var := "text" or var = text var := "text"
Functions MyFunc() MyFunc()
GUI Gui, Add, Text,, Hello Gui().Add("Text",, "Hello")

📚 Helpful Links

🛠️ ProPresenter Troubleshooting Guide

This guide covers common issues in ProPresenter and how to resolve them quickly. Use it during live services, theater productions, school events, or any AV setup where reliability matters.

⚡ Quick Checklist Before You Panic

✅ Is ProPresenter running and unlocked?
✅ Are your outputs routed correctly?
✅ Is your media preloaded and visible in the playlist?
✅ Are you on the correct slide or cue?
✅ Is your internet or network stable (for remote control or cloud sync)?

🎥 Output Issues

Problem Solution
No display on projector/screens Check Screens > Configure Screens and confirm routing
Output shows black screen Ensure the correct layer is active (slide/media) and media is not muted
Stage Display not working Verify Stage Display routing and layout settings
Wrong screen showing content Drag screen assignments to correct monitors in Display Settings

🎬 Media Playback Problems

Problem Solution
Video won’t play Check file format (MP4 recommended), preload media, or re-import
Audio missing Confirm audio routing in Preferences > Audio
Video stutters or lags Use SSD storage, preload media, and avoid background apps
Looping not working Set “Go to Next Timer” or enable loop in Media Bin

🎤 Slide & Cue Issues

Problem Solution
Wrong slide triggered Check cue labels and slide order
Slide transitions glitchy Reduce transition effects or update GPU drivers
Slide won’t advance Confirm cue is active and not blocked by media or timers
Text missing or cut off Resize text box or check font compatibility

🌐 Remote & Network Problems

Problem Solution
Remote app won’t connect Confirm IP address, firewall settings, and WebSocket is enabled
Network delay or lag Use wired Ethernet for critical devices
Web control not responding Restart ProPresenter and check port settings

🔐 Licensing & Login Issues

Problem Solution
License not recognized Re-login to Renewed Vision account or deactivate/reactivate
Trial mode unexpectedly active Check license status under License > Register
Multiple users conflicting Use a shared account or password manager for consistency

🧼 General Fixes & Maintenance

  • Restart ProPresenter and your computer
  • Update to the latest version
  • Clear media cache under Preferences > General
  • Backup and restore presentations if corrupted
  • Use Safe Mode to disable outputs temporarily

📖 AV System Guide

Clone this wiki locally