Peeka サポート

Peeka のクイックルック機能拡張を有効にする

Mac App Store から Peeka をインストールして開きます。macOS 14 Sonoma 以降が必要です。

1. Peeka で「設定」→「一般」→「機能拡張設定を開く」を開きます。macOS 15 以降では、「システム設定」→「一般」→「ログイン項目と機能拡張」からも移動できます。
2. クイックルックで Peeka を有効にします。Peeka の形式一覧で必要な形式を検索し、プレビューをオンにします。無料の形式は最初から有効です。Pro の形式には Peeka Pro が必要です。
3. Finder に戻り、対応ファイルを選択してスペースバーを押します。もう一度押すとプレビューが閉じます。

Mac で APK と AAB ファイルをプレビューする

ビルドを共有したり詳細を確認したりする前に、Finder で Android アプリのパッケージを確認できます。Peeka はパッケージをプレビューするだけで、macOS に Android アプリをインストールしたり実行したりはしません。

1. Finder でパッケージを選びます

   .apk または .aab のローカルファイルを選択します。Android プロジェクトから書き出したビルドなどが該当します。ダウンロード中のファイルではなく、完全なファイルを使ってください。

2. スペースバーを押します

   Peeka の機能拡張が有効なら、別のアプリを開かずにクイックルックでパッケージのプレビューが表示されます。

3. アプリの詳細と Pro の利用可否を確認します

   名前、バージョン、SDK の要件、アーキテクチャを含む APK の基本的なメタデータは無料です。AAB、APKS、XAPK、APKM、AAR のプレビューには Pro が必要です。権限と署名の要約も Pro が必要です。

IPA、.app、.appex の基本プレビューは無料です。Pro では Xcode アーカイブ、XCFramework, Framework, dSYM、dylib、プロビジョニングプロファイル、利用できる署名識別情報も表示できます。DMG とフラット PKG のプレビューでは、メタデータの要約と、対応するアプリの名前とアイコンを段階的に表示します。マウントやインストールは不要です。署名のメタデータは、署名が有効かどうかの検証ではありません。

Finder で Markdown をプレビューする

見出し、リスト、コードブロック、表、タスクリスト、取り消し線を含む、ネイティブに整形された README やプロジェクトメモを読めます。Markdown のプレビューは無料です。

1. Markdown 書類を選択します

   Finder で README.md などのローカル .md ファイルを選びます。クラウドに保存されている場合は、先に Mac へダウンロードされていることを確認してください。

2. クイックルックのプレビューを開きます

   スペースバーを押して、整形された書類を読みます。プレビューではファイルを編集しません。変更するときは、普段のエディタで開いてください。

3. 読み終えたらプレビューを閉じます

   スペースバーをもう一度押すと Finder に戻り、ファイルの作業を続けられます。

書類と同じディレクトリにあり、ファイルアクセスが許可されている場合、ローカル画像を表示できます。リモート画像は取得せず、HTML とスクリプトも実行しません。数式と脚注はレンダリングされません。Markdown 内の Mermaid ソースのハイライトは無料です。図モードには Pro と macOS 14.4 以降が必要です。未対応の構文やリソース上限に達した場合は、理由とともにハイライトされたソースを表示します。コードブロックに Peeka が対応する言語が指定されている場合は、簡易的なシンタックスハイライトを適用します。

構造化テキストと設定ファイルをプレビューする

対応している開発者向けテキスト形式は無料です。JSON は検証して整形し、JSONL は行のまま表示します。その他の形式はソースまたは簡潔な要約を表示します。

1. 対応ファイルを選びます

   JSON、JSONL、XML、YAML、TOML、SQL、diff/patch、proto、GraphQL、INI、properties、editorconfig、plist、CSV、または TSV を選択します。

2. スペースバーを押して読みます

   対応している構造化ソースは、可能な範囲で簡易的なシンタックスハイライトを使います。プロパティリストは要約を表示します。CSV と TSV はスプレッドシートではなく、区切りテキストの要約を表示します。

3. 切り詰めの表示を確認します

   テキストのプレビューは 1 MB までです。ファイル全体を見るときや変更するときは、エディタを使ってください。

