How marginal/qlvideo works
QLVideo is a macOS media compatibility product: it adds Finder thumbnails, Quick Look previews, Finder metadata, and AVFoundation support for media formats and codecs macOS does not natively handle. The user-facing workflow begins in Finder or Quick Look; Spotlight metadata import and Media Extensions are distinct product paths. The repository also contains format-reading, decoding, and contact-sheet components. Source excerpts establish only a few internal calls and imports, so uncertain runtime wiring is omitted rather than inferred.
Main entry points: formatreader.swift Format Reader · AppDelegate.swift App and Extension UI · GetMetadataForFile.swift Metadata Importer · videodecoder.swift Video Decoder
Components 19
App and Preview
- App and Extension UI
app/AppDelegate.swift - Crash Report View
app/CrashReportView.swift - Cover Art View
app/CoverArtView.swift - Issue View
app/IssueView.swift - Extension Status
app/MediaExtensionsView.swift
Spotlight Metadata
- Metadata Importer
mdimporter/GetMetadataForFile.swift - Codec Naming
mdimporter/CodecName.swift
Media Reading
- Format Reader
formatreader/formatreader.swift - Reader Factory
formatreader/formatreaderfactory.swift - Packet Demuxer
formatreader/packetdemuxer.swift - Audio Track Reader
formatreader/audiotrackreader.swift - Video Track Reader
formatreader/videotrackreader.swift
Video Decoding
- Video Decoder Factory
videodecoder/videodecoderfactory.swift - Video Decoder
videodecoder/videodecoder.swift - HDR Plane Helpers
videodecoder/hdr_interleave.c
Contact Sheet
- Contact Sheet App
contactsheet/AppDelegate.swift - FFmpeg Callbacks
contactsheet/callbacks.h
Other components
- Finder
- Quick Look
Connections 12
- Finder → Metadata Importer: requests metadata
- Finder → App and Extension UI: requests thumbnails
- Quick Look → App and Extension UI: requests previews
- App and Extension UI → Crash Report View: uses view
app/AppDelegate.swift - Metadata Importer → Codec Naming: gets codec names
mdimporter/GetMetadataForFile.swift - Format Reader → Reader Factory
- Format Reader → Packet Demuxer
- Format Reader → Audio Track Reader
- Format Reader → Video Track Reader
- Video Decoder Factory → Video Decoder
- Video Decoder → HDR Plane Helpers
- Contact Sheet App → FFmpeg Callbacks