Getting Started

Installation

• Download the latest release.
• Double-click on it.
• The Installer app will walk you through the installation process.

Alternatively, if you have Homebrew installed, you can install using Homebrew Cask:

brew cask install qlvideo

Limitations

• To see thumbnails of video files you may need to relaunch Finder (ctrl-⌥-click on the Finder icon in the Dock and choose Relaunch) or log out and back in again.
• You may experience high CPU and disk usage for a few minutes after installation while Spotlight re-indexes all of your "non-native" audio and video files.
• QuickLook struggles with .mp4 files. In particular, QuickLook on recent versions of OSX cannot preview a .mp4 file containing H.265-encoded video. Rename your .mp4 files as .m4v, or use another container for H.265 content - e.g. Matroska.
• The QuickLook "Preview" function displays a static snapshot of "non-native" video files. You'll need a media player app (e.g. VLC or MPlayerX) to play "non-native" files.
• Interlaced content is sometimes not de-interlaced in QuickLook thumbnails and previews.
• Requires OSX 10.9 or later. Use Perian for equivalent functionality under 10.8 and earlier.