VideoHighlighter README

The project's README from github.com/Aseiel/VideoHighlighter. As one markdown file: README.md.

VideoHighlighter

Discord

VideoHighlighter

English | 中文 | 日本語 | Español

Find and explain the moments that matter in footage you won't upload — then export a cut, on your machine.

A local desktop app. Drop in raw video; it scores strong moments from scene, motion, audio, objects, actions and the transcript, shows you why each one scored on a signal timeline and in a report, then exports a highlight reel and the individual clips. Nothing is uploaded for analysis, and the basic pipeline needs no API key.

Free and open source (AGPL-3.0). Windows, macOS, Linux. Intel, AMD and NVIDIA GPUs.

It's free. To make sure you see new releases in future, please click the motivation button: the ⭐ at the top of the page. It's the cheapest payment we accept.

What people use it for

Not sure which detector fits your footage? docs/DETECTION-GUIDE.md covers what each one is good at and where it falls down.

What makes it different

Every run explains itself. The report is the arithmetic behind each kept moment — the per-signal point breakdown, what fired, what scored well and still missed the cut. It names the claims that came from the transcript and were never measured, instead of scoring them anyway. Open a real one →

Composition rules. You say what a combination of detections means for your footage — one class inside another, counted, held over a window — and that becomes an event under a name you choose. Because a rule re-reads detections that already exist, editing one and re-running costs milliseconds.

Preview

VideoHighlighter

Timeline Viewer

Timeline Viewer

Demo

https://github.com/user-attachments/assets/5c85af94-9228-4537-926a-1ed7a91fa5ee

Install

Grab a build from Releases:

Portable builds, GPU setup, where it writes, and fixing an oversized UI: docs/INSTALL.md.

Documentation

Choosing a detector Objects, actions, CLIP search, composition rules — what each is for
Why these moments What the report contains and why it is built that way
The Auto pipeline Card → ingest → script → music → reel, resumable
Installing Every platform, GPU backends, settings
Training a model Label your own class and train it
Community models Install models other people trained, publish your own
Intel GPU · AMD GPU Vendor-specific acceleration
Remote ollama Run the local LLM on another box on your LAN

Pro edition

VideoHighlighter — this repository — is free software under AGPL-3.0, and stays that way. It includes offline analysis, live face detection, VR side-by-side playback, CLIP search, the composition engine, model training and the model hub.

VideoHighlighter Pro is a separate paid edition that adds real-time work on top: live object and action overlays during playback, teaching a category by drawing a box around it, find-more-like-this search, open-vocabulary detection and counter/scoreboard detection.

Explanation is not among them. The report, the findings and the advisor are identical in both editions — a cloud tool gives you a button and a result you cannot interrogate; answering "why", locally, is what this is instead.

Community

VideoHighlighter occasionally has feelings about your footage. When it does: join the Discord and yell in #support, I'm usually around. Bugs and ideas are welcome in Issues.

License

Copyright (C) 2026 Przemysław Kreft and Meric Donmezer.

Released under the GNU Affero General Public License v3.0 — use, modify and distribute it freely, provided modified versions, including ones offered over a network, make their complete source available under the same license. Full text in LICENSE; notice in COPYRIGHT.

Contributors keep copyright in their own work — see CONTRIBUTING.md and CLA.md. VideoHighlighter is also offered under a separate commercial license by the copyright holders.

Background

This started as a personal tool to generate subtitles for videos, for my 7-year-old son. Over time it turned into a highlights generator for movies, sports and personal footage. The goal is unchanged: speed up video analysis, generate highlights you can explain, and create subtitles automatically — without uploading footage you would rather keep local.

Stars History

VideoHighlighter (Aseiel/VideoHighlighter)

Searching Database…

What is this?A free, open-source desktop app that finds and explains the strong moments in your footage, then exports a highlight reel and clips — an offline alternative to Twelve Labs, Runway and Descript.
Is this a desktop app or a cloud service?A local desktop app for Windows, macOS and Linux: you drop raw video in, and detection, scoring and export all run on your own machine.
How do I install it on Windows, macOS or Linux?From Releases: run 00-VideoHighlighter-Windows-Setup.exe on Windows (per-user, no admin) or drag the .dmg into Applications on macOS; from source: pip install -r requirements.txt && python main.py. FFmpeg comes with it.
The Windows installer triggers a SmartScreen warning — is that expected?Yes — the build is not code-signed yet, so you click through More info → Run anyway. On macOS you also clear the quarantine flag once with xattr -dr com.apple.quarantine /Applications/VideoHighlighter.app.
Does my footage get uploaded anywhere when it analyzes a video?No — analysis, detection and the local Whisper transcription run entirely offline, and the basic pipeline needs no API key. You can even keep the Ollama LLM on another box on your LAN.
What does the AGPL-3.0 license mean if I modify or host it?You can use, modify and distribute it freely, but modified versions — including ones offered over a network — must make their complete source available under the same license. A separate commercial license is also offered.
Does it need an NVIDIA GPU, or do AMD and Intel cards work too?Any of the three — it runs on Windows, macOS and Linux with Intel, AMD and NVIDIA GPUs, with vendor-specific acceleration guides plus CUDA and OpenVINO backends.
Is anything locked behind the paid Pro edition?No. The free edition already includes offline analysis, live face detection, VR side-by-side playback, CLIP search, the composition engine, model training and the community model hub. Pro is a separate paid edition adding only real-time work: live overlays during playback, teaching a category by drawing a box, find-more-like-this search, open-vocabulary and counter/scoreboard detection — and the explainable report is identical in both.
Why did the author build this?It started as a personal tool to generate subtitles for videos for the author's 7-year-old son, then grew into a highlights generator for movies, sports and personal footage. The goal stayed: fast, explainable video analysis and automatic subtitles without uploading footage you would rather keep local.
Which models does it run under the hood?Scene, motion, audio, object and action detectors, CLIP-based visual search and a local Whisper transcript; the vision LLM runs through Ollama (LLaVA, with CUDA and OpenVINO backends listed in the repo topics). docs/DETECTION-GUIDE.md covers what each detector is good at and where it falls down.
Creator
Aseiel
Size
238.5 MB
Stars
212
Age
1y
Commits · 90 Days