Skip to content

gfronza/synclay

Repository files navigation

Synclay

Multi-camera action sports PiP video sync & combine tool.

Visit the Synclay website for downloads, screenshots, and roadmap.

Overview

Synclay automatically synchronizes and combines footage from multiple action cameras into picture-in-picture (PiP) videos. Designed for action sports enthusiasts, Synclay eliminates the need for complex NLE software by detecting audio-based sync offsets and providing intuitive PiP positioning controls for quick multi-angle video creation.

Features

  • Automatic audio sync detection via cross-correlation analysis
  • Picture-in-picture compositing with drag, resize, crop, and border controls
  • Real-time synchronized dual-video preview
  • FFmpeg-powered export with quality presets
  • File watching with auto-detection of video pairs by session time

Tech Stack

Frontend:

  • React 18 + TypeScript
  • Vite

Backend:

  • Tauri 2.0
  • Rust
  • FFmpeg
  • Python sidecar (scipy)

Platform:

  • macOS (Apple Silicon primary)
  • Windows (64-bit x86_64)

Getting Started

Prerequisites:

macOS:

  • macOS 11+ (Apple Silicon recommended)
  • Node.js 18+
  • Rust toolchain
  • Python 3 with scipy and numpy
  • FFmpeg

Windows:

  • Windows 10+ (64-bit)
  • Node.js 18+
  • Rust toolchain with x86_64-pc-windows-msvc target
  • Python 3 with scipy and numpy
  • FFmpeg (downloaded automatically during build)

Installation:

Download pre-built installers:

  • macOS: Download the .dmg file from the latest release
  • Windows: Download the .exe installer from the latest release. Windows may show a SmartScreen warning — click "More info" then "Run anyway".

Build from source:

  1. Clone the repository
  2. Install dependencies: npm install
  3. Run development build: npm run tauri dev
  4. Build production app: npm run tauri build

These steps work on both macOS and Windows.

Usage

  1. Select folder containing MP4 videos
  2. App groups videos by session time
  3. Click Auto-Sync to detect audio offset
  4. Position PiP overlay, adjust crop and borders
  5. Export final composite video

Platform Support

Platform Status
macOS Apple Silicon Supported (primary)
macOS Intel Untested
Windows 64-bit Supported
Linux Not planned

Known Limitations

  • Supports 2 cameras only
  • MP4 format tested (other formats may work)
  • Variable frame rate (VFR) videos may cause sync drift

License

MIT

About

Multi-camera action sports PiP video sync & combine tool.

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors