v1.6.0: 38 Real-Time Viewport Transitions, Multi-Mode Waveforms & Stacking Isolation 🌊✨

Changelog

All notable changes to the Vidonex project will be documented in this file.

The format is based on Keep a Changelog,
and this project adheres to Semantic Versioning.

---

[1.6.0] - 2026-09-16

38 Real-Time Viewport Transitions, Advanced Multi-Mode Audio Waveforms, Color Adjustment Filters & Multi-Track Stacking Isolation 🌊✨

Vidonex v1.6.0 introduces real-time viewport simulation for all 38 video transitions, an overhaul of the animated audio waveform engine with interactive on-canvas positioning and multiple rendering modes, expanded color adjustment filters (Gaussian Blur, Edge Sharpening, Highlights/Shadows/Whites/Blacks tonal controls), multi-track audio autoplay unlocking with drift smoothing, a rock-solid track stacking isolation architecture, and a comprehensive update management and system diagnostics suite including one-click in-app self-updates, an About Vidonex Studio modal, and CLI commands vidonex about and vidonex upgrade.

Added

🔄 One-Click In-App Automatic Updates & System Diagnostics (server/api/updater.go, server/api/version.go, ui/)

• One-Click In-App Self-Update:
  • POST /api/version/upgrade endpoint with live Server-Sent Events (SSE) progress streaming.
  • Automatic host OS and CPU architecture matching against official GitHub release assets.
  • Safe, atomic in-place binary replacement with temporary backup and automatic rollback on failure.
  • User confirmation prompt before download, real-time download and extraction percentage indicators, and one-click "Reload Studio" action upon completion.
• About Vidonex Studio Modal & Top Notification Banner (ui/components/panels/AboutModal.vue, useAppUpdate.ts):
  • Displays host operating system, architecture, CPU core count, active GPU hardware acceleration (NVENC, VideoToolbox, VA-API, QSV), and detected FFmpeg/FFprobe binaries.
  • Live release checking with a 10-minute caching layer and client-side fallback.
  • Non-blocking top notification banner and pulsating header indicator dot when a new version is released.
  • Complete dual-language localization (Persian fa.json and English en.json) for all updater states and technical diagnostics.
• CLI Commands (cmd/vidonex/about.go, cmd/vidonex/update.go):
  • vidonex about: Formatted terminal overview of hardware capabilities, engine versions, and update status.
  • vidonex upgrade: Native self-updater supporting --check and --force flags, sharing the core api.ExecuteSelfUpdate engine.
  • Redesigned CLI and installer ASCII banner matching the official Vidonex block shadowed logo with TrueColor purple, indigo, and sky blue gradients.

🎬 38 Real-Time Video Transitions (ui/composables/useTransitionPreview.ts, compiler/)

• Full Viewport Preview Coverage:
  • Implemented real-time CSS clip-path and WebGL/transform simulations for all 38 FFmpeg xfade transition types (Dissolve, Fade, Wipe Left/Right/Up/Down, Slide Left/Right/Up/Down, Smooth Left/Right/Up/Down, Circle Open/Close, Rect Crop, Radial, Pixelize, Zoom In, Squeeze Horizontal/Vertical, Wipe Top-Left/Top-Right/Bottom-Left/Bottom-Right, Fade Black/White, and more).
  • Centered cut boundary interpolation window [cutTime - duration/2, cutTime + duration/2] matching exact FFmpeg xfade timeline alignment.
  • Symmetrical transition durations and curves with seamless visual parity between live canvas playback and final exported MP4 renders.

🎙️ Advanced Customizable Audio Waveforms (waveform/, ui/components/viewport/ViewportWaveformVisualizer.vue, spec/)

• Multi-Mode Waveform Generation:
  • Implemented multiple visual modes: Peak-to-Peak (p2p), Line (line), Centered Line (cline), Dot (dot), Rounded Bars (bars), Frequency Spectrum (spectrum), Classic Wave (wave), and Circular/Radial (circular).
  • Direct canvas manipulation: drag to reposition, resize with bounding box handles, and live preview of animated audiograms.
  • Configurable parameters: bar density, roundness, line width, outer/inner radius, primary and secondary neon colors, glow radius, and opacity.
  • Declarative YAML/JSON specification support via waveform track properties, fully integrated with CLI batch rendering.

🎨 Color & Tone Adjustment Filters (effects/color.go, compiler/planner.go, spec/model.go)

• Expanded Tone Controls:
  • Added Gaussian Blur (gblur) with configurable sigma radius.
  • Added Edge Sharpening (unsharp) with dynamic contrast thresholding.
  • Added Highlights, Shadows, Whites, and Blacks tone curve remapping.
  • Declarative specification fields in ClipSpec.color_grading supported across CLI, YAML/JSON, and Go SDK.

Fixed

🛡️ Track Stacking Hierarchy & Overlay Isolation During Transitions (ui/components/viewport/)

• Track-Isolated Z-Index Engine:
  • Isolated track layer index space with 100-integer slot allocations per track (BaseZIndex = (LayerIndex + 1) * 100).
  • Restricted transition zIndexExtra (+5) to intra-track scope, preventing transition animations on lower video tracks from ever bleeding over upper tracks (e.g. logos, PiP overlays, watermarks, and graphics).
  • Ensured interactive transform and crop gizmos (ViewportTransformGizmo, ViewportCropGizmo) and alignment guidelines maintain top-level priority (z-[9999]) above all media content.

🔊 Audio Playback & Synchronization Engine (ui/composables/useTimelineAudio.ts)

• Autoplay Unlocker & Drift Compensation:
  • Added automatic audio context unlocker on first user gesture.
  • Implemented progressive drift smoothing to prevent audio-video desynchronization during rapid scrubbing or timeline seeks.

---

[1.5.0] - 2026-09-15

Visual Studio Suite: Interactive Canvas Crop, Pro Color Grading, Categorized Transitions, Project Switcher & Deletion Protection 🎨🎬

Vidonex v1.5.0 delivers a major feature release focused on professional non-linear editing ergonomics: interactive canvas crop mode with an on-screen rule-of-thirds gizmo, comprehensive color and lighting adjustments in the inspector with live CSS simulation and FFmpeg compiler integration, a categorized transition selector with instant search covering 50+ transitions, an integrated project switcher and creator with aspect ratio presets, and a universal confirmation modal system protecting all destructive delete actions.

Added

✂️ Interactive Visual Crop Mode & FFmpeg Crop Compiler

• FFmpeg Crop Filter (effects/crop.go):
  • Implemented CropFilter with exact pixel dimensions (Width, Height, X, Y) or percentage insets (Top, Right, Bottom, Left).
  • Strict parameter validation ensuring positive, even output dimensions (required by H.264/HEVC codecs).
  • Table-driven unit tests in effects/crop_test.go (TestCropFilter_Table).
• Timeline & Spec Model Integration (timeline/clip.go, spec/model.go, spec/converter.go):
  • Added CropOptions struct and WithCrop() fluent builder to timeline.Clip.
  • Added crop specification fields (top, bottom, left, right) to ClipSpec and YAML/JSON deserializer.
  • Integrated CropFilter directly into compiler/planner.go (ProcessClipVideo) prior to scaling and geometry transformations.
• On-Screen Canvas Crop Gizmo (ui/components/viewport/CropGizmo.vue):
  • Interactive rule-of-thirds grid with 4 drag handles (Top, Bottom, Left, Right) and corner markers.
  • Real-time CSS clip-path: inset(...) preview during viewport playback.
  • Dedicated "Crop" toggle button in timeline toolbar next to Split and Duplicate tools.
  • Floating action pill showing live percentage readouts, Reset, and Done buttons.

🎛️ Pro Color & Light Adjustments & Centered Sliders (ui/components/panels/ColorAdjustmentInspector.vue)

