OpenRec

OpenRec is a Tauri-based desktop screen recorder/editor focused on reliable capture, recoverable stop/finalization flows, and practical export tooling.

Naming note: the product is referred to as OpenRec in docs.
The macOS app bundle appears as Open Rec.app in Finder.

Highlights

• Screen or window recording (ScreenCaptureKit on macOS, FFmpeg/X11 on Linux)
• Optional camera + microphone tracks
• Pause/resume with segment stitching at stop
• Floating recording widget with shortcut-based fallback control
• Recovery-oriented stop/finalization flow with retry support
• Timeline editing (trim/cut, zoom, speed effects, undo)
• MP4/GIF exports with queueing, progress, and cancellation
• .openrec project association + recent-project window open actions

Tech stack

• Tauri 2
• React 19 + TypeScript + Vite 7
• Tailwind CSS 4 + shadcn/ui
• Zustand
• FFmpeg / ffprobe (bundled sidecars where available)

Requirements

• macOS 15+ for ScreenCaptureKit runtime behavior
• Linux with X11/XWayland (DISPLAY) and ffmpeg available on PATH
• Node.js + pnpm
• Rust toolchain

Workspace layout

• apps/desktop - the Tauri desktop app (React + Vite frontend and Rust backend)
• apps/landing - the Next.js landing page with release download links
• docs - repository documentation and workflow references

Development quick start

# install dependencies
pnpm install

# workspace checks
pnpm run verify:docs
pnpm run check
pnpm run test

# backend checks
pnpm --filter @openrec/desktop run cargo:fmt
pnpm --filter @openrec/desktop run cargo:test

# desktop frontend only
pnpm run dev

# landing page
pnpm run dev:landing

# native desktop app
pnpm run tauri:dev

Single-command local baseline:

pnpm run verify:ci-local

Build

pnpm run build
pnpm run tauri:build

Documentation map

See docs/README.md for full navigation.
Quick links:

• Validation status snapshot: docs/FINAL_VALIDATION_STATUS.md
• Execution checklist: docs/PLAN_EXECUTION_CHECKLIST.md
• macOS runtime acceptance checklist: docs/MACOS_RUNTIME_VALIDATION_CHECKLIST.md
• Recovery warning playbook: docs/RECOVERY_WARNING_PLAYBOOK.md
• Unsigned install guide: docs/UNSIGNED_MAC_INSTALL.md
• CI workflow reference: docs/CI_WORKFLOWS.md
• Local build troubleshooting: docs/LOCAL_BUILD_TROUBLESHOOTING.md

Contributor workflow:

• CONTRIBUTING.md

Advanced runtime timeout overrides

Recorder/widget timeout budgets can be overridden through localStorage["openrec.runtime-timeout-settings-v1"].

See: docs/RUNTIME_TIMEOUT_OVERRIDES.md for supported fields, example payloads, and reset instructions.