Install FreeMoCap
Download
Go to the FreeMoCap download page and get the file for your computer:
| Your computer | File |
|---|---|
| Mac with Apple Silicon (M1 or newer) | .dmg |
| Windows PC | .exe: the CUDA version if you have an NVIDIA graphics card, otherwise the CPU version |
| Linux PC | .deb for Ubuntu, Debian, Mint, and similar, otherwise .AppImage. CUDA version if you have an NVIDIA graphics card. |
If you're not sure whether you have an NVIDIA graphics card, get the CPU version.
Install and open FreeMoCap
- Mac
- Windows
- Linux
- Open the
.dmg. - Drag FreeMoCap into your Applications folder.
- Open FreeMoCap from Applications.
If macOS blocks it, open System Settings > Privacy & Security and click Open Anyway.
- Double-click the
.exeand follow the installer. - Open FreeMoCap from the Start menu.
If you see a Windows protected your PC message, click More info, then Run anyway.
For the .deb, run:
sudo apt install ./freemocap_*.deb
Then open FreeMoCap from your app launcher.
For the .AppImage, run:
chmod +x freemocap_*.AppImage
./freemocap_*.AppImage
The first launch can take a minute. Stay online for your first recording, because FreeMoCap downloads its tracking model then.
Update
Choose Help > Check for Updates…. If there's a new version, FreeMoCap offers to install it.
Uninstall
Uninstall FreeMoCap the way you'd uninstall any app. Your recordings stay in the
freemocap_data folder in your home folder.
Run from source (for developers)
Install uv,
Node.js, and git, then run:
git clone https://github.com/freemocap/freemocap.git
cd freemocap
uv sync
uv run python freemocap/__main__.py
On Windows or Linux without an NVIDIA graphics card, use
uv sync --no-default-groups --group cpu instead of uv sync.
In a second terminal, start the interface:
cd freemocap-ui
npm install
npm run dev
Next
Make your first recording. Stuck? See
fix an installation problem or ask in #help-requests on
Discord.