Installation¶

forgegen is retired — install FunscriptForge instead

forgegen's generation engine now ships inside FunscriptForge, in its Generate tab, along with the editing, multi-device output and export that used to need a second app.

Download FunscriptForge

The v0.3.0 downloads below still work and run offline, but forgegen receives no further updates. forgegen.app is being retired, so use the GitHub links rather than the website.

Standalone app¶

Pre-built desktop installers for Windows, macOS, and Linux are on the final release page. No Python, no FFmpeg install, no dependencies — unzip and run.

Download for Windows Download for macOS Download for Linux

The rest of this page covers installing from source — for developers, contributors, or users who want to run the CLI / Python library directly.

From source¶

Requirements¶

Python 3.10 or newer
FFmpeg (required for video files; not needed for audio-only use)

Python dependencies¶

git clone https://github.com/liquid-releasing/forgegen.git
git clone https://github.com/liquid-releasing/videoflow.git

cd forgegen
pip install -r requirements.txt

FFmpeg¶

FFmpeg is required to extract audio from video files (MP4, MKV, MOV, AVI, etc.). If you only work with audio files (MP3, WAV, FLAC, etc.) you can skip this.

Windows¶

Install the essentials build via winget:

winget install Gyan.FFmpeg.Essentials

Then restart your terminal (and the Tauri dev server if it is already running) so the updated PATH takes effect.

To verify:

ffmpeg -version

Manual install

If winget is not available, download the essentials build from ffmpeg.org/download.html → Windows builds by Gyan. Extract the zip, copy the bin/ folder contents somewhere on your PATH (e.g. C:\ffmpeg\bin), and add that folder to your system PATH in Environment Variables.

macOS¶

Install via Homebrew:

brew install ffmpeg

To verify:

ffmpeg -version

No Homebrew?

Install Homebrew first: brew.sh Or use MacPorts: sudo port install ffmpeg

Linux¶

Ubuntu / Debian:

sudo apt update && sudo apt install ffmpeg

Fedora / RHEL:

sudo dnf install ffmpeg

Arch:

sudo pacman -S ffmpeg

To verify:

ffmpeg -version

Launching the UI¶

cd forgegen
cd tauri
npm install
npm run tauri:dev

Open http://localhost:8501 in your browser.

CLI only (no UI)¶

If you only need the CLI and don't want to run the desktop app:

pip install -e ../videoflow[audio]
videoflow generate-funscript track.mp3