Peeka support

Enable Peeka’s Quick Look extension

Install Peeka from the Mac App Store and open the app. Peeka requires macOS 14 Sonoma or later.

1. In Peeka, open Settings → General → Open Extensions Settings. On macOS 15 or later, you can also go to System Settings → General → Login Items & Extensions.
2. Enable Peeka under Quick Look. In Peeka’s format directory, search for the format you need and turn its preview on. Free formats start enabled; Pro formats require Peeka Pro.
3. Return to Finder, select a supported file, and press the space bar. Press it again to close the preview.

Preview APK and AAB files on Mac

Inspect Android app packages in Finder before sharing a build or checking its details. Peeka previews the package; it does not install or run Android apps on macOS.

1. Choose a package in Finder

   Select a local .apk or .aab file, such as a build exported by your Android project. Use a complete file, not a download that is still in progress.

2. Press the space bar

   With Peeka’s extension enabled, Quick Look displays the package preview without opening another app.

3. Check the app details and Pro access

   APK basic metadata is free, including the name, version, SDK requirements, and architectures. AAB, APKS, XAPK, APKM, and AAR previews require Pro; permission and signing summaries also require Pro.

IPA, .app, and .appex basic previews are free. Pro adds Xcode archives, XCFramework, Framework, dSYM, dylib, provisioning profiles, and available signing identity. DMG and flat PKG previews show metadata summaries. Signing metadata does not verify signature validity. Quick Look previews for DMG and flat PKG files now progressively show names and icons of supported applications, without mounting or installing them.

Preview Markdown in Finder

Read a native, formatted README or project note with headings, lists, code blocks, tables, task lists, and strikethrough. Markdown preview is free.

1. Select a Markdown document

   In Finder, choose a local .md file such as README.md. If it is stored in the cloud, make sure it has downloaded to your Mac first.

2. Open the Quick Look preview

   Press the space bar to read the formatted document. Previewing does not edit the file; open your usual editor when you want to make changes.

3. Close the preview when you’re done

   Press the space bar again to return to Finder and continue working with your files.

Local images can appear when they are inside the document directory and file access allows. Remote images are not fetched; HTML and scripts are not executed. Math and footnotes are not rendered. Mermaid source highlighting in Markdown is free. Diagram mode requires Pro and macOS 14.4+; unsupported syntax or resource limits fall back to highlighted source with an explanation. Fenced code blocks use lightweight coloring when the language is one Peeka knows.

Preview structured text and configuration

Supported developer text formats are free. JSON is validated and formatted; JSONL stays line-oriented. Other formats show source or compact summaries.

1. Choose a supported file

   Select JSON, JSONL, XML, YAML, TOML, SQL, diff/patch, proto, GraphQL, INI, properties, editorconfig, plist, CSV, or TSV.

2. Press space to read it

   Structured source previews use lightweight syntax coloring where supported. Property lists show summaries; CSV and TSV show delimited text summaries rather than a spreadsheet.

3. Check any truncation notice

   Text previews have a 1 MB limit. Use your editor for the complete file or to make changes.

dotenv parsing shows key names only and hides values, but Finder routing for .env and .env.* is limited. Supported source files, including HTML, CSS, and JavaScript, preview as read-only source. Supported logs, including Android Logcat and Android Studio layouts, have free highlighted source previews. Pro adds summaries and structured details for recognized content. TXT and TEXT remain plain text without automatic content detection.

Preview SQLite databases

SQLite summaries and table structure are free. Record pages and BLOB previews require Pro, and their scope can vary by version. What your installed version supports is the authoritative list.

1. Select a local SQLite file

   Use a complete database, such as .sqlite, .sqlite3, or .db. When available, keep its WAL and SHM sidecars alongside it. Selecting a sidecar alone does not open a database.

2. Open Quick Look

   Check the database summary and available table structure. When the data view is available, select a table and switch between structure and data.

3. Check Pro data previews

   The new interface shows up to 100 rows per page and up to the first 4 KiB of a selected BLOB. Views and virtual or shadow tables show structure only.

Peeka opens databases read-only and does not edit, repair, or migrate them. Encrypted, damaged, locked, or inaccessible files may fail to preview. Files with unusual names or no extension may not open from Finder.

Browse archive entries

ZIP, TAR, TAR.GZ/TGZ, and JAR/WAR basic listings are free. Independent gzip files show original-file metadata. 7z listings and Java manifest details require Pro.

1. Choose an archive in Finder

   Select a supported local archive and press space.

2. Browse the available entries

   Browse loaded entries in List or Column view. Large archives load metadata on demand; indexing, sorting and cancellation are supported. Resource limits may produce explicitly incomplete listings.

3. Close the preview

   Press space to return to Finder. Peeka lists entries without extracting them to disk; use an archive app to extract files or open their contents.

Pro supports 7z listings with compatible LZMA/LZMA2 headers and single-coder solid archives. Encrypted headers, filter chains and unsupported layouts may prevent listing. Legacy filename detection can misidentify ambiguous names; resource limits still apply.

Manage preview formats and Peeka Pro

The main app provides setup, a searchable format directory, preview switches, settings, and purchase controls. Previews open in Finder. The app does not include a standalone inspector, a comparison view, or export.

1. Choose what Peeka previews

   Search by name or extension and use the format switches. Close and reopen Finder’s preview after a change. Switches control Peeka’s handling of requests, not system extension priority.

2. Open Settings → Peeka Pro

   View the optional one-time purchase and locally displayed price, or use Restore Purchases. There is no subscription or preview quota.

3. Preview newly unlocked formats

   A purchase or restore that newly unlocks Pro enables all Pro formats. Formats you disable afterward stay disabled. Free formats you previously disabled remain off.

Embedded app-icon thumbnails for supported Android and Apple packages do not require Pro and are not controlled by preview switches. Finder may still show cached or system icons.

When Quick Look previews don’t appear