Skip to content

About

Fast native video and audio editor. Simple clips, layered timelines, and Windows + Linux releases.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

Halo Clipper

A native Rust video and audio editor for Windows and Linux. Grab a quick highlight in Simple Clip, or build a layered edit in Advanced.

Download the latest release · Report an issue

Install

Windows 10 / 11, 64-bit: Download Halo-Clipper-Setup.exe. It installs for your user account without administrator access and includes FFmpeg, FFprobe, libmpv, and caption fonts. The portable ZIP contains windows/halo-clipper.exe and its runtime files; keep those files together.

HaloOS / Arch Linux: Use the HaloOS package, or build and run ./install.sh. The Linux release binary targets Ubuntu 24.04 or newer and current HaloOS / Arch, and requires libmpv.so.2 (mpv 0.35+), FFmpeg, and mpv from the package manager. Ubuntu 24.04 / current Debian: sudo apt install ffmpeg libmpv2 mpv. Older distributions with only libmpv1 are unsupported by the current mpv bindings. Linux updates check native-library compatibility before replacing the working app.

Edit

Simple Clip: Import videos, click a media thumbnail to focus the video you are clipping, mark In and Out, and export. Each video remembers its own marks, playhead, mute, and undo/redo history. Switching tabs preserves the separate Advanced timeline. Auto mode copies keyframe-aligned clips when possible and re-encodes when needed.

Advanced:

  • Import adds video and audio to the media bin. Nothing is placed on the timeline automatically. Drag a media item to the time and lane you want; a preview opens a separate lane and moves existing rows aside before you drop. Hover above/below a row to choose the layer order. The first drop into an empty timeline holds at 0:00; move sideways after entering to choose another time. Hold Shift to bypass snapping.
  • Drag clips horizontally to change timing or vertically to another lane. Drag a track name up or down to change its layer order. Video at the top appears in front; audio lanes mix together.
  • Click a video on the preview to select it. Drag the video to move it, and drag its corner handles to resize it while keeping its aspect ratio. Videos can extend outside the canvas. Scroll over a focused video to zoom around the pointer. Reset frame (or the video context menu) centers and fills the canvas; Ctrl+Z reverses it. The selection outline fades while idle without deselecting. Transform edits update immediately on the GPU.
  • The canvas automatically follows the largest-resolution video placed on the timeline. Importing alone does not change it. Choose Original, 16:9, 9:16 (Reels / TikTok), 1:1, or 4:5 above the preview. These formats retain native source detail without a resolution picker. Fit shows the whole video; Fill crops to the canvas. Zoom, placement, and black / color / blurred video backgrounds carry through to export. Custom export can still override size.
  • Hover a media item and click × to remove it and its timeline instances. Removing the last item leaves a blank editor. Import again whenever you want.
  • Video and its audio start as one combined bar. Detach Audio (D) exposes the audio. Attach Audio (Shift+D) collapses it again, preserving source trims, cuts, gaps, offsets, speed, gain, and deleted pieces. Attachment changes grouping, never the rendered result. Detached splits remember their association. Ctrl+click multiple video/audio pieces to attach them as one compound bar.
  • Split with S, delete with Delete, and undo / redo with Ctrl+Z / Ctrl+Shift+Z. Attached pieces edit together; detached pieces edit independently.
  • Drop one or several clips from Windows Explorer or a Linux file manager into Media to import. The bin highlights while dragging; existing edits and the active Simple Clip source stay in place. Each imported clip gets a subtle number in import order, also shown on the timeline.
  • Click a clip to show framing, audio, speed, opacity, and Animation. Choose an In/Out effect per segment: Fade, Snap zoom, Pull back, Whip, or Flash. Adjust each time and the Amount, then use the play icon to try it. Right-click a clip for edit actions, or a track name to mute / hide that track. The Edit panel scrolls within its available height.
  • Press T or click Add text for a text layer. Type in its inspector, drag it anywhere on the canvas (including the black bars in TikTok format), and resize from a corner or with the wheel. Choose a font, style, color, and optional intro/outro with separate time sliders (shorter is faster). Expand Color mix for custom text, outline, and box colors, two-color gradients, quick palettes, and direction. Use the timeline transport to preview. Drag or trim its timeline bar to set timing; S splits the selected text and Delete removes it. Right-click its bar to duplicate it.
  • Each active video and audio lane uses an independent live decoder. Timeline playback, scrubbing and transform edits do not rebuild a rendered timeline. Exports always read the original media through the shared composition model.

Advanced automatically sizes the timeline for its visible layers and reserves an extra lane while dragging media. Its upper divider remains resizable. Taller clip bars include thumbnails, and shortcuts stay visible below the timeline. The Background menu stays open while choosing a color; click outside it or press Escape to close it. Simple Clip retains its focused mark-and-export workflow. Sessions are currently in memory: export your edit before closing or updating.

Export

Auto preserves source quality. Discord targets an upload size and chooses resolution / codec accordingly. Custom exposes resolution, frame rate, codec, quality or bitrate, and audio settings. Available hardware encoders are detected at startup. Preview layers composite on the GPU; export composition runs through FFmpeg, with a GPU upload when the selected encoder requires it. Proxy media never replaces export originals.

Shortcuts

Key Action
Space Play / pause
I / O Set In / Out in Simple Clip
S Cycle Simple Clip marks; split selected / intersecting Advanced clips
Delete Delete selected Advanced segments and linked partners
D / Shift+D Detach / attach audio, preserving edits
Ctrl+Z / Ctrl+Shift+Z Undo / redo
Ctrl+click Add / remove a segment from selection

Command line: halo-clipper video.mp4, or halo-clipper video.mp4 --advanced --layer overlay.mp4 --layer music.wav. The Advanced command imports those files into the bin without placing them.

Updates and support

Open Help / Updates. Startup checks query the project's public GitHub release feed and can be disabled there. Updates require an explicit download and install click. The app verifies an Ed25519-signed manifest, SHA-256 checksum, and file size before installation. Windows installs into the current application directory; user-local Linux binaries can replace themselves, retaining a .previous backup. System-managed Linux installs should update through their package manager.

Logs stay on the user's device: two files, at most about 2 MiB each, under %LOCALAPPDATA%\Halo Clipper\logs on Windows or ${XDG_STATE_HOME:-~/.local/state}/halo-clipper/logs on Linux. They include startup, encoder checks, export results, preview / update errors, and Rust panics. Known media paths and filenames are redacted. The app does not upload logs or media automatically. Export support report… creates a text report for the user to review and attach to a public GitHub issue. Review it before sharing; third-party error messages can include user-provided text.

Develop

Linux build dependencies include Rust, FFmpeg, libmpv development files, OpenGL, Wayland, and xkbcommon. On Ubuntu:

sudo apt install build-essential pkg-config libmpv-dev libwayland-dev \
  libxkbcommon-dev libegl1-mesa-dev libgl-dev ffmpeg fonts-dejavu-core
cargo build --release --locked
cargo test --release --locked
cargo fmt --check
cargo clippy --all-targets -- -D warnings

Tests exercise model editing, captions, encoders, signed metadata, redaction, real exports, layer ordering / opacity, and independently placed audio. VAAPI end-to-end coverage runs when compatible hardware is present.

See release and Windows build instructions for publishing updates, native Windows builds, signing, and dependency refreshes.

License

Halo Clipper source: MIT. Bundled runtimes and fonts retain their own licenses; see third-party notices and the package's licenses/ folder.

About

Fast native video and audio editor. Simple clips, layered timelines, and Windows + Linux releases.

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages