Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/dev2forge/bridgex/llms.txt

Use this file to discover all available pages before exploring further.

Bridgex registers a global key-down handler on its root element so that shortcuts remain active regardless of which part of the interface is focused. The handler checks event.modifiers.ctrl() or event.modifiers.meta(), meaning every shortcut works with the Ctrl key on Windows and Linux and with the ⌘ (Command) key on macOS. No configuration is required — the shortcuts are hard-coded in the on_global_key_down closure inside app.rs.

​
Shortcut reference

ShortcutmacOS equivalentAction
Ctrl+O⌘+OOpen the native file dialog to select a file for conversion
Ctrl+S⌘+SOpen the native save dialog to write the current Markdown to a .md file
Ctrl+Q⌘+QExit Bridgex immediately (std::process::exit(0))
Ctrl+I⌘+IToggle the About popup
Ctrl+L⌘+LToggle the Licenses popup
Ctrl+K⌘+KToggle the LLM Settings popup
All six shortcuts use the same modifier check — ctrl() or meta() — so there is no difference in behaviour between the two keys. Both modifiers trigger the same action on any platform.
Every shortcut maps directly to a menu bar entry. You can use either the keyboard or the menu; both update the same application state.
The File menu is located at the top-left of the menu bar. It contains three items:
Menu itemShortcutAction
OpenCtrl+O / ⌘+OOpens the file picker
SaveCtrl+S / ⌘+SOpens the save-as dialog
ExitCtrl+Q / ⌘+QExits the application
Exit closes the application immediately without a confirmation dialog. Make sure you have saved your Markdown before exiting.

​
How the shortcuts work internally

The shortcut handler is attached at the application root via Freya’s on_global_key_down event. The relevant portion of app.rs shows: 
.on_global_key_down(move |event: Event<KeyboardEventData>| {
    if event.modifiers.ctrl() || event.modifiers.meta() {
        match event.code {
            Code::KeyO => { /* open file */ }
            Code::KeyS => { /* request save */ }
            Code::KeyQ => { /* request exit */ }
            Code::KeyI => { /* toggle About */ }
            Code::KeyL => { /* toggle Licenses */ }
            Code::KeyK => { /* toggle LLM Settings */ }
            _ => {}
        }
    }
})
The save and exit actions work through boolean state flags (save_requested and exit_requested). Bridgex reads these flags on the next render pass, then performs the associated file-system or process operation and resets the flag. This keeps side effects out of the event handler itself.

​
Tips for efficient use

Convert and save quickly

Press Ctrl+O to open a file, review the Markdown in the editor, then press Ctrl+S to save — all without touching the mouse.

Configure LLM before converting images

Open the LLM Settings popup with Ctrl+K, enter your API key, then open your JPEG file with Ctrl+O to get an AI-generated description.

Build docs developers (and LLMs) love

Get started for freeTalk to us