# Marginal/QuickLookVideo

Finder Thumbnails, Quick Look previews, Get Info metadata and previews for most types of audio and video files.

Repository: https://github.com/Marginal/QuickLookVideo
Canonical: https://ross.abutalabs.com/products/quicklookvideo
Language: Swift
License: GPL-2.0
License Family: copyleft
Last push: 2026-08-25T17:26:45+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 96, longevity 100
- inputs: {"age_days": 4431, "days_push": 8, "days_rel": 25, "gap_med": 6.0, "n_releases_24m": 19}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 3545, forks 123 (observed 2026-08-28T04:08:09.409529+00:00)

## What it is
A macOS app that adds Finder thumbnails, Quick Look previews, and Get Info metadata support for a wide range of audio and video file formats not natively handled by macOS. It works via a Spotlight extension and Media Extensions that extend AVFoundation with support for additional codecs and containers.

## Use cases
- preview mkv and webm files in Quick Look on Mac
- show video thumbnails in Finder for avi and flv files
- get metadata for audio files like wma and ogg in Finder Get Info
- add HEVC and VP9 codec support to macOS Quick Look
- play and preview non-native media formats on macOS

## When to choose
- you need Finder previews or thumbnails for media formats macOS doesn't support natively
- you want a maintained, App Store-distributed replacement for Perian-style codec support

## When to avoid
- you only work with natively supported formats like MP4/H.264
- you need full playback of exotic codecs rather than previews and thumbnails

## Facets
- artifact type: application
- maturity: active
- function: video-processing, audio-processing, image-processing
- domain: media, apple-ecosystem, desktop-applications
- platform: -
- tags: quicklook, finder, spotlight, thumbnails, codecs, avfoundation, media-preview, macos

## Member repositories
- Marginal/QuickLookVideo (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:09.409529+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T18:34:24.692554+00:00, confidence not recorded.
  - readme: https://github.com/Marginal/QuickLookVideo (fetched 2026-08-28T04:08:09.409529+00:00, sha 9b64d6dee1ac)
- Data as of 2026-08-30T08:39:29.467469+00:00.