macOS
- Download
huff-1.0.2-universal.dmg from the Releases page.
- Open the DMG and drag huff to your Applications folder.
- On first launch macOS may show a Gatekeeper warning. Right-click the app icon → Open → Open to bypass it once.
- Grant camera access when prompted if you plan to use webcam input.
Apple Silicon + Intel: The DMG ships as a Universal binary built with lipo. Runs natively on both M-series and Intel Macs. Syphon.framework is bundled inside the .app — nothing to install separately.
Windows
- Download
huff-1.0.2-x64-setup.exe (or the .msi) from the Releases page.
- Run the installer.
- Windows SmartScreen may warn about an unsigned binary — click More info → Run anyway.
- For Spout output, install the Spout2 runtime separately.
- Microsoft Edge WebView2 Runtime is required on Windows 10. Pre-installed on Windows 11.
SmartScreen warning: Expected on unsigned builds. Click More info → Run anyway. This will be resolved in future releases with a code-signing certificate.
Building From Source
Prerequisites
| Tool | Version | Notes |
|---|
| Node.js | ≥ 18 LTS | nodejs.org |
| Rust + Cargo | stable | Install via rustup.rs |
| Tauri CLI | 1.x | Installed via npm install |
macOS extra: Xcode Command Line Tools
xcode-select --install
Windows extra: Build Tools for Visual Studio with Desktop development with C++.
rustup target add x86_64-pc-windows-msvc
Linux extra: WebKitGTK development libraries.
sudo apt install -y libwebkit2gtk-4.0-dev build-essential libssl-dev libgtk-3-dev
sudo pacman -S --needed webkit2gtk base-devel openssl gtk3
sudo dnf install webkit2gtk4.0-devel openssl-devel
Clone and Run
git clone https://github.com/your-org/huff.git
cd huff
npm install
npm run dev
npm run build
npx tauri build