A guide to adding FFmpeg support to LumaChords
If you have redirected to this page, LumaChords could not locate FFmpeg on your system.
To enable video features, please install FFmpeg using one of the methods below based on your operating system.
Why is FFmpeg distributed separately?
LumaChords uses FFmpeg for high-performance video processing as an external tool. FFmpeg is a third-party multimedia framework licensed under the GNU Lesser General Public License (LGPL) version 2.1+ or the GNU General Public License (GPL) version 2+, depending on how it is configured and which components are included. FFmpeg is not included and distributed with LumaChords. LumaChords does not distribute FFmpeg binaries. Users (you) are responsible for installing FFmpeg independently according to their requirements.
Due to licensing restrictions and software patent considerations, we cannot bundle FFmpeg directly with our application or distribute it from our website. Instead, we provide these instructions to help you download and install FFmpeg separately from trusted sources.
Once installed, FFmpeg will enable support for additional video formats and the ability to more performant processing.
Choose the installation method that works best for your operating system.
Once the installation is complete, LumaChords will detect the binary automatically.
If you have Winget installed:
winget install ffmpegIf you haven't Winget installed and you got error, you can install it first through checking out Microsoft's AppInstaller.
Download Windows builds from the official FFmpeg website or trusted third-party providers:
If you are familiar with this method, you can compile FFmpeg from its source code:
sudo apt update && sudo apt install ffmpegsudo dnf install ffmpegsudo yum install ffmpegsudo zypper install ffmpegsudo pacman -S ffmpegsudo apk add ffmpegFFmpeg is available in most Linux distribution repositories. Please consult your distribution's documentation or visit the official FFmpeg website.
If you are familiar with this method, you can compile FFmpeg from its source code:
If you have Homebrew installed already, this is the easiest method:
brew install ffmpegIf you haven't Homebrew installed and you got error, you can install it first through running this command on your Terminal.app:
Then after having Homebrew, run this command to install FFmpeg:
brew install ffmpegDownload macOS builds from the official FFmpeg website or trusted third-party providers:
If you are familiar with this method, you can compile FFmpeg from its source code:
To verify that FFmpeg is installed correctly, open a terminal or command prompt and run:
ffmpeg -versionYou should see version information and configuration details. If you see an error, FFmpeg may not be properly installed or added to your system's PATH.
If our application cannot detect FFmpeg after installation:
On macOS, you may need to grant permission for the application to access FFmpeg:
If you continue to experience problems, please: