by Samourai Coop
v1.0.3

From raw footage to
rough cut, automated

SmoothFlow analyzes your video footage locally and executes precise editing commands inside Adobe Premiere Pro — so you start with an intelligent rough cut instead of a blank timeline.

Download for macOS
macOS 12+ · Apple Silicon · ~368 MB

Analysis Pipeline

ProbeFFprobe
TranscribeWhisper
Diarizepyannote
ScenesPySceneDetect
SilenceFFmpeg
ClassifyAI

Features

6-Stage Analysis

Probe, transcribe, diarize, detect scenes, detect silence, classify — all parallel, all cached.

Premiere Pro Integration

Creates bins, markers, subclips, and a Selects sequence directly inside your project.

Manual Override

Review every clip. Edit tags, exclude footage, batch-mark as reviewed. You stay in control.

Runs Locally

All analysis happens on your machine. Your footage never leaves your disk.

AI Classification

Bring your own Anthropic or OpenRouter key. Classifies interview, B-roll, action, dead air.

Bilingual

Full French + English interface. Localized Premiere bins. 158 i18n keys.

Changelog

v1.0.3 May 13, 2026
  • Sprint 2 silent-data-loss patch: 8 fixes from a 26-expert cross-perspective audit
  • Fixed: every subclip created since v0.9.x was silently audio-only
  • Fixed: French/accented filenames silently failed clip matching (NFC/NFD normalization)
  • Fixed: audio-only clips (VO, music, Foley) dropped from Selects sequences
  • Fixed: fresh installs stuck on “Disconnected” after onboarding (CEP session token)
  • New CI guard prevents Pydantic-to-Zod schema drift recurrence
  • 407 tests across 32 files, 8-context branch protection on main
v1.0.2 May 13, 2026
  • Sprint 1 post-freeze hardening after 19-day CI billing outage
  • Custom content types now flow end-to-end through the classifier
  • 393 tests, branch protection enforced on main
v1.0.0 Apr 22, 2026
  • First production release — signed, notarized, and stapled for macOS Gatekeeper
  • All v0.9.0 audit items closed (Batches A–G): security, stability, UX, test harness
  • 344 tests across 30 files, two CI workflows guard every PR
v1.0.0-rc.1 Apr 15, 2026
  • v1.0 release candidate — all v0.9.0 audit items closed (Batches A–G), 196 tests passing across 20 files
  • First SmoothFlow build signed AND notarized — opens with a double-click on a fresh Mac, no right-click → Open dance
  • Zero code changes vs. v0.9.8 — this is a soak candidate. Shipping GA after a few days of real-footage use
v0.9.8 Apr 15, 2026
  • DB cache refcount: concurrent handlers can no longer race on a mid-operation SQLite close
  • CEP manifest version parsing via fast-xml-parser — no more regex breakage on Adobe attribute reordering
  • derush-to-premiere: endUndoGroup failures no longer swallow the inner exception
  • ClipReviewPanel: focus trap, ESC to close, focus restoration on unmount, role=dialog + aria-modal
  • DerushView clip list: arrow-key wraparound (matches Premiere bin navigation)
  • ProjectView: stale-update guard prevents rapid project switching from overwriting the wrong project’s status
  • Strict WebSocket handshake is now the default (was compat in v0.9.7). SMOOTHFLOW_COMPAT_HANDSHAKE=1 is the emergency rollback.
  • 161 tests, typecheck + lint + audit clean
v0.9.7 Apr 14, 2026
  • Batch C security hardening: closes the three v0.9.0 audit deferrals that block v1.0
  • WebSocket bridge real token handshake (compat mode this release, strict in v0.9.8) + CEP panel 1.2.0 with handshake client
  • Zod input validation across 19 IPC channels, structured INVALID_INPUT errors, log-safe field-path-only rejection messages
  • Path-traversal guards on every path-accepting handler via known-project-root enforcement
  • Analysis server response schema validation replaces « as Record<string,unknown> » coercion
  • safeStorage encryption failures now surface as actionable errors instead of silently clearing the API key
  • 160 tests (+9 security), all green
v0.9.6 Apr 14, 2026
  • Shutdown race fix: Cmd+Q now awaits bridge + analysis-server cleanup before exiting the process
  • Test-isolated logger via SMOOTHFLOW_LOG_DIR env var; test runs no longer pollute ~/.smoothflow/logs/
  • Classified derush errors in the UI (analysis down / Premiere disconnected / timeout / generic) with recovery hints and collapsible raw details — no more Python tracebacks as error UI
  • Settings AI provider strings now i18n’d (FR + EN)
  • Landing page: filled missing v0.3.0 / v0.4.0 / v0.7.1 changelog blocks
v0.9.5 Apr 14, 2026
  • CEP panel can finally connect to SmoothFlow — was bundled without Adobe’s CSInterface.js, throwing silently on load and never reaching the WebSocket connection code
  • CEP panel auto-recovers when its install folder is missing but onboarding is marked complete (was previously a permanent trap state)
  • New « Extension Premiere Pro » card in Settings > General with live status and a manual reinstall button
v0.9.4 Apr 14, 2026
  • CEP panel auto-upgrades on app launch — v0.9.3’s manifest fix now reaches existing v0.9.2 users without requiring them to manually reinstall the extension
  • UI polish: window title no longer clipped by macOS traffic-light buttons, « Premiere Pro » action button relabeled « Configurer Premiere », empty state added when no media has been scanned
  • Sidebar project status no longer shows stale « Analyse en cours » after the project moves to « Prêt »
