Skip to content

🧬 QuickLookProtein 1.7.22

Choose a tag to compare

View all tags
@github-actions github-actions released this 14 May 05:08
· 187 commits to feature/ario-signed since this release
v1.7.22
37bdc13

🎉 QuickLookProtein 1.7.22

A multi-format molecular Quick Look extension for macOS — press Space in Finder on a structure file, see the 3D molecule.

📥 Install

🍎 macOS

Option A — Disk image (recommended)

  1. Download QuickLookProtein-1.7.22.dmg from the Assets below.
  2. Open it and drag QuickLookProtein onto the Applications shortcut.
  3. Eject the disk image.

Option B — Zip

  1. Download QuickLookProtein-1.7.22.zip from the Assets below.
  2. Unzip and drag QuickLookProtein.app into your Applications folder.

Either way: open any .pdb / .cif / .sdf / .mol / .mol2 / .xyz / .gro / .cube / .pqr / .vasp / .cdjson / .mmtf file in Finder, hit Space for the interactive 3D preview, or switch to Icon View for molecular thumbnails.

🔐 macOS build is signed with Developer ID and notarised by Apple — Gatekeeper runs it without warning.

🪟 Windows — one click

  1. Download QuickLookProtein-Setup.exe from the Assets below.
  2. Double-click it. SmartScreen warns — click More info → Run anyway.
  3. Confirm the "Install QuickLookProtein…" prompt → Yes.
  4. Setup installs QuickLook if missing, drops the plugin in your user profile, restarts the tray.
  5. Press Space on a supported file in Explorer.

No admin, no PowerShell, no unzip.

Other install options
  • PowerShell one-liner — irm https://raw.githubusercontent.com/ArioMoniri/QuickLookProtein/feature/ario-signed/Windows/install.ps1 | iex
  • Installer zip — unpack QuickLookProtein-Windows-Installer.zip, double-click install.bat.
  • Manual — install QuickLook for Windows, download QuickLookProtein-1.7.22.qlplugin, double-click it while QuickLook is running.

⚠️ The Windows installer is unsigned — SmartScreen will warn on first launch. The plugin runs inside QuickLook (not as a standalone exe).

📦 What's inside

  • 🧬 13 molecular file formats — PDB, CIF, mmCIF, SDF, MOL, MOL2, XYZ, GRO, CUBE, PDBQT, PQR, VASP, CDJSON, MMTF
  • 🎨 3Dmol.js-powered preview with cartoon / stick / sphere / line / surface styles
  • 🔄 Rotation, color schemes (spectrum / chain / element / secondary-structure / residue), background color, default zoom
  • 🖼️ Native cartoon-ribbon thumbnails for proteins; CPK space-filling for small molecules
  • 🪟 Lives in Quick Look (Space-bar) and in Finder icon view

📋 Changes (v1.7.21..v1.7.22)

🧪 Built from commit 37bdc13 on 2026-05-14 by the release workflow.

🙏 Originally created by Jethro Hemmann (2021–2022). Multi-format upgrade by Ariorad Moniri (2026). Rendering by 3Dmol.js (Rego & Koes, 2015).

Assets 9
Loading