• Centered-Zero Bipolar Sliders:
  • Re-architected all bipolar adjustment controls (Brightness, Contrast, Highlights, Shadows, Whites, Blacks, Saturation, Gamma, Temperature, Tint) with symmetric -100 to +100 ranges and visual center markers where neutral 0 is physically aligned at exactly 50% across all sliders.
  • Dynamic dual-direction fill bars radiating from the center mark (left for negative values, right for positive values) with double-click reset to neutral.
• Extended Adjustment Filters (effects/color.go, compiler/planner.go, timeline/clip.go, spec/):
  • Added Gaussian Blur (gblur filter) and Edge Sharpen (unsharp filter) controls (0 to 100).
  • Added Highlights, Shadows, Whites, and Blacks dynamic tone controls mapped to FFmpeg colorbalance and live canvas CSS simulation.

🌊 Modern Multi-Mode Audio Waveform Suite & On-Canvas Gizmo

• 5 High-Impact Visualizer Modes:
  • peak_to_peak: Mirrored vertical bars with capsule rounding and dual-color gradients.
  • spectrum: Bottom-aligned frequency spectrum with floating glowing peak caps.
  • wave: Smooth neon oscilloscope curve with glow blur and subtle area fill.
  • circular: Radial podcast audiogram with inner avatar hole and pulsing frequency rays.
  • dots: Modern matrix particle dots with dynamic beat scaling.
• On-Canvas Direct Manipulation Gizmo (ui/components/viewport/ViewportWaveformVisualizer.vue):
  • Click-to-select waveform directly on the preview stage.
  • 8-handle bounding box for intuitive real-time width and height resizing.
  • Interactive drag-to-reposition with magnetic smart guidelines snapping to center and margins.
• Advanced Inspector Controls (ui/components/panels/WaveformInspector.vue):
  • One-click style presets: Cyberpunk Neon, Podcast Minimal, Studio Retro, and Spotify Radial.
  • Dual-color gradient picker (Primary & Secondary colors).
  • Fine-tuning subpanels for bar density, corner roundness, neon glow radius, line width, and inner radius.
