Skip to content

BUILDING.md

Latest commit

 

History

History
55 lines (47 loc) · 2.95 KB

BUILDING.md

File metadata and controls

55 lines (47 loc) · 2.95 KB
Raw

Building

Prerequisites

  • Requires Xcode with macOS 12 SDK or later.
  • Before building, update submodules with git submodule update --init --recursive.
  • ffmpeg and its dependencies require "Meson", "Ninja", "pkg-config" and the "NASM" assembler to build. You can obtain them through Homebrew via brew install meson ninja pkg-config nasm. The built executables and libraries won't depend on Homebrew.

Products

The Xcode project QLVideo.xcodeproj builds the following Products:

  • QuickLook Video.app - App that hosts plugins and extensions, and registers the Uniform Type Identifiers of the media types that the plugins understand.
  • mdimporter - Spotlight plugin provides metadata.
  • previewer - QuickLook app extension provides previews for non-native file types. Not included in v3 of the app.
  • thumbnailer - QuickLook app extension provides thumbnails. Not included in v3 of the app.
  • formatreader - Media extension that provides support for non-native file types and audio codecs.
  • videodecoder - Media extension that provides support for non-native video codecs.
  • contactsheet - Service that provides previews of video files as a series of snapshots.
  • simpleplayer - Helper app for debugging the formatreader and videodecoder extensions. Plays files using AVFoundation. Not included in the main app.
  • benchmark - Simple executable for benchmarking. Not included in the app.
  • ffmpeg - The FFmpeg libraries. The app and its extensions depend on these. Also builds a standalone version of the ffprobe executable for bug reporting.
  • dav1d - Support for the AV1 codec. ffmpeg depends on this.
  • zimg - Support for format and HDR colour conversion. ffmpeg depends on this.

Debugging

All plugins produce output in the system log. Use the filter subsystem:uk.org.marginal.qlvideo in the Console app, or sudo log stream --style compact --debug --predicate 's=uk.org.marginal.qlvideo' in the Terminal.

In addition, you can dump a summary of formatreader's internal state to the system log with killall -info "QLVideo Formats".

To debug in Xcode, first build the "Quicklook Video" target once. Then switch targets depending on what you wish to debug:

  • mdimporter - Edit the "Run" scheme:

    • Executable: /usr/bin/mdimport
    • Debug executable: ✔
    • Arguments: -t -d2 <testfile>

  • formatreader and videodecoder - Edit the "Run" scheme for the "formatreader" target as follows:

    • Executable: simpleplayer.app
    • Debug executable: ✔

    Choose a testfile in the simpleplayer application.

  • contactsheet - Edit the "Run" scheme:

    • Executable: navigate to "QLVideo Contact Sheet.app" in QuickLookVideo.app/Contents/Helpers/
    • Debug executable: ✔

    Select a video file in Finder and choose "View contact Sheet" from Finder's Services menu.