v0.9.3 Apr 14, 2026
  • CEP panel now loads on Premiere Pro 2026 — manifest required CSXS 13 but PPRO 26 ships CEP runtime 12.x, causing silent rejection at scan time
  • Required CSXS lowered to 9.0 (matches Adobe’s bundled FrameIO panel, works on every PPRO from 2018+)
  • PlayerDebugMode now set for CSXS 11–16 to cover future PPRO releases
v0.9.2 Apr 14, 2026
  • Premiere Pro detection fixed for 2024+ — was matching a stale bundle identifier and failing on every modern install
  • Filesystem fallback added in case Spotlight hasn’t indexed a freshly installed Premiere yet
  • Onboarding error messages now properly translated (FR/EN) via stable error codes instead of hardcoded English
v0.9.1 Apr 14, 2026
  • White screen on launch fixed: postbuild strips Vite's crossorigin attribute that blocked JS/CSS under file://
  • Renderer load resilience: 5s mount-failure overlay, main-process error recovery, sanitized diagnostic fallback page
  • Code signing: Developer ID Application (Samourai Coop) — Gatekeeper first-run prompt only, no more xattr workaround
  • Resign script hardened: detects ad-hoc vs Developer ID, falls back without --timestamp when Apple's timestamp server is unreachable
  • Build pipeline: explicit notarize: false guards against accidental notarization runs without credentials
v0.9.0 Apr 10, 2026
  • Cross-perspective audit (CTO, fullstack, Adobe/plugin, UX, post-production)
  • Build pipeline rebuilt: correct afterSign hook, split entitlements, re-sign 647 nested Mach-Os
  • Analysis server: health-poll startup, killed zombies, PyInstaller datas/hiddenimports for torch/pyannote/whisper
  • Derush: pipelineStarting leak fixed, UPSERT preserves created_at, abort race closed
  • Premiere: safeAddClipToSequence wrapped in try/finally (no more master-clip corruption)
  • CEP manifest: CSXS 13.0 for Premiere Pro 2025 compatibility
  • UX: arrow-key filter honoring, R/X error toasts, gap-state spinner, correct stage labels
  • Security: safeStorage plaintext refusal, API-key-in-DMG vector closed
v0.8.0 Apr 8, 2026
  • 23-item audit follow-up across infrastructure, onboarding, Premiere integration, testing
  • WebSocket auth, SQLite migrations, analysis degradation banner
  • Configurable marker density, IPC channel constants, edge-case test coverage
  • Timecode-based Selects ordering, proxy file detection
v0.7.1 Apr 8, 2026
  • 25-expert cross-perspective audit, 48 findings fixed across 6 sprints
  • Fix white screen on startup, derush pipeline crash, silence detection FFmpeg logic
  • Session token for WebSocket bridge authentication
  • Configurable confidence thresholds and sequence gap, CSXS 12.0 manifest
  • Localized ErrorBoundary, AlertBox component, keyboard hint fixes
  • 159 i18n keys (FR/EN parity), structured logger migration
v0.7.0 Apr 7, 2026
  • 102-finding deep audit, 6 implementation sprints
  • Undo groups for all batch Premiere operations
  • Command queuing prevents Premiere UI freeze
  • Parallel AI classification with retry on rate limits
  • Per-clip re-analysis, subset selection, time estimation
  • Sequence presets matching source fps/resolution
  • Subclip handles, sequence gaps, clip metadata writing
  • Structured file logging, orphan process detection
  • UI component library, Zustand store slices, WCAG contrast fix
  • Keyboard shortcuts: R/X/Enter/Arrows for review
  • 138 TypeScript + 32 Python tests
v0.6.0 Apr 7, 2026
  • 58 audit findings fixed across security, reliability, UX
  • Toast system, batch review, transcript search
  • CEP panel i18n, Python test suite
v0.5.0 Apr 7, 2026
  • Tier 3 product features: toast, batch review, search
  • CEP panel log rotation, setLanguage command
v0.4.0 Apr 7, 2026
  • Tier 0/1/2 audit fixes: FPS division by zero, scene detection safety, silence returncode
  • Heartbeat timeout recovery, whisper model whitelist, HF_TOKEN validation
  • ARIA role="alert" on error banners, role="dialog" aria-modal on confirmation modal
  • Sanitized filesystem paths in user-visible errors, replaced silent catches with banners
v0.3.0 Apr 7, 2026
  • Transcription, diarization, scene detection confidence now computed from real values
  • CEP panel JSON handling + command escaping; DB connection pooling with cleanup
  • Crash recovery: skip fully-analyzed clips on resume
  • Confirmation dialog before Send to Premiere, silence detection settings in UI
  • 128 i18n keys (FR/EN parity), 108 tests passing
v0.2.0 Apr 7, 2026
  • End-to-end derush pipeline with 6 analysis stages
  • Content-hash caching, parallel processing, AI classification
  • Premiere output: bins, markers, subclips, Selects sequence
v0.1.0 Apr 7, 2026
  • Foundation: Electron + React 19 + TypeScript + Tailwind
  • CEP panel with 10 ExtendScript functions
  • FastAPI analysis server with 5 endpoints
  • Project manager, media scanner, settings with encrypted API keys

Installation

Download the DMG and drag SmoothFlow to Applications
Double-click SmoothFlow in Applications to launch — the app is signed and notarized, so macOS opens it immediately with no extra steps
Open SmoothFlow, click “Install Extension”, then enter your Anthropic or OpenRouter API key in Settings > AI
Restart Premiere Pro, then open Window > Extensions > SmoothFlow

Requirements

macOS 12+ (Apple Silicon)
Adobe Premiere Pro 2023+