gitwtfhub

wtf is fcpluttoeffect?

avis001/fcpluttoeffect — explained in plain English

Analysis updated 2026-05-18

1SwiftAudience · generalComplexity · 2/5Setup · easy

TL;DR

A Mac command line tool and app that turns .cube color LUT files into one click effects inside Final Cut Pro's Effects browser.

Mindmap

mindmap
  root((lutfx))
    What it does
      Converts cube LUTs
      Creates FCP effects
      No custom plugin
    Tech stack
      Swift
      SwiftUI
      Homebrew
    Use cases
      Batch LUT conversion
      Personal color library
      Client LUT delivery
    Audience
      Video editors
      Colorists
      Mac users

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

Why would anyone build with this?

REASON 1

Batch convert a folder of cube LUTs into ready to use Final Cut effects

REASON 2

Apply a personal or client LUT library without browsing the Custom LUT panel each time

REASON 3

Preview how LUTs will look on your own footage before installing them

What's in the stack?

SwiftSwiftUIHomebrew

How it stacks up

avis001/fcpluttoeffectaakarsh-goyal/macjuicealtuzar/sonicflow
Stars111
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencegeneralgeneralgeneral

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

How do you spin it up?

Difficulty · easy Time to first run · 5min

Needs Homebrew or the Swift toolchain to install, only works with Final Cut Pro on macOS.

Wtf does this do

lutfx is a command line tool for macOS, built in Swift, that solves a specific problem in Final Cut Pro. If you have a collection of .cube LUT files, which are color grading presets used in video editing, Final Cut Pro normally makes you use a generic Custom LUT filter and manually browse to each file every time you want to apply a look. This tool converts each .cube file into its own named effect that shows up directly in Final Cut's Effects browser, so you can drag it onto a clip like any other built in effect. Behind the scenes, it does not rely on Motion or a custom plugin. Instead it generates a Motion template that wraps Final Cut's own built in Custom LUT filter with the correct LUT already selected. This keeps things simple: no code signing is required for the generated effects, and everything relies on features Final Cut already has. Alongside the command line tool there is a SwiftUI companion app. You can drag .cube files or whole folders into its window and see a live preview of each LUT before installing it. You can also drop in a screenshot of your own footage so the previews and thumbnails use your actual image instead of a generic gradient, and you can manage or uninstall effects you installed earlier from a dedicated tab. Installation is through Homebrew for a prebuilt universal binary, or you can build it from source with Swift's own build tools. Running the tool on a folder converts every LUT inside, including subfolders, into its own effect, and pointing it at a single file works too. Options let you set a category name for organizing effects in the browser, force overwriting existing ones, preview changes without writing any files, and skip thumbnail generation to save time. The README also documents the file formats involved in detail, including how Final Cut identifies and stores references to each LUT internally. This project is aimed at video editors and colorists who work in Final Cut Pro and want faster access to their LUT collections, and it is useful for anyone maintaining a personal or shared library of color looks.

Yoink these prompts

Prompt 1
Write a bash script that runs lutfx on every subfolder inside my LUTs directory and names the category after each subfolder
Prompt 2
Explain how NSKeyedArchiver plist encoding works so I can understand how lutfx stores the LUT reference in a moef file
Prompt 3
Help me write a Homebrew formula update script for releasing a new lutfx version with a universal binary
Prompt 4
Show me how to safely uninstall a lutfx generated effect and its underlying Custom LUT file

Frequently asked questions

wtf is fcpluttoeffect?

A Mac command line tool and app that turns .cube color LUT files into one click effects inside Final Cut Pro's Effects browser.

What language is fcpluttoeffect written in?

Mainly Swift. The stack also includes Swift, SwiftUI, Homebrew.

How hard is fcpluttoeffect to set up?

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

Who is fcpluttoeffect for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.