Skip to content

About

Lightweight, high-performance screen recorder and screenshot editor for Windows

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Β 
Β 

Latest commit

Β 

History

91 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

openclip

Fork of openclip by catalingrigoriev285 (licensed under Apache-2.0).

A lightweight, high-performance screen recording and screenshot application for Windows, written in Rust with an egui interface.

  • Monitor, window, and region capture: Record an entire display, a specific application window, or a custom cropped rectangular area.
  • Game recording (Windows 64-bit): Captures frames directly from DirectX 11, DirectX 12, or OpenGL swap-chain back buffers for minimal performance overhead in exclusive fullscreen, complete with an in-game FPS overlay (green when armed, red when recording).
  • System audio and microphone: Captures loopback desktop sound and input microphone audio with independent gain controls (up to 200%) and optional separate audio tracks.
  • Live preview: Real-time rendering of what is currently being recorded.
  • Crash-resilient container formats: Produces progressive fragmented MP4 (ISO BMFF fMP4) and AVI 2.0 (OpenDML) files playable everywhere. Recordings survive power loss, BSODs, and game crashes without file corruption.
  • Hardware GPU encoding & overlay compositing: Windows Media Foundation hardware encoders (AMD AMF verified; NVIDIA NVENC and Intel Quick Sync supported in code), zero-readback Direct3D 11 video processor, and HLSL GPU overlay compositing for mouse effects and watermarks.
  • No external runtime dependencies: No ffmpeg, no external DLLs, and no codec packs required. Bundled H.264 (OpenH264) and MP3 (LAME) encoders are built into the binary.

What's Different in This Fork

Added

  • Interactive Screenshot Editor (Ctrl+Alt+Q): Instant freeze-frame screen capture overlay with interactive vector annotations β€” rectangle, arrow, straight line, freehand pen, highlighter/marker, text labels, and pixelate blur. Supports selection move/resize, Undo (Ctrl+Z), direct save to PNG, and instant copy to clipboard.
  • Global Recording Hotkey (Ctrl+Alt+R) with Sound Feedback: Toggle recording from anywhere with audio cue beeps that are isolated from the recorded audio stream. Configurable feedback modes: Off, Hotkey only, or Always.
  • Zero-Readback GPU Color Conversion: Dedicated Direct3D 11 Video Processor (ID3D11VideoProcessor) converting capture textures from BGRA to NV12 entirely within GPU VRAM, feeding Media Foundation hardware encoders (AMD AMF verified) with under 2% CPU utilization.
  • Hardware GPU Overlay Compositing (Direct3D 11 HLSL): Cursor halo highlight, animated click ripple rings, cursor pointer, and watermark overlays are composited directly in GPU VRAM via Direct3D 11 shaders with analytical SDF antialiasing. Overlays no longer drop the video pipeline into CPU memory.
  • Crash-Resistant Fragmented MP4 (ISO BMFF fMP4): MP4 files are written as sequential fragments (moof + mdat) with regular disk flushes. In the event of a sudden power outage, BSOD, or game crash, all recorded video up to the last second is completely preserved and playable.
  • Dynamic Custom Text Watermark: Customizable watermark badge rasterized dynamically using the bundled Inter font with full Cyrillic and Latin character support, auto-scaling width, and instant live preview.
  • Audio Hot-Plug & Stream Recovery: Windows Core Audio observer (IMMNotificationClient) automatically re-establishes loopback and microphone streams on device disconnect/reconnect or default endpoint switch without drifting from the video timeline.
  • Color Conversion Mode Setting: User-selectable color conversion pipeline: Auto (prefers GPU Video Processor, falls back to CPU), GPU (enforces hardware pipeline), or CPU (SIMD YUV fallback).
  • Adaptive Frame Clock ("Auto" FPS): Dynamically aligns frame pacing to display refresh rate (vsync grid) and suppresses redundant encoding during static desktop scenes to save disk space and power.
  • Audio Device & Track Enhancements: Select specific playback loopback and microphone input devices, adjust gain up to 200%, or record system audio and microphone into separate audio tracks.
  • Hardware GPU Decoding in Built-in Player: Video playback acceleration with Direct3D 11 NV12-to-RGBA hardware color conversion.
  • Ukrainian Language Localization: Complete Ukrainian (uk) UI translation alongside supplemented English, Romanian, and Russian localizations.
  • Diagnostic Logging & Automated Tests: Comprehensive logging to openclip.log and a suite of 185 integration tests covering container muxers, audio synchronization, and hotkey sequencing.

