Repository navigation
Download and install — no Xcode required
Apple Silicon Mac, macOS 14 or later. This release provides pre-built app downloads alongside source.
- Download PeekKit-1.3.3-arm64-adhoc.dmg (or the app ZIP) and SHA256SUMS.txt below. Verify the downloaded file against its SHA-256 entry before proceeding; see the installation guide.
- Mount the DMG and drag PeekKit.app to Applications. Close PeekKit/Quick Look first and keep an old copy temporarily until testing succeeds.
- After verifying and deciding to trust the download, run in Terminal while the DMG is mounted:
bash "/Volumes/PeekKit 1.3.3/install-app.sh" --allow-quarantine-removal- Open PeekKit once; enable PeekKit Folder and PeekKit Markdown in System Settings → General → Login Items & Extensions → Quick Look. Select a folder or Markdown file in Finder and press Space.
For the ZIP, extract it and run bash ./install-app.sh --allow-quarantine-removal from its extracted folder instead. Keep the included Tools folder next to the script. Source ZIP is a separate asset for developers.
安装说明
下载下方 DMG 安装包并核对 SHA-256,挂载后把 PeekKit.app 拖进“应用程序”。保持磁盘挂载,在终端粘贴上方命令,再打开 PeekKit 并在系统设置中启用两项 Quick Look 扩展。普通用户无需 Xcode,也不需要付费开发者账户。
Changes
- Automated ARM app ZIP/DMG/source packaging and SHA-256 manifests.
- Validated installation helper with scoped, explicit quarantine removal; extension registration and Quick Look cache refresh.
- Optional inside-out re-signing preserves extension entitlements. No blanket xattr clearing, global security changes, automatic sudo or forced extension enablement.
- Preserves 1.3.2's folder/Markdown/PDF fixes and existing archive, analysis and inspector features. Version 1.3.3, build 9.
Security and limitations
The app is ad-hoc signed, not Developer ID signed or Apple notarized. Removing quarantine is an explicit trust decision for this app; it does not establish publisher identity or guarantee acceptance on every Mac. The helper checks integrity/versions/sandbox entitlements before changing anything and refuses damaged signatures. A local source build remains available if macOS policy rejects this distribution. No system-wide protections should be disabled.
Large image-heavy PDFs can still temporarily use substantial native PDFKit resources. Supported archives and budgets remain documented in ARCHIVES.md. No new application-feature or fresh-machine Finder compatibility claims are made in this packaging update.
Verification
The tag workflow runs all 250 regression checks, builds the main application and both extensions, verifies their signatures/entitlements, round-trips the app ZIP, validates and read-only mounts the DMG, and verifies SHA-256 checksums before publishing. The public download assets are verified again after publication. See the workflow.