Montage
Install FFmpeg, HyperFrames and Remotion in Navin Montage
August 9, 2026 · 2 min read · Navin team
OS detection (apt, brew, winget…), Install button, user-local fallback under ~/.navin/montage/bin - no cold-start bundle.
In Navin's Montage studio, the toolchain decides whether you can package a demo or render a composition. Navin does not ship FFmpeg / HyperFrames / Remotion inside the install binary: it detects them and installs on demand per OS.
Docs: Montage packages · Media models (Veo, Lyria, Nano Banana…) · App → posts loop
GTM reminder: you build web/mobile in Navin; Montage packages footage and creatives. FFmpeg / HyperFrames are the local layer - AI models are chosen separately.
What is bundled vs lazy
| Package | Tier | Typical location |
|---|---|---|
| Stock clients (Pexels, Unsplash, Pixabay) | builtin | Navin code - free API keys only |
| FFmpeg | system / user-local | PATH or ~/.navin/montage/bin |
| HyperFrames | lazy npm | ~/.navin/montage |
| Remotion | optional lazy npm | ~/.navin/montage/remotion |
Cold start: no heavy npm download. HyperFrames and Remotion only via Install or montage(action=setup, package=…).
FFmpeg: detection and Install button
Montage resolves ffmpeg on PATH, then the user-local binary under ~/.navin/montage/bin.
Install order:
- OS package manager when it can run non-interactively:
- Windows:
winget(Gyan.FFmpeg) then Chocolatey - macOS: Homebrew
- Linux:
apt-get,dnf,yum,pacman(with passwordlesssudo -nwhen available)
- Windows:
- Otherwise user-local fallback (no root): static build into
~/.navin/montage/bin
If the UI shows “not on PATH” with no Install button, upgrade/restart the gateway: missing FFmpeg must expose Install whenever a recipe can run.
Handy manual commands
# Ubuntu / Debian
sudo apt-get install -y ffmpeg
# Fedora
sudo dnf install -y ffmpeg
# macOS
brew install ffmpeg
winget install --id Gyan.FFmpeg -e --accept-source-agreements --accept-package-agreements
HyperFrames vs Remotion
| Need | Package |
|---|---|
| HTML/CSS/GSAP composition → MP4 | HyperFrames (~120 MB) |
| React scenes (optional, heavy) | Remotion (~350 MB) |
| Social crops from a demo | FFmpeg alone |
Prefer HyperFrames for motion promos. Install Remotion only when you explicitly want React scenes.
Doctor reuses system Chrome/Chromium or an existing Playwright Chromium cache - no second browser download when Playwright is already present.
Check from chat
/montage Run montage(action=doctor) then montage(action=detect). List ffmpeg path, HyperFrames, Remotion, Chrome. Install only what is missing for packaging a demo.
Or use Check toolchain on the Actions tab.
Toolchain FAQ
Is FFmpeg packaged by default with Navin?
No. If it looks ready, it was already on the host (or installed by Montage under ~/.navin/montage/bin).
Why did apt show missing with no Install button before?
Without passwordless sudo, older logic hid Install. Current builds fall back to user-local install.
Is Remotion required?
No. It is optional. HyperFrames + FFmpeg cover most Montage paths.
Montage studio · Package docs · Download
Try Navin on your machine
Local agent, cross-platform. Code, debug, scrape, leads, security and review - without leaving Navin.