Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dreampiggy/avifquicklook

AVIF QuickLook plugin on macOS
https://github.com/dreampiggy/avifquicklook

av1 avif macos quicklook-plugin

Last synced: 14 days ago
JSON representation

AVIF QuickLook plugin on macOS

Awesome Lists containing this project

README

        

# AVIFQuickLook

![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg?style=flat)
[![Build Status](https://github.com/dreampiggy/AVIFQuickLook/actions/workflows/CI.yml/badge.svg)](https://github.com/dreampiggy/AVIFQuickLook/actions/workflows/CI.yml)

This is the **macOS QuickLook** plugin for [AVIF (AV1 Image File Format)](https://aomediacodec.github.io/av1-avif/). Including 10-bit HDR support.

## Generate Finder thumbnails

![](https://raw.githubusercontent.com/dreampiggy/AVIFQuickLook/master/Screenshot/Thumbnails.png)

## QuickLook the image

![](https://raw.githubusercontent.com/dreampiggy/AVIFQuickLook/master/Screenshot/Preview.png)

These images are from [AVIF Specification Test Files](https://github.com/AOMediaCodec/av1-avif/blob/master/testFiles/)

## Requirements

+ macOS 10.11+ (Big Sur+)
+ M1/Intel Mac are both supported

## Build

+ Xcode 13+
+ CocoaPods 1.11+

```
pod install
open AVIFQuickLook.xcworkspace
```

## Install

### Homebrew Cask (New!)

```
brew install avifquicklook
```

### Manual

1. Grab the latest `AVIFQuickLook.qlgenerator` from the [Release Page](https://github.com/dreampiggy/AVIFQuickLook/releases/latest), or build using Xcode.
2. Open Finder
3. `Shift + Command + G`, input `~/Library/QuickLook/` and press Enter. For macOS Catalina above, use `/Library/QuickLook/` instead.
4. Drag `AVIFQuickLook.qlgenerator` into this folder. You may need to enter the password

## Uninstall

### Homebrew Cask (New!)

```
brew uninstall avifquicklook
```

### Manual

1. Open Finder
2. `Shift + Command + G`, input `~/Library/QuickLook/` and press Enter. For macOS Catalina above, use `/Library/QuickLook/` instead.
3. Delete `AVIFQuickLook.qlgenerator`

## For macOS Big Sur+

If you face the issue that the AVIF preview is blank, please try running the following command:

```
xattr -d -r com.apple.quarantine ~/Library/QuickLook/AVIFQuickLook.qlgenerator
```

Note the path is where you put the `AVIFQuickLook.qlgenerator`

## Author

DreamPiggy, [email protected]

## License

This project is released under the *MIT license*, see **LICENSE**.

## Thanks

+ [libavif](https://github.com/AOMediaCodec/libavif)
+ [aom](https://aomedia.googlesource.com/aom/)
+ [SDWebImageAVIFCoder](https://github.com/SDWebImage/SDWebImageAVIFCoder)
+ [Homebrew Cask](https://github.com/Homebrew/homebrew-cask)