PeekKit 1.3.3 — Pre-built Downloads & Easy Installation

Download and install — no Xcode required

Apple Silicon Mac, macOS 14 or later. This release provides pre-built app downloads alongside source.

1. 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.
2. Mount the DMG and drag PeekKit.app to Applications. Close PeekKit/Quick Look first and keep an old copy temporarily until testing succeeds.
3. 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

4. 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.

PeekKit 1.3.2 — Markdown & PDF Stability

PeekKit 1.3.2 — Markdown & PDF Stability

Stable source release, version 1.3.2 (build 8), for Apple Silicon/macOS 14+. No notarized binary is provided.

Fixes

• Restore folder-contained Markdown body layout, continuous table borders, complete dates and Chinese wrapping; keep Preview/Source switching.
• Keep native Markdown readable in dark appearance using semantic body colors while preserving syntax/link colors.
• Use a lazy native PDF page menu that works inside Finder. Continuous file-backed scrolling, zoom and page counts remain.
• Release a PDF descriptor lease when preview cancellation arrives before native view creation; add repeated teardown/identity regressions.

PDF investigation

Three real Finder sessions of the original image-heavy 712-page PDF reached sampled peak RSS of roughly 1.14–1.24 GiB. Physical footprint recovered to approximately 52–55 MB after leaving the PDF and 50 MB after closing Quick Look; idle CPU approached zero. Time Profiler observed native JPEG2000 decoding and PDFKit-triggered text recognition. The reported 5.39 GB incident was not reproduced, and there is no hard CPU/RAM cap or speedup claim. Leaks reported a stable 384 bytes of CFData without app attribution. Direct Allocations attachments were unavailable; VM summaries, system Time Profiler and content-free leaks scans were used. See docs/VALIDATION-1.3.2.md for methods and limitations.

Verification

231/231 clean-source automated checks passed; main app and both extensions built with strict ad-hoc signature validation. Real Finder checks covered affected original PDF/Markdown, light/dark Markdown, page menu, browsing/analysis/inspector/columns, direct archive type registration and bounded archive previews. Full VoiceOver, all macOS versions, prolonged stress and real cloud-provider behavior remain unverified.

Build and install

1. Download PeekKit-1.3.2-source.zip and SHA256SUMS.txt into the same directory.
2. Verify: shasum -a 256 -c SHA256SUMS.txt.
3. Extract the ZIP, enter PeekKit-1.3.2, and run ./build.sh with Xcode selected.
4. Keep a temporary rollback copy, replace /Applications/PeekKit.app with .build/PeekKit.app, and open it once.
5. Enable PeekKit Folder and PeekKit Markdown in macOS Quick Look settings; close/reopen Finder previews and verify both show 1.3.2/build 8 from one installed app. Remove the temporary rollback copy after successful checks.

No paid developer membership is required. Local signing is ad-hoc, not Developer ID signing or Apple notarization. Do not disable macOS security protections. Build/installation details: docs/BUILDING.md and docs/INSTALL.md.

Supported archives remain ZIP Store/Deflate, TAR, TGZ/TAR.GZ, TBZ2/TAR.BZ2, and a restricted 7z Copy/LZMA1/LZMA2 subset. Encryption, XZ/RAR, ZIP64 and unsafe or over-budget inputs remain unsupported. Existing security/resource limits are unchanged.

PR: #4

Release commit: ab04067

CI: https://github.com/LujiaChen/PeekKit/actions/runs/41535022746

Full changelog: v1.3.1...v1.3.2

Post-install verification

The published source ZIP checksum was verified, rebuilt locally and installed as 1.3.2/build 8. All three installed executables match that build; the two active Quick Look registrations point only to Applications.

Actual Finder testing after installation passed the original 712-page PDF: native page menu to page 100, pages 100–105, scrolling, zoom and three reopen/leave cycles. Physical footprint after the first two returns was 46.0M / 48.3M, and 44.5M after final Quick Look closure; sampled idle CPU was 0%. Peak physical footprint was reported as 1.6G. These finite observations are not a hard memory bound or a controlled speedup claim.

The original Markdown document's continuous table borders, complete dates, Chinese wrapping and Preview/Source switching also passed in Finder. Private document bytes and the original directory name were preserved; no private content is included here. The temporary rollback app was removed after successful installation checks.

PeekKit 1.3.1 — Large PDFs & Safe 7z Browsing

PeekKit 1.3.1 (build 7) is a stable source release for Apple Silicon/macOS 14+.

Large PDFs

