Back to feed

Godot Plugin

Capture gameplay from Godot 4.x and upload straight to GameFeed.

Requirements

  • Godot 4.x (standard build, .NET not required)
  • FFmpeg installed on your machine
  • A GameFeed account at gamefeed.dev
1

Install FFmpeg

  1. Go to gyan.dev/ffmpeg/builds and download ffmpeg-release-essentials.zip
  2. Extract it and rename the folder to ffmpeg
  3. Move the folder to C:\ffmpeg so that the exe is at C:\ffmpeg\bin\ffmpeg.exe

Alternatively, add FFmpeg to your system PATH:

  1. Search "Edit the system environment variables" in Windows
  2. Click Environment Variables
  3. Under System Variables, find Path → Edit → New
  4. Add the path to your ffmpeg bin folder (e.g. C:\ffmpeg\bin)
  5. Click OK and restart Godot
2

Install the Plugin

  1. Unzip game-feed-plugin.zip
  2. Copy the addons folder into the root of your Godot project (same folder as your project.godot file)
  3. Open your project in Godot
  4. Go to Project → Project Settings → Plugins
  5. Find GameFeed and set it to Enabled
  6. The GameFeed panel will appear in the right-side dock
3

Disable Game Embed Mode

This is required — FFmpeg can only capture a standalone window, not a panel embedded inside the editor.

  1. Go to Editor → Editor Settings
  2. Navigate to Run → Window Placement
  3. Set Game Embed Mode to Disabled
  4. Restart the Godot editor
4

Log In

  1. In the GameFeed dock, enter your gamefeed.dev email and password
  2. Click Log In
  3. Your games and storage usage will load
5

Configure Capture Settings

In the dock you can set:

  • Game — select which of your GameFeed games to post to
  • Title / Caption / Tags — post metadata
  • Change Type — Added / Changed / Fixed / Removed
  • Has Sound — tick if your recording has audio
  • FPS — capture framerate (default 60)
  • Force window size — optionally set a fixed W×H for the game window when launching
6

Record

Option A: Launch & Record (recommended)

  1. Click ▶ Launch & Record
  2. The plugin launches your game and automatically starts recording after ~2.5 seconds
  3. Play your game
  4. Click ⏹ Stop — recording stops and the game closes

Option B: Manual (game already running)

  1. Start your game by pressing Play in Godot normally
  2. Switch back to the editor and click ⏺ Record
  3. Play your game
  4. Click ⏹ Stop
7

Clip & Upload

  1. After stopping, a timeline bar appears showing your full recording
  2. Drag the left handle to set clip start, drag the right handle to set clip end
  3. You can also drag the middle of the selection to slide the whole window
  4. The clip must be between 6 and 15 seconds — the bar turns orange if outside that range
  5. File size and duration are shown below the timeline
  6. Click ↑ Upload to GameFeed
  7. After upload, click View Post to see it live

Troubleshooting

ProblemFix
"FFmpeg not found"Install FFmpeg to C:\ffmpeg\bin\ffmpeg.exe or add to PATH, then restart Godot
"Game window not found"Make sure Game Embed Mode is Disabled and the game is running as a separate window
"No file written"Game window was not detected — check the Output panel for the detected window rect
Recording is black/blankThe game window may have been minimised during recording
Upload failsCheck your internet connection and that you are logged in