Improved

  • High-Fidelity Audio Resampling: Upgraded to a 16-tap Kaiser-windowed sinc resampler (KaiserSincResampler, $\beta=6.0$), eliminating aliasing distortion between 44.1 kHz and 48 kHz sample rates.
  • Higher Bitrate Limits: Constant Bitrate (CBR) settings up to 100,000 kbps (100 Mbps) for pristine high-motion recording.
  • Expanded Framerate Presets: Presets up to 144 FPS for high-refresh-rate gaming monitors.

Removed

  • Network & Auto-Update Code: Removed GitHub update checker, automatic background downloader, and online sidecar repair routines. OpenClip contains 0 network calls and operates entirely offline.

Unchanged

  • Core capture backends for Monitor, Window, Region, and Game (64-bit).
  • Standard output containers: MP4 and AVI 2.0.

Screenshots

Main Dashboard Video Settings
Main Dashboard
Source selection, input toggles, and live preview
Video Settings
Encoders, resolution, framerate, and GPU color conversion
Image & Screenshot Settings About OpenClip
Image Settings
Screenshot editor preferences and file naming
About OpenClip
Hardware detection, version info, and license details

Building

OpenClip is built specifically for Windows (Windows 10 version 1903+ or Windows 11).

Requirements

  • Rust: Toolchain 1.85+ (Rust 2024 edition).
  • C/C++ Build Tools: Visual Studio Build Tools with C++ workload (MSVC cl.exe and link.exe).
  • NASM (optional): Install NASM in your PATH to compile OpenH264 with optimized SIMD assembly kernels.

Compile

cargo build --release
.\target\release\openclip.exe

The game capture hook DLL (openclip_hook64.dll) is built in the same workspace:

cargo build --release --workspace

Usage

  1. Select Source: Choose Monitor (full screen), Window (individual app), Region (drag a rectangle on screen), or Game (direct hook into 64-bit DirectX 11/12 or OpenGL titles).
  2. Configure Audio: Toggle desktop sound (loopback) and microphone. Select specific audio devices or boost gain in the audio settings dialog.
  3. Record:
    • Click the Record button in the UI, or press Ctrl+Alt+R from any application.
    • Distinct audio beeps confirm start and stop.
    • When finished, press Ctrl+Alt+R again or click Stop.
  4. Take Screenshots:
    • Click the camera icon or press Ctrl+Alt+Q to freeze the screen.
    • Drag to select an area, apply vector annotations (arrows, text, blur), and press Enter (or click Save/Copy).
  5. Manage Recordings: View recorded videos in the built-in library, inspect diagnostics, or play back clips directly with GPU acceleration.

Format Settings

Parameter Options Description
Container MP4 (fMP4), AVI MP4 writes progressive ISO BMFF fragments (fMP4) resilient against crashes; AVI 2.0 (OpenDML) is index-backed.
Video Encoder Hardware (MF), OpenH264 Hardware uses GPU MFT (AMD AMF, NVENC, Quick Sync); OpenH264 runs on CPU.
Color Conversion Auto, GPU, CPU Auto prefers Direct3D 11 Video Processor; GPU enforces VRAM conversion; CPU uses SIMD YUV.
Audio Encoder AAC (MF), MP3 (LAME), PCM Media Foundation AAC or bundled LAME MP3 for compressed audio; uncompressed 16-bit PCM for AVI.
Bitrate 1,000 to 100,000 kbps Constant bitrate (CBR) targeting from lightweight clips to high-bitrate archival.
Framerate Auto, 24, 30, 60, 120, 144 Auto synchronizes with display refresh rate and suppresses duplicate idle frames.

Mouse Effects & Overlays

  • Cursor Highlight & Click Rings: Highlight cursor position and visualize left/right mouse clicks with smooth analytical SDF antialiasing.
  • Custom Text Watermark: Stamp customizable text or channel nicknames onto video frames with adaptive width, Cyrillic/Latin Inter font, and live preview.
  • GPU Compositing: All mouse effects and watermarks are composited directly on the GPU in Direct3D 11 HLSL shaders, preserving the zero-readback hardware path without CPU memory transfers.

How It Works

