URI Protocol (lertaro://)

On its first run, Lertaro automatically registers the lertaro:// custom protocol with Windows. Web hyperlinks, desktop shortcuts, automation scripts, and third-party tools can use this protocol to invoke specific searches, navigate directly to settings sections, or initiate wireless transfers.

1. Scheme Architecture & Single-Instance Routing

• Out of the Box: No manual registry editing is required. Lertaro configures and validates registration upon launch.
• Single-Instance Forwarding: If Lertaro is already running in the background, opening a lertaro:// link forwards the request directly to the active foreground instance without spawning duplicate processes. If Lertaro is not running, Windows starts the application and executes the requested route immediately.

2. Complete URI Route Cheat Sheet

URI Route	Description & Visual Outcome
lertaro://	Activates and displays the Quick Window (equivalent to double-tapping Ctrl).
lertaro://search/[keyword]	Activates the Quick Window, pre-populates [keyword], and filters immediately.
lertaro://fullsearch/[keyword]	Opens the Full Window with [keyword] pre-populated.
lertaro://settings/page/[section]	Opens the Settings window and switches directly to the specified top-level section.
lertaro://settings/entry/[id]	Opens Settings and navigates straight to a specific setting item, highlighting it.
lertaro://localsend	Opens a blank LocalSend wireless transfer window.
lertaro://localsend/items/[encoded_path...]	Opens LocalSend in file mode with one or more pre-populated file/folder paths.
lertaro://localsend/text/[encoded_text]	Opens LocalSend in text mode with pre-populated text ready to send.

Settings Section Keywords [section]

Section names are case-insensitive and match the sidebar navigation in the Settings window:

Service      - Service Status
Index        - Indexing Settings
General      - General Settings
Appearance   - Appearance & Themes
Hotkeys      - Hotkeys & Shortcuts
Plugins      - Plugin Management
Favorites    - Favorites
History      - Search History
QuickPanel   - Quick Panel
About        - About & Updates

NOTE

The numeric ID in lertaro://settings/entry/[id] is dynamically generated by the internal Settings Search plugin. Because IDs may shift across versions, use lertaro://settings/page/[section] for external scripts and documentation links.

3. LocalSend Parameters & Encoding Standards

When triggering LocalSend via URI, every path or text snippet must be properly URL-encoded (e.g. : as %3A, \ as %5C, and spaces as %20):

# Pre-filling multiple file paths
lertaro://localsend/items/C%3A%5CUsers%5Ctestuser%5CDesktop%5Cdoc.pdf/D%3A%5CShared%5Cphotos

# Pre-filling text payload
lertaro://localsend/text/Hello%20from%20Lertaro%21

• Security Constraint: All file paths must be existing absolute paths on the local machine. Links containing payload data open the device selection screen; they never initiate transfers automatically.

4. Integration Examples

Markdown & Knowledge Bases

Embed direct links inside Obsidian, Notion, or internal Markdown documents:

Open [Lertaro Appearance Settings](lertaro://settings/page/Appearance)
Search for [Project Financials](lertaro://search/financial%20report%202026)

Desktop Shortcuts & Scripts

Create a standard Windows shortcut and set the target to:

lertaro://fullsearch/D:\Projects\

Invoke from PowerShell:

Start-Process "lertaro://settings/page/General"

5. Security & Fault Tolerance

• Silent Safety Handling: Because any webpage or external application can invoke URI schemes, Lertaro enforces strict validation on all incoming commands. Malformed or unrecognized routes are safely ignored and logged without triggering errors or unexpected behaviors.