URLスキーム

概要

Raycast、Alfred、ショートカット、ターミナル、ブラウザなど、URLを開くことができるすべてのアプリからSnapzyのアクションを起動できます。snapzy:// リンクを開くだけです。

サポートされているスキームとエイリアス

各アクションは、利便性のためにプライマリURLスキームといくつかの代替エイリアスをサポートしています。

1. スクリーンショット (Screenshots)

全画面キャプチャ

画面全体をキャプチャします。

snapzy://capture/fullscreen
snapzy://capture-screen
snapzy://capture-fullscreen
snapzy://fullscreen
snapzy://screenshot/fullscreen

範囲キャプチャ

対話的な範囲選択ツールを起動します。

snapzy://capture/area
snapzy://capture-area
snapzy://area
snapzy://screenshot/area

アプリケーションウィンドウのキャプチャ

特定のアプリケーションウィンドウをキャプチャします。

snapzy://capture/application
snapzy://capture/window
snapzy://application-capture
snapzy://window-capture
snapzy://screenshot/window

アクティブウィンドウのキャプチャ

現在アクティブ/フォーカスされているウィンドウを即座にキャプチャします。

snapzy://capture/active-window
snapzy://capture/focused-window
snapzy://active-window-capture
snapzy://active-window
snapzy://screenshot/active-window

範囲キャプチャと注釈

選択した範囲をキャプチャし、注釈/マークアップエディタで直接開きます。

snapzy://capture/area-annotate
snapzy://capture-area-annotate
snapzy://area-annotate
snapzy://screenshot/area-annotate

スクロールキャプチャ

長いWebページやドキュメントをキャプチャするためのスクロールキャプチャを開始します。

snapzy://capture/scrolling
snapzy://scrolling-capture
snapzy://capture-scrolling
snapzy://scrolling
snapzy://screenshot/scrolling

テキストキャプチャ (OCR)

範囲を選択してOCRでテキストを抽出します。

snapzy://capture/ocr
snapzy://capture/text
snapzy://capture-text
snapzy://ocr
snapzy://text

スマートエレメントキャプチャ

ホバー時にUI要素を自動的に検出してキャプチャします。

snapzy://capture/smart-element
snapzy://smart-element
snapzy://capture-smart-element
snapzy://smart

被写体の切り抜き (Object Cutout)

範囲を選択して主要な被写体を切り抜き、背景を削除します。

snapzy://capture/object-cutout
snapzy://object-cutout
snapzy://capture-object-cutout
snapzy://cutout

2. 画面録画 (Screen Recordings)

画面録画

ビデオまたはGIFの画面録画を開始します。

snapzy://record/screen
snapzy://record-screen
snapzy://screen-recording
snapzy://recording
snapzy://record

アプリケーションウィンドウの録画

選択したアプリケーションウィンドウの録画を開始します。

snapzy://record/application
snapzy://record/window
snapzy://application-recording
snapzy://window-recording
snapzy://recording/window

3. ビューを開く (Open Views)

注釈エディタを開く

空の注釈/マークアップエディタを開きます。

snapzy://open/annotate
snapzy://annotate
snapzy://open-annotate

動画エディタを開く

空の動画エディタを開きます。

snapzy://open/video-editor
snapzy://video-editor
snapzy://edit-video
snapzy://open-video-editor

クラウドアップロードを開く

クラウドへのアップロード履歴を開きます。

snapzy://open/cloud-uploads
snapzy://cloud-uploads
snapzy://uploads
snapzy://open-uploads

履歴を開く

ローカルのキャプチャおよび録画履歴を開きます。

snapzy://open/history
snapzy://history
snapzy://capture-history

ショートカット一覧を表示

キーボードショートカットの一覧を表示します。

snapzy://show/shortcuts
snapzy://shortcuts
snapzy://keyboard-shortcuts
snapzy://show-shortcuts

4. 設定と環境設定 (Settings & Preferences)

基本URL構造

次のいずれかを使用して設定を開きます：

snapzy://settings
snapzy://preferences

特定のタブを開くには、パスまたはクエリパラメータを使用します：

snapzy://settings/<tab_name>
snapzy://preferences/<tab_name>
snapzy://settings?tab=<tab_name>
snapzy://preferences?tab=<tab_name>

サポートされている設定タブ

設定対象	タブ名 (<tab_name>)	サポートされているエイリアス
一般設定	general
キャプチャ設定	capture	screenshots, screenshot
注釈エディタ	annotate	annotation, annotations
クイックアクセスパネル	quick-access	quickaccess
履歴	history
キーボードショートカット	shortcuts	keyboard-shortcuts
システム権限	permissions	privacy
クラウドストレージ	cloud	uploads
詳細設定	advanced	configuration, config, toml
Snapzyについて	about

---

「ショートカット」アプリの例

macOSの組み込み「ショートカット」アプリでパーソナル自動化を作成できます：

1. 「ショートカット」アプリを開き、新しいショートカットを作成します。
2. 「URLを開く」 アクションを追加します。
3. snapzy://capture/area を入力します。
4. ショートカットの設定でキーボードショートカットを割り当てます。

これで、任意のショートカットまたは自動化ワークフローから範囲キャプチャをトリガーできるようになります。

ターミナルとスクリプト

ターミナルやシェルスクリプトからは、open コマンドを使用します：

open "snapzy://capture/fullscreen"

これは、ビジュアル回帰テスト（Visual Regression Capture）用のキャプチャを必要とする大規模な自動化パイプラインやCIワークフローにSnapzyを統合する際に便利です。

Raycast & Alfred

RaycastとAlfredはどちらもカスタムURLを開く機能をサポートしています。任意の snapzy:// パスを指す新しいスクリプトまたはURLを開くアクションを作成し、ホットキーを割り当てれば、メニューバーに触れることなくキャプチャを起動できます。