How 6v17/videoseek works
VideoSeek is a Windows-first desktop application for indexing local video libraries and finding scenes by text or image. The main workflow is to add and sync a library, generate visual embeddings, search indexed frames or chunks, then preview and export matching clips. Other documented capabilities include hard-subtitle OCR search, optional video understanding and recap, video downloading, and a localhost Agent API. Relationships reflect the README and supplied source index/excerpts; unsampled subsystems are shown where documented, without assuming their internal call paths.
Main entry points: search_controller.py Search controller · clip_embedding.py Visual embeddings · search_service.py Search service · search_chunk_pipeline.py Chunk search
Components 23
Desktop workflow
- Desktop UI
ui/windows/gui.py - Search controller
ui/controllers/search_controller.py - Index worker
ui/workers.py
Indexing and models
- Library service
src/services/library_service.py - Video update flow
src/workflows/update_video.py - Visual embeddings
src/core/clip_embedding.py - ONNX vision engine
src/core/onnx_vision_engine.py - Config and profiles
src/storage/config_store.py
Search and retrieval
- Search service
src/services/search_service.py - Chunk search
src/services/search_chunk_pipeline.py - In-video locate
src/services/search_locate_pipeline.py - Lance search index
src/storage/lance_search_index.py - Ranked hits
src/domain/search_hit.py
Media tools
- Preview player
ui/playback/preview_dialog.py - Clip export
src/services/clip_export_service.py
Optional capabilities
- Subtitle OCR
src/core/subtitle_ocr/ocr_pipeline.py - Subtitle indexing
src/services/subtitle_index_service.py - Video understanding
src/core/understanding/pipeline.py - Recap cuts
src/services/recap_service.py - Localhost Agent API
src/web/agent_api/service.py - Video download
src/services/video_download_service.py
Other components
- Local user
- Remote vision provider
Connections 25
- Local user → Desktop UI: uses
README.md - Desktop UI → Search controller: routes search
- Search controller → Search service: requests search
ui/controllers/search_controller.py - Local user → Index worker: syncs library
README.md - Index worker → Video update flow: runs update
ui/workers.py - Video update flow → Library service: updates library
- Library service → Visual embeddings: builds embeddings
- Visual embeddings → ONNX vision engine: uses engine
src/core/clip_embedding.py - Visual embeddings → Config and profiles: loads profile
src/core/clip_embedding.py - Search service → Chunk search: runs chunk search
src/services/search_chunk_pipeline.py - Chunk search → Lance search index: queries vectors
src/services/search_chunk_pipeline.py - Chunk search → Ranked hits: returns hits
src/services/search_chunk_pipeline.py - Search service → Lance search index: searches index
- Search controller → Ranked hits: receives results
ui/controllers/search_controller.py - Search controller → In-video locate: locates hit
- In-video locate → Lance search index: searches window
src/services/search_locate_pipeline.py - Local user → Preview player: previews hit
README.md - Preview player → Clip export: exports clip
- Local user → Subtitle OCR: extracts subtitles
README.md - Subtitle OCR → Subtitle indexing: indexes OCR text
- Local user → Video understanding: requests understanding
README.md - Video understanding → Remote vision provider: may call provider
README.md - Local user → Recap cuts: plans recap
README.md - Local user → Localhost Agent API: sends HTTP request
README.md - Local user → Video download: downloads video
README.md