• File-backed native PDFKit viewer replaces the 50 MB whole-Data preview gate.
• Continuous scrolling, zoom, Previous/Next, page number + Go, page count and Fit.
• No-follow descriptor pinning, local/cloud residency checks, asynchronous opening and explicit invalid/locked/unreadable errors. Archive PDFs keep the bounded in-memory path.
• The private 86 MB/712-page PDF was verified locally in actual Finder folder browsing; no textbook content is included.

Safe 7z subset

• Copy, LZMA1 and LZMA2, including bounded solid streams and compressed headers; integrated tree/list/search/navigation and text/image/PDF/Markdown previews.
• Independent restricted header parser, 8 MiB dictionary cap, 16 MiB raw-decoder memory-estimate budget, 1 MiB header budget; existing 64 MiB input, 32 MiB file, 128 MiB decoded-total and 20,000-entry limits.
• Encryption, filter chains/other codecs, unsafe paths/links, invalid metadata/checksums and resource-limit violations fail closed. No disk extraction or execution.

Verification and limits

218 checks passed from a clean clone, with host and both extensions built/signature-verified. Real Finder tests and genuine synthetic screenshots: validation.

ZIP Store/Deflate, TAR, TGZ/TAR.GZ and TBZ2/TAR.BZ2 remain supported. XZ, RAR, ZIP64, encrypted archives and recursive nested browsing remain unsupported. Native calls and the 10-second deadline are cooperative; codec-memory estimates are not process RSS ceilings. PDFKit image/page caches can use substantial RAM. Some keys are reserved by Finder; use PDF Go/visible controls. Complete VoiceOver, real cloud providers, other Macs/OS versions and prolonged stress are not claimed verified.

Build/install

git clone --branch v1.3.1 https://github.com/LujiaChen/PeekKit.git
cd PeekKit
./build.sh

Move .build/PeekKit.app to Applications, open it once, enable PeekKit Folder and PeekKit Markdown in Quick Look settings, and keep one registered installed copy. Preserve a temporary old copy until verified. Installation, PDF architecture, archive limits.

Attached source ZIP and SHA-256 manifest identify the tagged tree. No notarized binary is distributed; local builds are ad-hoc signed and require no paid Apple account or security bypass. Public-domain liblzma API headers are bundled with notices/provenance; runtime uses the OS library, with no 7-Zip CLI dependency.

PeekKit 1.3.0 — Archive Browsing & File Inspector

PeekKit 1.3.0 (build 6) is an official stable source release for Apple Silicon and macOS 14+. No notarized application binary is attached; default local builds are ad-hoc signed and require no paid Apple account.

Archive browsing

• ZIP Store/Deflate, TAR, TAR.GZ/TGZ and TAR.BZ2/TBZ2.
• Tree/directory browsing, path search, sorting, parent/root navigation and bounded in-memory text, image, PDF and Markdown previews.
• Concrete TGZ/TBZ2 Quick Look type registration fixes the system-icon fallback found by independent Finder QA.
• ZIP local/central checks, bounded raw filter expansion and TAR metadata preflight reject unsafe paths/links, malformed metadata, encryption, unsupported codecs and over-budget inputs. No disk extraction or entry execution.

File inspector and lists

• Logical/allocated size, readable extension-derived type/UTType, dates, permissions, link status, full path, resident image dimensions and PDF page counts.
• Persisted optional list columns with cached metadata: Type, Size, Allocated, Created, Modified, Accessed and Extension. Name remains visible.
• Existing folder Grid/List/Tree, storage analysis/exports and offline Markdown remain available.

Verified scope

158 checks passed locally from a clean clone: 28 analysis, 35 browser/inspector/ordering, 20 content/export/security, 28 renderer/lifecycle, 37 archive and 10 registration checks. Main app and both extensions built and passed strict signature verification.

The corrected build was temporarily installed at the production path and exercised with Finder Space for stored/deflated ZIP, TAR, TGZ, TBZ2, both double-suffix aliases, folders and Markdown. Archive navigation, filter/size sort, image/PDF/Markdown details, information sheets, persisted columns, empty/error recovery, larger archive/reopen, and light/dark appearance were checked. Genuine Finder and standalone screenshots and exact test boundaries are in the validation report.

Installation

git clone --branch v1.3.0 https://github.com/LujiaChen/PeekKit.git
cd PeekKit
./build.sh

Preserve an older app before replacement. Move .build/PeekKit.app to Applications, open it once and enable PeekKit Folder and PeekKit Markdown in Quick Look settings. Keep only one registered installed copy. Installation/troubleshooting.

Limits

Input 64 MiB; decoded entry 32 MiB; decoded aggregate/raw TAR 128 MiB; 20,000 entries/nodes; 64 path components; further explicit metadata bounds. The 10-second limit is cooperative between native calls, not a hard CPU/RSS guarantee. OS archive/image/PDF decoder vulnerabilities remain a native-code trust boundary; keep macOS updated.

