# OBS Troubleshooting: GameClip Won't Connect

> Fix GameClip and OBS Studio problems: no connection, wrong port or password, no replay saved, MKV preview copies, keys that do nothing.

Canonical: https://gameclip.io/guides/obs-troubleshooting.md

[Guides](https://gameclip.io/guides) · [OBS Studio](https://gameclip.io/guides#obs-studio)

GameClip 0.3.2 · Updated November 20, 2026 · 4 min read

If GameClip will not connect to OBS Studio, check five things in order: OBS is open on the same computer, OBS is version 28 or newer, “Enable WebSocket server” is on, the port matches (4455 by default), and the password matches the one under “Show Connect Info”. One of them is almost always the cause.

The setup itself is in [connect OBS Studio](https://gameclip.io/guides/connect-obs-studio).

## Why can’t GameClip connect to OBS?

| Cause | Fix |
|---|---|
| OBS is closed | Open OBS Studio. GameClip reconnects by itself when both apps are open |
| OBS is on another computer | Not supported. OBS and GameClip have to run on the same computer |
| The WebSocket server is off | In OBS: Tools, WebSocket Server Settings, turn on “Enable WebSocket server” |
| Wrong port | Use the port shown in OBS’s WebSocket Server Settings. It is 4455 by default |
| Wrong password | In OBS: WebSocket Server Settings, “Show Connect Info”. Type that password in GameClip |
| OBS is older than 28 | Update OBS. The WebSocket server is built in since OBS Studio 28 |

Work through it like this:

1. Open OBS Studio on the same computer as GameClip.
2. In OBS, open **Tools**, then **WebSocket Server Settings**. If that entry is missing, your OBS is older than 28: update it.
3. Make sure **Enable WebSocket server** is on.
4. Note the port.
5. Press **Show Connect Info** and copy the password. If you do not want a password, turn authentication off instead.
6. In GameClip, open the Recorder tab, set “Record with” to **OBS Studio**, type that port and that password, and press **Connect**.

It worked when the panel shows “Connected to OBS Studio” with the OBS version.

## Why was no replay saved?

A mark key only saves an OBS replay when three things are true:

1. **The Replay Buffer is enabled in OBS.** Open OBS: Settings, Output, Replay Buffer, and turn on “Enable Replay Buffer”, with its length in seconds. GameClip does not change OBS settings, so it cannot enable this for you. Once it is enabled, GameClip starts the buffer when it connects.
2. **“Marks also save an OBS replay” is on.** It is in the OBS panel of GameClip’s Recorder tab. With it off, a mark key only marks the recording.
3. **GameClip is connected.** The panel shows “Connected to OBS Studio”.

Saved replays are listed under “Replays from OBS” in the Recorder tab. The full workflow is in [OBS Replay Buffer clips](https://gameclip.io/guides/obs-replay-buffer-clips).

## Why does the session take a moment before it plays?

Because OBS saved an MKV file. The app’s player cannot play MKV directly, so GameClip makes a light preview copy first, and the session plays from that.

This is expected, and it costs nothing in quality: the export always reads the original file. Your original also stays where OBS saved it; GameClip does not move or copy it.

If you would rather skip the preview copy, OBS can also write MP4, Hybrid MP4 or MOV, and GameClip opens all of them. That choice is made in OBS’s own settings.

## Why do some keys do nothing?

| What you see | Why |
|---|---|
| The mute key (F6) does nothing | In OBS Studio mode the microphone belongs to OBS |
| The screenshot key does nothing | It does not apply in OBS Studio mode |
| F9, F10, F11 do nothing | GameClip is not connected to OBS. Check the panel for “Connected to OBS Studio” |
| F8 and F7 do nothing | Nothing is being recorded and the replay option is off, so there is nothing to mark |
| A key does something else | The keys can be changed in the Recorder tab, under Hotkeys. Check what is set there |

## Why does the recording look or sound wrong?

In this mode the picture and the sound are OBS’s. Scenes, sources, the webcam, audio tracks, the encoder and the quality are all set in OBS, and GameClip’s own capture settings (display, quality, webcam, microphone) do not apply. A black scene, a missing webcam or a quiet microphone is fixed in OBS.

## What if OBS is not worth the trouble?

Switch “Record with” back to GameClip and use the built-in recorder, which needs no setup: see [record with GameClip](https://gameclip.io/guides/record-with-gameclip). Or record however you like and [import the recording](https://gameclip.io/guides/import-a-recording) afterwards. GameClip is a desktop app that turns a gameplay recording into a highlights video and vertical cuts, whoever made the recording. The current version is on the [download page](https://gameclip.io/download).

## FAQ

### Do I need a plugin for OBS?

No. The WebSocket server is part of OBS Studio 28 and newer.

### Do I have to reconnect every time I open OBS?

No. GameClip reconnects by itself every time both apps are open.

### Can GameClip fix my OBS settings for me?

No. It does not change OBS settings, scenes or sources.

### Is the MKV preview copy what gets exported?

No. The preview copy is only for playing the session. The export always reads the original file.

macOS and Windows

GameClip turns long gameplay into a highlights video and vertical clips.

Record with the app or with OBS Studio, mark your plays, cut each clip on the timeline and export.

 [Go to the download](https://gameclip.io/download)
