Download Troubleshooting

Solve common download and installation issues for the OBS multistream plugin

Quick Solutions (Try These First):

  • ✓ Clear your browser cache and try again
  • ✓ Try downloading in incognito/private mode
  • ✓ Disable browser extensions temporarily
  • ✓ Check if antivirus is blocking the download

Platform-Specific Solutions

đŸĒŸWindows Issues & Solutions

Download Not Working on Windows

Problem: Browser blocks download or shows "Download failed" error

Solutions:
  1. Clear browser cache and cookies (Ctrl+Shift+Delete)
  2. Disable browser extensions temporarily
  3. Try downloading in incognito/private mode
  4. Use a different browser (Chrome, Firefox, Edge)
  5. Check if antivirus is blocking the download

Windows SmartScreen Warning

Problem: "Windows protected your PC" or "App can't be opened" warning

Solutions:
  1. Click "More info" then "Run anyway" button
  2. Right-click downloaded file → Properties → Check "Unblock" under Security
  3. Temporarily disable SmartScreen: Settings → Privacy & Security → Windows Security
  4. Wait a few minutes and try again (sometimes resolves automatically)

Antivirus Blocking Download

Problem: Windows Defender or third-party antivirus blocks the file

Solutions:
  1. Temporarily disable Windows Defender real-time protection
  2. Add download folder to antivirus exclusions
  3. Download from a different network (mobile hotspot)
  4. Try downloading at a different time of day

Download Keeps Failing

Problem: Multiple download attempts fail with network errors

Solutions:
  1. Use a download manager like Free Download Manager
  2. Check available disk space (need at least 100MB)
  3. Restart your router/modem
  4. Try downloading from GitHub directly
  5. Contact your ISP if problem persists

🍎Mac Issues & Solutions

Download Not Working on Mac

Problem: Safari or other browser won't download the file

Solutions:
  1. Check Downloads folder - file might have downloaded silently
  2. Clear Safari cache: Safari → Preferences → Privacy → Manage Website Data
  3. Try Chrome or Firefox instead of Safari
  4. Disable Safari popup blocker temporarily
  5. Check if "Block all cookies" is enabled in Safari settings

Mac Security Warning (Gatekeeper)

Problem: "App can't be opened because it's from an unidentified developer"

Solutions:
  1. Go to System Settings → Privacy & Security → Find blocked app → Click "Open Anyway"
  2. For macOS Monterey and earlier: Right-click app → Open → Click "Open" in dialog
  3. If still blocked: Apple menu → System Settings → Privacy & Security → Allow apps from App Store and identified developers
  4. Wait 30 seconds between attempts - macOS sometimes needs time to process

PKG Installer Not Working

Problem: Package installer fails or shows "damaged" error

Solutions:
  1. Download the ZIP version instead from our download page
  2. Right-click PKG file → Open → Confirm you want to open it
  3. Try the manual installation method (extract to OBS plugins folder)
  4. Restart Mac and try installation again
  5. Check if you have admin privileges on your Mac

Plugin Not Appearing in OBS

Problem: Installed plugin but don't see "Multiple Output" in OBS

Solutions:
  1. Completely quit and restart OBS (not just minimize)
  2. Check OBS → Docks → Multiple Output (might be there but hidden)
  3. Look for a tiny 1cm window that needs to be resized
  4. Verify you downloaded the correct version for your OBS
  5. Try the ZIP manual installation method instead

🐧Linux Issues & Solutions

Download Not Working on Linux

Problem: Browser download fails or file won't save

Solutions:
  1. Check Downloads folder permissions: ls -la ~/Downloads
  2. Create Downloads folder if missing: mkdir -p ~/Downloads
  3. Try downloading with wget: wget [download_url]
  4. Use curl instead: curl -L -o filename [download_url]
  5. Clear browser cache and try again

Permission Denied Error

Problem: Can't extract or install the downloaded file

Solutions:
  1. Add execute permission: chmod +x filename
  2. Extract with proper permissions: tar -xzf filename.tar.gz
  3. Check if you own the file: ls -la filename
  4. Change ownership if needed: sudo chown $USER:$USER filename
  5. Make sure target directory exists and is writable

Plugin Installation Failed

Problem: Can't copy plugin to OBS directory

Solutions:
  1. Create plugins directory: mkdir -p ~/.config/obs-studio/plugins/
  2. Extract directly to plugins folder: tar -xzf file.tar.gz -C ~/.config/obs-studio/plugins/
  3. Check OBS is not running during installation
  4. Verify file permissions after extraction: ls -la ~/.config/obs-studio/plugins/
  5. Try installing OBS via package manager if using Flatpak version

Wrong OBS Version

Problem: Plugin shows version mismatch error

Solutions:
  1. Check OBS version: obs --version
  2. Download correct plugin version from GitHub releases
  3. Update OBS to latest version: sudo apt update && sudo apt upgrade obs-studio
  4. Use OBS PPA for latest version: sudo add-apt-repository ppa:obsproject/obs-studio
  5. Try building plugin from source if no compatible version exists

General Download Issues

Popup Blocker Preventing Download

Browser or extension blocking the download popup

  • â€ĸDisable popup blocker for this site
  • â€ĸAllow automatic downloads in browser settings
  • â€ĸTry right-clicking the download button → "Save link as"
  • â€ĸDisable browser extensions temporarily
  • â€ĸUse a different browser

Corporate/School Network Blocking

Network firewall preventing file downloads

  • â€ĸTry downloading on mobile data/hotspot
  • â€ĸAsk IT department to whitelist GitHub.com
  • â€ĸDownload on personal device and transfer via USB
  • â€ĸUse a VPN if allowed by your organization
  • â€ĸTry downloading during off-peak hours

Slow or Interrupted Downloads

Large file downloads timing out or failing

  • â€ĸUse a download manager (Free Download Manager, JDownloader)
  • â€ĸDownload during off-peak internet hours
  • â€ĸCheck your internet connection stability
  • â€ĸTry downloading via mobile data
  • â€ĸClear browser cache before attempting download

Alternative Download Methods

🔗 Direct GitHub Download

If our download buttons aren't working, go directly to the source:

Visit GitHub Releases →

📱 Mobile Download

Try downloading on your phone, then transfer to your computer:

  • â€ĸ Download on mobile device
  • â€ĸ Email file to yourself
  • â€ĸ Use cloud storage (Google Drive, Dropbox)
  • â€ĸ Transfer via USB cable

Still Having Issues?

📋 Before Asking for Help

  • ✓ Try all solutions for your platform above
  • ✓ Note your exact operating system version
  • ✓ Note your browser and version
  • ✓ Note the exact error message you see
  • ✓ Try downloading a different file to test if it's a general issue

🆘 Get Community Help

Visit the original plugin's GitHub page for technical support:

Report Issue on GitHub →

Download troubleshooting keywords

download not working windows, download not working mac, download not working linux, obs plugin download failed, windows smartscreen blocking download, mac gatekeeper warning, antivirus blocking download, browser blocking download, download virus detected, permission denied linux download, pkg installer not working mac, download keeps failing, obs multistream plugin installation error, download troubleshooting guide