Repository navigation
Releases: Icey321/StudioFF
Release list
StudioFF v0.64
Tested with FaceFusion v4 commit e7a2848 (2026-10-30). Go to StudioFF's FaceFusion settings and press Use Tested Version for best compatibility.
New since v0.63
- Batch face selector: choose One, Many or Reference mode in Batch too. One mode picks a face by Order (left, right, top, bottom...); Batch starts in Many mode
- Reference face picker in Batch: click the face to change on the target. Every face that will be changed is ringed
- "(2) faces look alike" message in Batch and Studio when more than one face matches, with the Distance that changes only one
- Gender and Race now offer Any and Same as Source
- Options a run will not use are grayed out with a short reason (face options without a face processor, unused mask, weight, encoder and output options, Face Mapping's mode)
- Drag an option group by its title to put the groups in any order (Studio and Batch keep their own order)
- Restore button on the Source card brings removed sources back, also after Remove all and a restart
- Batch: files added by hand (not from the target folder) come back with Restore removed
- Face Mapping's everyone-same-source run no longer applies the Gender, Race and Age filters
- Pinokio support removed
Updating from v0.63: open Settings and press Update to v0.64.
New install
- Download Source code (zip) below and unzip it.
- Right-click
install.ps1and choose Run with PowerShell. - Open StudioFF from the desktop shortcut, then open the FaceFusion settings to point it at FaceFusion v4 or install it.
FaceFusion itself is not included. See the README for details.
StudioFF v0.63
Tested with FaceFusion v4 commit e7a2848 (2026-10-30). Go to StudioFF's FaceFusion settings and press Use Tested Version for best compatibility.
New since v0.62
- Pre-Check replaces NSFW Check in Studio and Batch: after the NSFW check it looks for faces. Batch marks targets with none "No face detected, will be skipped", and Run Batch skips them too (Retry forces a run)
- GIFs are face-checked through their video, so a GIF with a face is no longer reported as having none
- Clearer Console errors: a failed step ends with its name, a plain "Why:" line and a "Fix:" line when the cause is known (missing package, full drive, no permission, out of memory, missing file, CUDA not usable, an option FaceFusion did not accept)
- Install FaceFusion now installs the commit StudioFF was tested with, not the newest one
- On first start StudioFF looks for a FaceFusion that is already installed and fills in the FaceFusion page
install.ps1offers to install uv with winget when the PC has no Python 3.10 or newer (it asks first)- Converting AVIF, HEIC, animated WebP, FLV and GIF targets no longer freezes the window
- Linux and macOS support (experimental, untested), with Linux work from tokenwizard's fork
- "Planned Outputs" label on Batch
Updating from v0.62: open Settings and press Update to v0.63.
New install
- Download Source code (zip) below and unzip it.
- Right-click
install.ps1and choose Run with PowerShell. - Open StudioFF from the desktop shortcut, then open the FaceFusion settings to point it at FaceFusion v4 or install it.
FaceFusion itself is not included. See the README for details.
StudioFF v0.62
Tested with FaceFusion v4 commit e7a2848 (2026-10-30). Go to StudioFF's FaceFusion settings and press Use Tested Version for best compatibility.
- Face mapping swaps everyone in a single FaceFusion run with the new
--face-selector-map, about 25% faster than the old one-run-per-person route. - The face you pick is used on the Batch page and in Studio runs that swap only one person (not always the largest face).
- A Batch run is no longer stopped by Studio's automatic NSFW check; that check now waits until the batch is done.
- FaceFusion page: rows renamed "Operating System", "FaceFusion Installed" and "FaceFusion on GitHub"; Tested With shows the v4 branch; an Open GitHub link beside Install FaceFusion; "Go Back to Previous Version"; Check for FaceFusion Updates is highlighted.
StudioFF v0.61
Tested with FaceFusion v4 commit a24893c (2026-10-19). Go to StudioFF's FaceFusion settings and press Use Tested Version for best compatibility.
- The taskbar's right-click Close Window now really closes the app. Only the X in the title bar minimizes or goes to the tray.
- The system tray icon is created once and kept, so it no longer goes missing. If it cannot be shown, the window minimizes to the taskbar instead of vanishing.
StudioFF v0.60
Tested with FaceFusion v4 commit a24893c (2026-10-19). Go to StudioFF's FaceFusion settings and press Use Tested Version for best compatibility.
StudioFF is a desktop app for the FaceFusion v4 face swapper. Not made or endorsed by the FaceFusion team.
New since v0.50
- New FaceFusion page in the side bar: Updates, Already Installed and Install cards, an orange dot when a new FaceFusion release is out, and its own startup check
- Install FaceFusion offers to install a missing Git, uv, FFmpeg or curl with winget
- Studio Pause, Resume, Free Memory and a run clock; Batch Pause and Resume too
- Face Mapping works on GIF and animated WebP targets
- Group multiple Source faces and Groups can be renamed and used in Face Mapping
- Animated WebP keeps its transparency through a run
- New file types: AVIF, HEIC, JFIF, MPG/MPEG, FLV/F4V and animated WebP
- Drive space bar under the Output Folder box in Studio and Batch, with the free space under the label; optional drive readings in the title bar (Settings, Hard drives)
- Previous and Next buttons on the Batch preview
- No face warning with a red border under the preview
- Face Frame label stays on the preview, Console wraps long lines
- Studio's Stop button no longer stops a Batch run
- Update button in the title bar, Close button choice, remembered window size
- MIT license
Updating from v0.50: open Settings and press Update to v0.60.
New install
- Download Source code (zip) below and unzip it.
- Right-click
install.ps1and choose Run with PowerShell. - Open StudioFF from the desktop shortcut, then open the FaceFusion settings to point it at FaceFusion v4 or install it.
FaceFusion itself is not included. See the README for details.
StudioFF v0.50
Tested with FaceFusion v4 commit a24893c (2026-10-19). Go to StudioFF's FaceFusion settings and press Use Tested Version for best compatibility.
StudioFF is a desktop app for the FaceFusion v4 face swapper. Not made or endorsed by the FaceFusion team.
New since v0.40
- Batch keeps the models loaded from one file to the next: in our tests images finished 3x faster (about 7 s down to 2.3 s each) and short videos 7% faster
- Run Batch checks unchecked targets for NSFW content first and skips flagged ones, warns before replacing existing files, and shows a run timer
- Batch rows show a progress ring with percent and frames per second, plus each target's length and file size
- Drop single files on the Batch list, or pick them with Add Files, to add them as targets
- Batch can skip the running output, and retry or remove items from the list
- Batch status tabs for Errors, NSFW and Skipped, and a right-click menu to copy a file name or open its folder
- Presets shared between Studio and Batch
- Landmarks button on Studio and Batch: each click cycles through the 5 key points, the 68 face points, and off, without turning on the Face Debugger
- Face tags show the distance to the reference face and the race, for example
#1 84% Dist 0.00 F 20-29 White - Face Mapping has an on/off switch, a refresh button, and a way to remove a person and add them back
- The Console is coloured like VS Code, in both light and dark themes
- Double-click a divider on Studio or Batch to reset it; the Target card on Studio can be resized
- StudioFF opens maximized
Updating from v0.40: open Setup and press Update to v0.50.
New install
- Download Source code (zip) below and unzip it.
- Right-click
install.ps1and choose Run with PowerShell. - Open StudioFF from the desktop shortcut, then go to Setup to point it at FaceFusion v4 or install it.
FaceFusion itself is not included. See the README for details.
StudioFF v0.40
Tested with FaceFusion v4 commit a24893c (2026-10-19). Go to StudioFF's FaceFusion settings and press Use Tested Version for best compatibility.
StudioFF is a desktop app for the FaceFusion v4 face swapper. Not made or endorsed by the FaceFusion team.
New since v0.30
- System monitor in the title bar: graphics card, video memory, processor and memory use, once a second. Each reading has a bar that goes from green to orange to red as it fills. It can be turned off in Setup
- Setup shows whether your FaceFusion is the version StudioFF was tested with, and can switch to it, to the latest version, or back
- Batch lets you pick the frame each video previews on, and remembers it
- Batch outputs you remove stay removed after a restart
- Copy Settings from Studio asks before replacing settings that differ
- Stopping a preview keeps the models loaded, so the next preview starts faster
- Studio's left column scrolls instead of squashing in a short window
- Settings are read again if another program holds the file for a moment, and are never saved over a file that couldn't be read
- App data now lives in
%APPDATA%\StudioFF. It moves there on its own the first time you start this version
Updating from v0.30: open Setup and press Update to v0.40.
New install
- Download Source code (zip) below and unzip it.
- Right-click
install.ps1and choose Run with PowerShell. - Open StudioFF from the desktop shortcut, then go to Setup to point it at FaceFusion v4 or install it.
FaceFusion itself is not included. See the README for details.
StudioFF v0.30
Tested with FaceFusion v4 commit a24893c (2026-10-19).
First release under the new name StudioFF (it was called FaceFusion Studio). StudioFF is a desktop app for the FaceFusion v4 face swapper. Not made or endorsed by the FaceFusion team.
New since v0.2
- New name: StudioFF. Your settings, presets and FaceFusion setup are kept, and the old shortcut keeps working
- Face mapping keeps the audio lossless between passes and sets the volume once, so the sound comes out cleaner
- Batch runs GIF targets correctly, and ends cleanly when a run can't start, so its buttons come back
- Stop clears only that run's temporary files
- Setup checks Python and FaceFusion without freezing the window, and the three FaceFusion sections share one card
- Previews with only lip sync turned on say that lip sync needs the whole video, instead of failing
- The Result view and the face scan are faster (frames and faces are read once instead of twice)
- Updates check that the download is complete and undamaged, and an update that fails puts everything back
- Benchmark export works again
Updating from v0.2: open Setup and press Update to v0.30. Your old desktop shortcut keeps working.
New install
- Download Source code (zip) below and unzip it.
- Right-click
install.ps1and choose Run with PowerShell. - Open StudioFF from the desktop shortcut, then go to Setup to point it at FaceFusion v4 or install it.
FaceFusion itself is not included. See the README for details.
FaceFusion Studio v0.2
Tested with FaceFusion v4 commit a24893c (2026-10-19).
Third release of FaceFusion Studio, a custom UI for the FaceFusion v4 face swapper.
New since v0.1b
- One-click updates: Setup's Update to vX button downloads a new release, closes the app, swaps in the new files and opens it again, keeping your settings, presets and FaceFusion
- A startup splash with a loading bar, and starting the app again brings the open window to the front
- Faster start: about 1.5 seconds less before the window shows
- Open Output Folder button at the right of the Studio and Batch bottom bars
- Setting groups remember whether you left them open or closed
- Face mapping: the Find people button and the Face mapping box turn the accent color while people are found
Install
- Download Source code (zip) below and unzip it.
- Right-click
install.ps1and choose Run with PowerShell. - Open FaceFusion Studio from the desktop shortcut, then go to Setup to point it at FaceFusion v4 or install it.
Updating from v0.1b: v0.1b has no Update button yet. Install it the same way as above; your settings are kept. From v0.2 on, Setup updates the app for you.
FaceFusion itself is not included. See the README for details.
FaceFusion Studio v0.1
Tested with FaceFusion v4 commit a24893c (2026-10-19).
First release of FaceFusion Studio, a Windows desktop app for FaceFusion v4.
Install
- Download Source code (zip) below and unzip it.
- Right-click
install.ps1and choose Run with PowerShell. - Open FaceFusion Studio from the desktop shortcut, then go to Setup to point it at FaceFusion v4 or install it.
FaceFusion itself is not included. See the README for details.