URI プロトコル（lertaro://）
Lertaro は初回起動時に、Windows システムにカスタム URI スキーム lertaro:// を自動登録します。Web ページのリンク、デスクトップショートカット、自動化スクリプト、サードパーティ製ツールから、特定の検索の呼び出し、設定画面への直接ジャンプ、ファイル送信を直接実行できます。
1. プロトコル動作と単一インスタンスルーティング
- 設定不要で即座に利用可能：レジストリを手動で変更する必要はありません。起動時に自動的に登録・整合性チェックが行われます。
- 単一インスタンスへの転送：Lertaro がすでにバックグラウンドで起動している場合、
lertaro://リンクを開くと起動中のインスタンスへ即座に要求が転送され、二重起動は発生しません。未起動の場合はメインアプリが自動起動して指定されたアクションを実行します。
2. URI ルーティング一覧
| URI スキーム形式 | 動作内容と画面の挙動 |
|---|---|
lertaro:// | クイック検索ウィンドウを表示（Ctrl 2 回連打と同等）。 |
lertaro://search/[キーワード] | クイックウィンドウを表示し、指定した [キーワード] を入力して即座に絞り込み。 |
lertaro://fullsearch/[キーワード] | メイン検索ウィンドウを開き、指定した [キーワード] を入力。 |
lertaro://settings/page/[セクション] | 設定画面を開き、指定したトップレベルセクションへ直接切り替え。 |
lertaro://settings/entry/[ID番号] | 設定画面を開き、特定の個別設定項目へジャンプしてハイライト表示。 |
lertaro://localsend | LocalSend の空のファイル送信画面を開く。 |
lertaro://localsend/items/[エンコードされた絶対パス...] | LocalSend をファイル送信モードで開き、1 つまたは複数のパスを事前追加。 |
lertaro://localsend/text/[エンコードされたテキスト] | LocalSend をテキスト送信モードで開き、指定したテキストを入力済みにする。 |
設定セクション名 [セクション]
大文字小文字を区別せず、設定画面のサイドバーに対応しています。
text
Service - サービス状態
Index - インデックス設定
General - 一般設定
Appearance - 外観とテーマ
Hotkeys - ホットキー設定
Plugins - プラグイン管理
Favorites - お気に入り
History - 検索履歴
QuickPanel - クイックパネル
About - バージョン情報NOTE
lertaro://settings/entry/[ID番号] の番号は、内蔵の 設定検索 で動的に生成される内部 ID です。バージョン更新等で変化する可能性があるため、スクリプト等では lertaro://settings/page/[セクション] の使用を推奨します。
3. LocalSend パラメータとエンコード規則
LocalSend の URI を利用する場合、各ファイルパスやテキストは標準的な URL エンコードを行う必要があります（例: : は %3A、\ は %5C、スペースは %20）。
text
# 複数ファイルを指定
lertaro://localsend/items/C%3A%5CUsers%5Ctestuser%5CDesktop%5Cdoc.pdf/D%3A%5CShared%5Cphotos
# 送信テキストを指定
lertaro://localsend/text/Hello%20from%20Lertaro%21- セキュリティ要件：指定するパスはローカルに実在する絶対パスである必要があります。データを含むリンクは端末選択画面を開くだけで、自動的に送信を開始することはありません。
4. 連携スクリプトと活用例
Markdown やナレッジベースでのリンク
Obsidian や Notion、社内ドキュメントに直接リンクを埋め込めます。
markdown
[Lertaro の外観設定を開く](lertaro://settings/page/Appearance)
[プロジェクト財務諸表を検索](lertaro://search/財務諸表%202026)デスクトップショートカットやバッチ
デスクトップで右クリックしてショートカットを作成し、リンク先に以下を指定します。
cmd
lertaro://fullsearch/D:\Projects\PowerShell からの実行例：
powershell
Start-Process "lertaro://settings/page/General"5. 安全性と未知のルーティングの保護
- 安全な無視とロギング：外部の Web サイトやスクリプトから呼び出される可能性があるため、Lertaro はすべての URI パラメータを厳格に検証します。構文エラーや存在しないルーティングは静かに無視され、ログにのみ記録されます。予期せぬ動作やクラッシュを引き起こすことはありません。