[Windows.Graphics.Capture]
          β”‚
     (GPU Texture)
          β”‚
          β”œβ”€β”€β–Ά [GPU Path] ──▢ GpuOverlayCompositor (HLSL) ──▢ ID3D11VideoProcessor (BGRA βž” NV12) ──▢ MF Hardware MFT (AMF/NVENC/QSV) ──┐
          β”‚                                                                                                                             β”‚
          └──▢ [CPU Path] ──▢ Staging Copy ──▢ SIMD YUV Convert ──▢ OpenH264 Software Encoder ───────────────────────────────────────────
                                                                                                                                        β–Ό
[Audio WASAPI Loopback / Mic] ──▢ Kaiser Sinc Resampler ──▢ Audio Mixer ──▢ Media Foundation AAC / LAME MP3 ──▢ Progressive fMP4 / AVI Muxer ──▢ File
  • Capture (src/capture): Windows Graphics Capture (WGC) provides hardware-accelerated desktop textures. In the GPU path, textures stay in VRAM. In the CPU fallback path, frames are read back through double-buffered staging textures without runtime memory allocations.
  • GPU Overlay Compositing & Color Conversion (src/video/d3d11_vp.rs): Uses Direct3D 11 HLSL shaders for analytical SDF overlays and Direct3D 11 Video Processor interfaces to execute hardware color conversion (DXGI_FORMAT_B8G8R8A8_UNORM $\rightarrow$ DXGI_FORMAT_NV12) directly on the GPU.
  • Video Encoders (src/video): Media Foundation Transform (MFT) interfaces stream NV12 buffers into hardware ASICs (tested on AMD AMF) or bundled CPU OpenH264.
  • Audio Engine (src/audio): WASAPI loopback and microphone streams are aligned to the recording timeline with automatic hot-reconnection via IMMNotificationClient. Sample rate conversion uses a 16-tap Kaiser sinc filter ($\beta=6.0$) to avoid aliasing artifacts.
  • Muxers (src/mux): Native progressive fragmented MP4 writer (ISO BMFF fMP4 with moof + mdat fragments and mfra index) and OpenDML AVI writer (RIFF/AVIX chunks with super-indexing).
  • Snipping Tool (src/ui/snipping.rs): Captures a pristine desktop freeze-frame, paints non-destructive vector overlays, and allows instant clipping.

Limitations

  • Windows Only: Designed specifically for the Windows graphics and audio subsystem (Direct3D 11, DXGI, Media Foundation, WASAPI).
  • Hardware Compatibility: GPU video processing and AMF encoding are verified on AMD Radeon RX 6600. NVIDIA NVENC and Intel Quick Sync pipelines are implemented via standard Media Foundation transforms but have not been physically verified on those hardware architectures.
  • Game Capture: Hooking is supported for 64-bit DirectX 11, DirectX 12, and OpenGL applications. It does not bypass aggressive third-party anti-cheat systems (e.g., Easy Anti-Cheat, BattlEye, Riot Vanguard).
  • Unsigned Executable: The binary is not signed with an expensive EV code signing certificate; Windows SmartScreen may show an unknown publisher warning upon first launch.

Privacy

  • Zero Network Traffic: OpenClip contains no telemetry, analytics, cloud synchronization, or external HTTP requests.
  • Zero Keystroke Logging: The low-level keyboard hook listens exclusively for configured global hotkeys (Ctrl+Alt+R and Ctrl+Alt+Q). No other keys or user input are ever inspected, logged, or recorded.

Updates

Update checks and auto-installation were removed from this fork. Updates come exclusively via manual releases on GitHub: πŸ‘‰ OpenClip GitHub Releases


Licensing Notes

OpenClip is released under the Apache License, Version 2.0 (see LICENSE).

Third-party bundled libraries and assets:

  • OpenH264: Cisco Systems, BSD 2-Clause License.
  • LAME: The LAME Project, LGPL.
  • Inter Font: Rasmus Andersson, SIL Open Font License 1.1.
  • Font Awesome Free: Fonticons, Inc., SIL OFL 1.1 font and CC BY 4.0 icons.
  • See NOTICE for complete third-party notices and licenses.

Credits

Based on the original openclip created by Catalin Grigoriev.

About

Lightweight, high-performance screen recorder and screenshot editor for Windows

Topics

Resources

Stars

1 star

Watchers

1 watching

Forks

Releases

Contributors

Languages