Aegis Video Organizer Technical Documentation

Aegis Video Organizer (formerly Vorger) is a professional video organization tool focused on scene-based discovery and AI-powered analysis.

Architecture

The application is built using a modular architecture for high performance and reliability.

1. Discovery

Identifies video files using recursive directory traversal. Implements smart deduplication using a "fast hash" algorithm (first 1MB, last 1MB, and file size) to track files without re-processing.

2. Thumbnailing

Generates high-quality scene previews using ffmpeg. Features parallel processing via multi-core extraction for speed.

3. AI Extraction

Leverages LLMs (like granite3.2-vision:2b) to analyze scenes. Identifies objects, actions, and actors while providing comprehensive video summaries.

Data Schema

Relational SQLite storage ensures fast queries and data integrity.

Table Description
videos Core metadata, duration, dimensions, and deduplication hashes.
duplicates Links file copies to original records.
extracted_scenes Per-scene AI descriptions, tags, and visual objects.

Aesthetics

Features a premium dark-mode interface designed for long-duration media management.