Navin

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

PackageTierTypical location
Stock clients (Pexels, Unsplash, Pixabay)builtinNavin code - free API keys only
FFmpegsystem / user-localPATH or ~/.navin/montage/bin
HyperFrameslazy npm~/.navin/montage
Remotionoptional 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:

  1. OS package manager when it can run non-interactively:
    • Windows: winget (Gyan.FFmpeg) then Chocolatey
    • macOS: Homebrew
    • Linux: apt-get, dnf, yum, pacman (with passwordless sudo -n when available)
  2. 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

NeedPackage
HTML/CSS/GSAP composition → MP4HyperFrames (~120 MB)
React scenes (optional, heavy)Remotion (~350 MB)
Social crops from a demoFFmpeg 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.

Related reading