dotenv の解析ではキー名だけを表示し、値は隠します。ただし .env と .env.* を Finder から渡す動作には制限があります。HTML、CSS、JavaScript を含む対応ソースファイルは、読み取り専用のソースとしてプレビューします。 Android Logcat や Android Studio 形式を含む対応ログは、ハイライト付きの原文を無料で表示します。Pro では認識した内容の要約と構造化された詳細を表示できます。TXT／TEXT は自動判別せず、プレーンテキストで表示します。

SQLite データベースをプレビューする

SQLite の要約とテーブル構造は無料です。レコードのページ表示と BLOB のプレビューには Pro が必要です。これらの機能が使えるかどうかは、インストール済みのバージョンによって異なります。

1. ローカルの SQLite ファイルを選択します

   .sqlite、.sqlite3、.db などの完全なデータベースを使います。WAL と SHM の付随ファイルがある場合は、データベースと一緒に置いてください。付随ファイルだけを選択しても、データベースは開きません。

2. クイックルックを開きます

   データベースの要約と、利用できるテーブル構造を確認します。データ表示がある場合は、テーブルを選んで構造とデータを切り替えられます。

3. Pro のデータプレビューを確認します

   新しいインターフェースでは、1 ページあたり最大 100 行、選択した BLOB の先頭 4 KiB までを表示します。ビュー、仮想テーブル、シャドウテーブルは構造のみを表示します。

Peeka はデータベースを読み取り専用で開き、編集、修復、移行は行いません。暗号化、破損、ロック、またはアクセスできないファイルはプレビューできないことがあります。任意のファイル名や、拡張子のないファイルを Finder から開く動作は、まだ完全には検証されていません。

アーカイブの項目を閲覧する

ZIP、TAR、TAR.GZ/TGZ、JAR/WAR の基本的な一覧は無料です。単体の gzip ファイルは、元のファイルのメタデータを表示します。7z の一覧と Java マニフェストの詳細には Pro が必要です。

1. Finder でアーカイブを選びます

   対応しているローカルのアーカイブを選択し、スペースバーを押します。

2. 表示できる項目を閲覧します

   リスト表示やカラム表示で読み込んだ項目を閲覧できます。大きなアーカイブは必要に応じてメタデータを読み込み、索引、並べ替え、キャンセルに対応します。リソース上限による不完全な一覧は明示されます。

3. プレビューを閉じます

   スペースバーを押すと Finder に戻ります。Peeka は項目を一覧表示するだけで、ディスクには展開しません。ファイルを展開したり中身を開いたりするときは、アーカイブ用アプリを使ってください。

Pro は対応する LZMA／LZMA2 ヘッダーと単一 coder の solid 7z の一覧を表示できます。暗号化ヘッダー、フィルターチェーン、未対応の構成は一覧を表示できない場合があります。旧文字コードの曖昧なファイル名は誤認識することがあり、リソース上限も適用されます。

プレビュー形式と Peeka Pro を管理する

メインアプリでは、初期設定、検索できる形式一覧、プレビューのスイッチ、設定、購入の操作ができます。単体のインスペクタ、比較、書き出しは現在は未対応で、今後の追加を予定しています。

1. Peeka がプレビューする形式を選びます

   名前または拡張子で検索し、形式のスイッチを使います。変更したあとは、Finder のプレビューを閉じて開き直してください。スイッチが制御するのは Peeka がリクエストを処理するかどうかであり、システムの機能拡張の優先順位ではありません。

2. 「設定」→「Peeka Pro」を開きます

   任意の買い切り購入と、ローカルに表示される価格を確認するか、「購入を復元」を使います。サブスクリプションも、プレビュー回数の上限もありません。

3. 新しく解除された形式をプレビューします

   購入または復元によって Pro が新たに有効になると、すべての Pro 形式がオンになります。そのあと無効にした形式は、無効のままです。以前無効にした無料の形式も、オフのままです。

対応している Android と Apple のパッケージに埋め込まれたアプリアイコンのサムネイルは、Pro がなくても表示され、プレビューのスイッチでも制御されません。Finder がキャッシュまたはシステムのアイコンを表示することはあります。

クイックルックのプレビューが表示されないとき