XZ, 7z, RAR, ZIP64, encrypted/split/self-extracting archives, unsupported TAR extensions and recursive nested-archive browsing are not supported. Per-entry compressed sizes are unavailable. Archived formatted Markdown is capped at 128 KB. Finder may reserve arrow/Return keys instead of delivering them to the preview; use visible controls in that host. A complete keyboard-only/VoiceOver audit, real cloud-provider integration, other macOS versions and clean-machine installation are not claimed. Immediate close/reopen was checked, while mid-decoder cancellation is proven by harness tests rather than by a timed Finder observation.

The stable source designation does not imply Apple notarization or universal compatibility. Attached source ZIP and SHA-256 manifest identify the exact tagged tree.

PeekKit 1.2.0 — browsing, analysis & offline Markdown (source preview)

PeekKit 1.2.0 improves folder browsing, metadata-based storage analysis and offline Markdown previews.

Source preview for Apple Silicon / macOS 14+. No notarized production app is attached. Build locally with Xcode using ./build.sh; default signing is ad-hoc. Keep an older application somewhere recoverable before replacing it. See installation.

Added and improved

• Lazy, bounded Tree view beside grid/list, file-type column and sorting, focused arrow/Return navigation, contextual Reveal/Copy Path/Open With and persistent view/sort preferences.
• Worker-computed cached filtering and ordering; generation-checked cancellation and metadata-aware thumbnail cache.
• Recursive top-20 nested folders in both size metrics, clearer file-type shares and scope/partial labels, explicit JSON/CSV clipboard export. Allocated blocks are not reclaimable or exclusive APFS space.
• Shared safe Markdown body, bounded offline lexical code highlighting, tables/quotes and HTML contents navigation. Raw HTML stays escaped; bundled sanitization, CSP and resource/protocol restrictions remain. No added dependency or network permission.
• Background preview reads/decoding; UTF-8 boundary and UTF-16 handling; cancellation/stale WebKit result protection.
• CI covers all four test suites and builds both native Quick Look extensions. Optional Developer ID/hardened-runtime and notarization tooling is included without credentials.

Validation

• 102 passed / 0 failed: 28 analysis, 26 browser/preview, 20 content/export/security and 28 renderer/lifecycle checks. Original tests retained.
• Main app and both extensions built; local development-signed installation passed strict bundle signature verification. Old installed app and byte-verified backup were preserved.
• Installed extensions exercised through the system Quick Look host; standalone tree/filter/analysis/Markdown and light/dark appearance checked. Finder Space-bar recheck was limited by the automation window connection.
• One local 25,000-file metadata scan: 1.095 s before / 0.949 s after, with ~12.55 ms maximum model main-actor heartbeat in both. Twenty ordering reads over 20,000 entries: ~76.63 ms repeated sorts / ~0.0051 ms cached reads, excluding initial background sorting and painting. These are scoped measurements, not an end-to-end or statistically established speedup.

Limits

Tree is bounded to 2,000 immediate children per expansion, 10,000 cached children and 64 levels; main listing and scanner bounds remain. Folder totals overlap; hard links are assigned to first encounter. Native attributed Markdown omits HTML-fragment contents links and caps formatted conversion at 128 KB (Source retains the 8 MB read limit). Mermaid/KaTeX are deferred. Host windows can consume command shortcuts.

Real cloud providers, network/cross-volume mounts, million-entry trees, Intel, clean-machine installation and full accessibility remain unverified. Optional notarization could not be exercised because Developer ID/notary credentials were unavailable. No macOS security controls were bypassed.

Upgrade guide, actual screenshots, security details and measurements · Changelog · 中文说明

Attached: exact tagged source archive and SHA-256 checksum.

PeekKit 1.1.0 — initial public preview

Browse folders, analyze their contents, and read Markdown from Finder Quick Look.

• Folder grid/list, child navigation, sorting, filtering and hidden-file toggle.
• Recursive size, file-type counts/capacity and top-20 files under logical or allocated size.
• Background progress, Stop/Rescan, cancellation and explicit omissions.
• Image, PDF, text and offline Markdown previews.

Source preview: Apple Silicon/macOS 14+, Xcode required. No Developer ID–signed/notarized binary is attached. Installation on another Mac remains unverified.

28 scanner/model and 22 renderer checks passed locally. Real Finder interactions were exercised. Cloud placeholders and network/cross-volume mounts remain untested. The release build and scanner/model suite also passed GitHub Actions on macOS arm64.

English README · 中文说明 · Build · Analysis scope

MIT for original source. Marked, DOMPurify and PeekX reference notices are included.