Skip to content

Installation

Requirements

  • macOS 12.0 (Monterey) or later
  • Xcode Command Line Tools

Quick Install

bash
# Clone the repository
git clone https://github.com/CosmoLabs-org/CosmoQuickView.git
cd CosmoQuickView

# Build and install
make install

Post-Install

  1. Open the app once: open ~/Applications/CosmoQuickView.app
  2. Press Space on any code file in Finder to preview
  3. If another plugin handles the file, go to System Settings > General > Login Items & Extensions > Quick Look and enable CosmoQuickView

Install from Binary

Download the latest release from GitHub Releases, then:

bash
unzip CosmoQuickView.zip
cp -R CosmoQuickView.app ~/Applications/

Install via Homebrew

A Homebrew Cask formula is included in the repository. Once a GitHub release is published:

bash
brew install --cask cosmoquickview

To test the local cask before release:

bash
brew install --cask --no-quarantine Casks/cosmoquickview.rb

Uninstall

bash
cosmoquicklook uninstall
# or
make uninstall