explaingit

robesris/ffvii-realtime

Analysis updated 2026-05-18

5PythonAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

A tool that automatically detects and removes slow-motion Tactical Mode pauses from Final Fantasy VII Rebirth combat recordings so fights play at real-time speed.

Mindmap

mindmap
  root((repo))
    What it does
      Detects slow motion
      Speeds up footage
      Keeps audio synced
    Tech stack
      Python
      OpenCV
      FFmpeg
    Use cases
      Fix gameplay recordings
      Prepare highlight clips
      Support multiple games
    Audience
      FFVII players
      Content creators

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

Speed up recorded Final Fantasy VII Rebirth fights so Tactical Mode pauses run at normal speed.

USE CASE 2

Prepare cleaner gameplay clips for YouTube or streaming without slow-motion interruptions.

USE CASE 3

Process Remake or Revelation footage by selecting the matching game option.

What is it built with?

PythonOpenCVFFmpeg

How does it compare?

robesris/ffvii-realtime1ncendium/aibusteraaronmayeux/ha-hurricane-tracker
Stars555
LanguagePythonPythonPython
Setup difficultyeasymoderateeasy
Complexity2/53/52/5
Audiencegeneralops devopsgeneral

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

How do you get it running?

Difficulty · easy Time to first run · 5min
Free to use and modify, but any modified or hosted version must also share its source code under the same license.

In plain English

FFVII Realtime is a small command line and browser tool that fixes a specific annoyance in recordings of Final Fantasy VII Rebirth combat, and it also supports Remake and Revelation. When you open Tactical Mode to pick your commands, the game drops into heavy slow motion, about 100 times slower than normal. That is fine while playing, but it makes recorded fights tedious to watch, since long pauses interrupt the action. The tool scans a video frame by frame using OpenCV, a computer vision library, to spot Tactical Mode. It looks for the on-screen button prompts and the menu header text, and checks that the scene is actually moving in slow motion before it decides a segment qualifies. This means it can detect Tactical Mode even in solo boss fights where the usual button prompts do not appear. Once the slow-motion sections are found, FFmpeg, a video processing tool, speeds those parts back up to match the rest of the fight, while leaving normal combat untouched. Because speeding up a slow-motion segment so much would otherwise squeeze its audio into an unusably short burst, the tool blends the sound at each seam with a crossfade between the audio just before and just after the slow motion, so playback never cuts out or jumps. Installing it is a single command through pipx, which bundles FFmpeg so nothing else needs to be installed separately. The tool provides both a browser based drag and drop interface and a command line for detecting and rendering fixed videos, along with a preview mode for testing settings on a short clip before processing a full recording. Users must specify which of the three games their footage comes from, since detection depends on each game's specific on-screen elements. This is aimed at players who record their own Final Fantasy VII gameplay and want to share cleaner, faster paced highlight clips or full fight videos without the slow motion pauses breaking up the pacing.

Copy-paste prompts

Prompt 1
Help me install ffvii-realtime with pipx and run it on my Final Fantasy VII Rebirth recording.
Prompt 2
Explain how to use the --range option in ffvii-realtime to preview a short section of my video before processing the whole file.
Prompt 3
Show me how to use ffvii-realtime's detect and render commands separately to reuse saved timing data.

Frequently asked questions

What is ffvii-realtime?

A tool that automatically detects and removes slow-motion Tactical Mode pauses from Final Fantasy VII Rebirth combat recordings so fights play at real-time speed.

What language is ffvii-realtime written in?

Mainly Python. The stack also includes Python, OpenCV, FFmpeg.

What license does ffvii-realtime use?

Free to use and modify, but any modified or hosted version must also share its source code under the same license.

How hard is ffvii-realtime to set up?

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

Who is ffvii-realtime for?

Mainly general.

Open on GitHub → Explain another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.