URI プロトコル(swiftlist://)

SwiftList は swiftlist:// リンクのハンドラーとして自身を登録します — 別途インストール手順は不要で、アプリを初めて実行したときに自動的に設定されます。これにより、リンクを開けるもの(ブラウザ、ショートカット、他のアプリ、スクリプトなど)から、ホットキー経由でしか到達できなかった SwiftList の特定の部分に直接ジャンプできるようになります。

SwiftList がまだ実行されていない場合、swiftlist:// リンクを開くとアプリが起動し、その後リンクに従って処理されます。すでに実行中の場合は、実行中のインスタンスがそのリンクを直接処理します — 2つ目のコピーが起動することはありません。

ルート

リンク	動作
swiftlist://	クイック検索ウィンドウをアクティブにします — ホットキーで呼び出した場合と同じです。
swiftlist://search/[keyword]	[keyword] を入力済みの状態でクイック検索ウィンドウをアクティブにします。
swiftlist://fullsearch/[keyword]	[keyword] を入力済みの状態でフル検索ウィンドウを開きます。
swiftlist://settings/page/[section]	設定を指定したトップレベルのセクションで開きます。
swiftlist://settings/entry/[index]	設定を開き、指定した特定の設定項目までジャンプしてハイライトします。

swiftlist://search/report
swiftlist://settings/page/Appearance

1つ目は「report」であらかじめ絞り込まれた状態でクイック検索ウィンドウをアクティブにし、2つ目は設定を外観のページで直接開きます。

[section] はトップレベルのサイドバー項目のいずれかに一致します:Service、Index、General、Appearance、Hotkeys、Plugins、Favorites、History、StartupPanel、About — 大文字小文字は区別されません。

[index] は手入力を想定したものではありません — 設定検索が、選択した設定に対して自動的に生成する番号であり、その検索結果の1つを選択すると、そのまま該当する行に直接戻ってこられる仕組みになっています。再起動をまたいでは安定しないため、特定の番号がそのまま維持されることを前提にしないでください。

認識されないリンク

既知のルートに一致しないもの(タイプミス、サポートされていないセクション、swiftlist:// の後のでたらめな文字列など)は黙って無視されます。どのウェブサイトやアプリでも確認なしにこのプロトコルを呼び出せるため、不正または想定外のリンクが予期しない動作を引き起こすことは決してあってはなりません。トラブルシューティングのためにログには記録されますが、それ以外は何も起こりません。