• **Go Engine & Backend Tests (`waveform/wavefo...

v1.5.0: Visual Crop Mode, Pro Color Grading, Categorized Transitions, Project Switcher & Deletion Protection

Visual Studio Suite: Interactive Canvas Crop, Pro Color Grading, Categorized Transitions, Project Switcher & Deletion Protection 🎨🎬

Vidonex v1.5.0 delivers a major feature release focused on professional non-linear editing ergonomics:

• Interactive Canvas Crop Mode & FFmpeg Crop Compiler:
  • CropFilter with exact pixel dimensions and percentage insets with even-pixel rounding for codec compatibility.
  • On-screen Crop Gizmo with rule-of-thirds grid, 4 edge handles, and real-time CSS clip-path playback.
  • Dedicated "Crop" toggle in timeline toolbar.
• Pro Color & Light Adjustments (ColorAdjustmentInspector.vue):
  • Sliders for Brightness, Contrast, Saturation, Gamma, Temperature, and Tint with neutral Reset.
  • Live CSS viewport simulation and direct compilation to FFmpeg colorbalance and eq filter nodes.
• Categorized Transitions & Instant Search:
  • 50+ XFade transitions organized into 6 pill tabs: All, Fades & Dissolve, Wipes, Slides & Pushes, Shapes & Iris, Zooms & Warps.
  • Real-time search query filter.
• Project Switcher & Project Manager:
  • Header dropdown with active project checkmark, quick project switching, and project deletion.
  • New Project modal with aspect ratio preset cards (16:9, 9:16, 1:1, 4K UHD, 21:9), custom dimensions, and frame rate picker.
• Universal Confirmation Dialog System:
  • Promise-based modal dialog protecting all destructive actions (Tracks, Clips, Media Assets, Projects).
• Full Localization & Translation Fixes:
  • Completely resolved raw translation keys in Command Palette (Ctrl+K), New Project modal, and Adjustments panel across English and Persian.

v1.4.0: Developer Standards, OpenAPI/Scalar Interactive Docs, Benchmarks & CI/CD Action

Developer Standards, OpenAPI/Scalar Interactive Docs, Benchmarks & CI/CD Action 🚀

Vidonex v1.4.0 establishes developer-first production infrastructure:

• OpenAPI 3.0 & Scalar Interactive Sandbox (/docs): Zero-dependency modern API reference and interactive testing sandbox served directly from the embedded Go server.
• Compiler & Sorting Performance Benchmarks (compiler/benchmark_test.go): Validated sub-millisecond timeline compilation (~70µs/op) and linear-time $O(V+E)$ topological graph sorting.
• Official Reusable GitHub Action (.github/actions/render/action.yml): Turnkey composite action for automated cloud video rendering in GitHub workflows.
• DevContainer (.devcontainer/devcontainer.json): Pre-configured Ubuntu 24.04 environment with Go 1.26, Node 24, pnpm, Wails, WebKit2GTK, and FFmpeg.

v1.3.0: Next-Gen Codecs & In-Browser WebAssembly Compiler

Next-Gen Codecs & In-Browser WebAssembly Compiler 🌐⚡

Vidonex v1.3.0 adds industry-standard delivery and mastering codecs alongside client-side timeline compilation:

• Next-Gen Production Codec Profiles (presets/codecs.go):
  • ProfileAV1: SVT-AV1 10-bit encoding with Opus audio.
  • ProfileProRes4444: Apple ProRes 4444 preserving alpha transparency (yuva444p10le).
  • ProfileProRes422HQ: High-bitrate broadcast mastering.
  • ProfileWebMVP9 and ProfileWebMAlpha: WebM VP9 open web profiles.
• Standalone In-Browser WebAssembly Compiler (cmd/wasm/main.go):
  • Compiles full Go DAG compiler to ui/public/vidonex.wasm (5.2 MB).
  • Exposes globalThis.vidonex with validate(), compile(), mermaid(), and version().
  • Typed Nuxt 4 composable in ui/composables/useWasmCompiler.ts.

v1.2.0: Broadcast Audio & Cinematic Color Grading

Broadcast Audio & Cinematic Color Grading 🔊🎨

Vidonex v1.2.0 introduces professional-grade broadcast audio normalization, cinematic look-up tables, and an expanded transitions library:

• EBU R128 Audio Loudness Normalization (effects/loudnorm.go): Turnkey presets for Spotify & YouTube (-14 LUFS), Broadcast TV (-23 LUFS), and Podcasts (-16 LUFS).
• 3D LUT (.cube) & Color Balance Filters (effects/color.go): Cinema-grade color grading with trilinear and tetrahedral interpolation.
• 50+ Cinematic XFade Transitions (timeline/transition.go, effects/transitions.go): Complete library of FFmpeg xfade transition types.
• Turnkey Social Media Templates (presets/templates.go): Declarative recipes for TikTok Split-Screen, Podcast Audiogram, and YouTube End-Screen.

v1.1.0: Studio Suite with Command Palette, Waveforms, VU Meter, Filmstrips & Curve Editor

Studio Ergonomics & UX Powerhouse 🎛️

Vidonex v1.1.0 transforms the Web Studio and Desktop Workstation into an ergonomic, modern NLE:

• Command Palette (Ctrl+K / Cmd+K): Quick fuzzy-search action palette with keyboard shortcuts.
• Real-Time Stereo VU & Peak Meter: Dual-channel RMS + True Peak metering (-60 dBFS to 0 dBFS) with peak-hold.
• Multi-Sample Audio Waveforms: Interactive SVG waveform visualizer overlaid directly on timeline audio clips.
• NLE Filmstrip Displays: Repeating thumbnail filmstrips for video clips.
• Cubic Bezier Easing Curve Visualizer: Interactive curve visualizer embedded in Keyframe Inspector for smooth animations.
• Bilingual Support: Comprehensive Persian and English localization.

v1.0.0

Full Changelog: https://github.com/farshidrezaei/vidonex/commits/v1.0.0