explaingit

edualnog/medusa-clip

Analysis updated 2026-05-18

15PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

Medusa Clip is a free, local-first desktop app that cuts long gameplay videos into short 9:16 clips for social media, with auto-captions and AI-powered highlight detection.

Mindmap

mindmap
  root((Medusa Clip))
    What it does
      Gameplay clipping
      Vertical reframing
      Auto captions
    Pipeline
      Local transcription
      AI moment selection
      FFmpeg encoding
    Setup
      Self-contained installer
      BYO API key
      No account needed
    Audience
      Gamers
      Content creators
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Turn a long gaming session recording into 3-5 short vertical clips ready to post on TikTok or Reels

USE CASE 2

Add automatic word-by-word karaoke captions and a headline hook to gameplay clips

USE CASE 3

Process video entirely on your own computer with no cloud upload using your own AI API key

What is it built with?

PythonElectronNext.jsFFmpegOpenAI API

How does it compare?

edualnog/medusa-clip13127905/deep-learning-based-air-gesture-text-recognition-6xvl/paralives-plugins-index
Stars151515
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencegeneraldevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · easy Time to first run · 5min

Requires an API key from OpenAI, Anthropic, or OpenRouter, the installer bundles FFmpeg and the Python engine.

AGPL-3.0: free to use, modify, and distribute, but modified versions you distribute must also be released as AGPL-3.0 open source.

In plain English

Medusa Clip is a desktop application that takes long gaming video recordings and automatically finds the best moments, cutting them into short vertical clips in 9:16 format suitable for TikTok, Reels, and YouTube Shorts. The cutting engine is built specifically for gameplay: it reads audio levels, motion in the frame, and visual content to identify highlights such as clutch plays, failures, climactic moments, and reactions. The app runs entirely on your own computer. The video never leaves your machine, there is no account or login required, and the AI processing uses an API key you supply yourself from providers such as OpenAI, Anthropic, or OpenRouter. You pay the provider directly, and the README estimates the cost at a few cents per batch of clips for a ten-minute video. Output includes two reframing options: a facecam-plus-gameplay layout with a blurred background, or a full-gameplay focus layout. Each clip gets karaoke-style word-by-word captions and a hook headline automatically. The processing pipeline runs transcription on-device using GPU acceleration when available, then sends multimodal analysis to the AI provider to select and judge the best moments in parallel. The application is packaged as a self-contained installer for macOS, Windows, and Linux. The installer includes the Python processing engine, FFmpeg, and FFprobe, so users do not need to install Python or any other tools separately. The installers are not yet code-signed, so first-time users on macOS and Windows need to approve the app through an extra confirmation step. The README and project are written in Brazilian Portuguese, though the application itself functions in any language its transcription model supports. The project is free and open source under the AGPL-3.0 license. Contributions are welcome and the project has a Discord community.

Copy-paste prompts

Prompt 1
How do I install Medusa Clip on Windows and enter my OpenAI API key for the first time?
Prompt 2
What AI providers does Medusa Clip support, and how do I switch between OpenRouter, OpenAI, and Anthropic?
Prompt 3
How does Medusa Clip decide which moments to clip from a gameplay video, and can I influence the selection?
Prompt 4
What is the difference between the facecam layout and the full-gameplay layout in Medusa Clip output?

Frequently asked questions

What is medusa-clip?

Medusa Clip is a free, local-first desktop app that cuts long gameplay videos into short 9:16 clips for social media, with auto-captions and AI-powered highlight detection.

What language is medusa-clip written in?

Mainly Python. The stack also includes Python, Electron, Next.js.

What license does medusa-clip use?

AGPL-3.0: free to use, modify, and distribute, but modified versions you distribute must also be released as AGPL-3.0 open source.

How hard is medusa-clip to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is medusa-clip for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Scan in gitsafehub Deploy in gitdeployhub edualnog on gitmyhub

Verify against the repo before relying on details.