🛡️ OBS Stranger Cam Protector

A lightweight Google Chrome extension for Twitch, Kick, and YouTube streamers who do "Stranger Cam" content.

This tool automatically throws a "Safe Poster" over your web browser in OBS the exact millisecond a stranger skips you (or drops connection). This allows you to safely pre-screen the next stranger before revealing them to your stream, protecting your channel from accidental nudity, TOS violations, or inappropriate content.

⚠️ IMPORTANT NOTE: This extension has currently only been tested on Monkey.app. While the codebase supports other sites in theory, its functionality is only guaranteed for Monkey.app at this time.

---

How It Works

1. Auto-Cover: When the stranger disconnects (or you skip), the extension instantly tells OBS to make your Safe Poster VISIBLE.
2. Pre-Screen: The website loads the next stranger. You can see them on your monitor, but your stream only sees the Safe Poster.
3. Manual Reveal: Once you verify the stranger is safe, you press a hotkey on your keyboard (or Stream Deck) to HIDE the poster and reveal them to your chat!

---

Step 1: Install the Extension in Chrome

Since this extension is not on the Chrome Web Store, you will install it directly from this folder.

1. Click the green "Code" button at the top of this GitHub page and select "Download ZIP".
2. Extract (unzip) the downloaded folder somewhere safe on your computer (like your Documents folder).
3. Open Google Chrome and type chrome://extensions/ into the URL bar at the top.
4. In the top right corner of the page, turn ON the switch for Developer mode.
5. In the top left corner, click the Load unpacked button.
6. Select the unzipped folder you downloaded. The extension will now appear in your browser!

---

Step 2: Set Up OBS Studio

You need OBS Studio version 28.0 or newer (which has WebSockets built-in).

A. Turn on OBS WebSockets

1. Open OBS Studio.
2. At the top of the screen, click Tools -> WebSocket Server Settings.
3. Check the box that says Enable WebSockets server.
4. Click Show Connect Info.
5. Write down the Server Port (usually 4455) and copy the Server Password. You will need these later.

B. Create Your Poster

1. Go to your Stranger Cam scene in OBS.
2. Add a new Image source. This will be your "Safe Poster" (a "Be Right Back" screen, a funny image, or just a black screen).
3. Make sure this Image source is at the very top of your Sources list so it covers the web browser.
4. IMPORTANT: Write down the exact name of your Scene and the exact name of your Image Source. Capitalization matters! (e.g., if your scene is Just Chatting and your poster is Safe Poster).

C. Set Your "Reveal" Hotkey

1. In OBS, open Settings -> Hotkeys.
2. Scroll down until you find the name of your Image Source (e.g., Safe Poster).
3. Next to the Hide command, assign a keyboard button (e.g., NumPad - or F9).
   • Optional: You can map this exact keyboard button to your Elgato Stream Deck!
4. Click Apply and OK.

---

Step 3: Connect the Extension

1. In Google Chrome, click the little "Puzzle Piece" icon in the top right and click on OBS Stranger Cam Protector.
2. Fill in the menu with the exact details from Step 2:
   • OBS WebSocket Port: 4455 (or whatever your port was)
   • OBS WebSocket Password: Paste the password you copied earlier.
   • OBS Scene Name: Type the exact name of your OBS scene (e.g., Just Chatting).
   • Poster Source Name: Type the exact name of your Image Source (e.g., Safe Poster).
3. Click Save & Connect.

---

Step 4: Verify the Connection in OBS

Want to make sure it's actually working before you go live? You can check the connection directly inside OBS!

1. In OBS, go to Tools -> WebSocket Server Settings.
2. Look at the Connected Sessions list at the bottom of the window.
3. You should see a session listed (e.g., [::1]:...). Look at the "Identified" column.
4. If there is a Green Arrow under the Identified column, you are 100% connected and ready to go!

---

You are ready to stream!

1. Go to Monkey.app.
2. Make sure your Safe Poster is currently Visible in OBS.
3. When the first stranger loads, check if they are safe. If they are, press your OBS hotkey to hide the poster.
4. Whenever they skip (or you press the skip button), the extension will instantly pop the poster back up!

---

What to do after your stream ends

Nothing! It is completely automatic.

When you close Google Chrome or OBS, the connection is safely and automatically severed. You do not need to redo these steps every time you stream.

For your next stream:

1. Open OBS Studio.
2. Open Google Chrome.
3. The extension remembers your settings and will silently reconnect to OBS in the background. You can just open Monkey.app and start streaming! (If you ever change your OBS password or rename your Poster, you will just need to update it in the extension popup).

---

Troubleshooting

"The extension says it's connected, but the poster isn't showing up when I skip!"

• Double-check your Scene Name and Poster Source Name in the extension popup. They are Case Sensitive. safe poster will not work if OBS named it Safe Poster. It must be an exact match.

"OBS keeps disconnecting and reconnecting every few seconds."

• This usually means your Password is wrong, or the Port is incorrect. Open OBS -> Tools -> WebSocket Server Settings and double-check your credentials.

"I'm using a different site and it doesn't work."

• Currently, this specific code is tailored to intercept how Monkey.app handles its video connections. Other sites may use different methods that bypass the auto-trigger.