Porthole マニュアル

クイックスタート

1. Portholeを起動します。初回起動時にサンプルクリップが自動作成されます。
2. メニューバーから Porthole設定... を開きます。
3. サンプルクリップを選択するか、+ で新規クリップを追加します。
4. ソース にURLを入力するか、ローカルHTML ファイルを選択します。
5. プレビュー上の矩形をドラッグしてキャプチャ範囲を決めます。
6. 設定を保存 してから クリップを最新化 をクリックし、最初のスナップショットを撮影します。
7. 通知センターに Web Clip ウィジェットを追加し、表示するクリップを選択します。

メニューバー

設定ウィンドウ

クリッピングモード

ローカルHTMLファイル

1. ソース を ローカルHTML に切り替えます。
2. HTMLを選択 をクリックし、ファイルピッカーでHTMLファイルを選択します。
3. 相対パスのアセットを読み込む必要がある場合は 読み取りアクセスルート を設定します。
4. ファイルパスはセキュリティスコープブックマークとして保存され、アプリ再起動後に再選択する必要はありません。

ウィジェット

通知センターに Web Clip ウィジェットを追加します（通知センター → ウィジェットを編集 → "Web Clip" を検索）。

• 小 / 中 / 大 の3サイズに対応しています。
• ウィジェットの設定をタップして表示するクリップを選択できます。
• URLクリップのウィジェットをクリックすると、元のページがデフォルトブラウザで開きます。
• スナップショットがまだ撮影されていない場合はプレースホルダーが表示されます。
• スナップショットはウィジェット領域いっぱいに表示されます。横長・縦長のクリップは余白ではなく中央基準でトリミングされます。
• ウィジェット背景には、スナップショット外周から抽出した代表色を使用します。
• タイムラインは選択クリップの更新間隔に合わせて再読み込みされます。

自動更新

• アプリ起動中は、各クリップが設定した 更新間隔 で自動再撮影されます。
• 更新間隔を超えたクリップは、アプリ起動時とMacのスリープ解除後に再撮影されます。
• アプリが起動していない間、スナップショットは更新されません。

注意 / トラブルシューティング

• ウィジェットにプレースホルダーが表示される — アプリを開いて クリップを最新化 で最初のスナップショットを撮影してください。
• ローカルHTMLの参照が無効 — ファイルが移動またはブックマークが失効しています。HTMLを選択 からファイルを再選択してください。
• セレクタが見つからない — ページ読み込み時に要素が存在していない可能性があります。セレクタを確認するか、矩形モードに切り替えてください。
• ウィジェットが更新されない — macOSによってウィジェット更新が間引かれる場合があります。アプリを起動して手動でキャプチャをトリガーしてください。
• ログイン項目の承認が必要 — macOS 13以降では、システム設定 → 一般 → ログイン項目での確認が必要な場合があります。