Keyboard Shortcut Mapper

WHAT IT DOES

Keyboard Shortcut Mapper is a browser extension that allows you to create custom keyboard shortcuts for common actions on any webpage. You can record key combinations and assign them to actions including scrolling to the top or bottom of the page, clicking a specific element using a CSS selector, or running custom JavaScript code. The tool includes a list of all active shortcuts with the ability to enable or disable them individually. Shortcuts are saved per website, so you can have different shortcuts for different sites. The tool is ideal for power users, developers, and anyone who wants to navigate and interact with web pages more efficiently using keyboard shortcuts.

WHERE IT RUNS

Keyboard Shortcut Mapper runs on any webpage, overlaying a floating panel that does not interfere with page content. It operates entirely in your browser as a lightweight userscript, capturing keyboard events and executing actions. It works on any page, whether static or dynamic, with no external dependencies. All shortcut data is stored locally using GM_setValue—no data is ever sent to any server.

HOW TO USE

After installation, open the floating panel by clicking the extension icon. To create a new shortcut, click the "Record Shortcut" button, then press the desired key combination (e.g., Ctrl+Shift+T, Alt+J, or Ctrl+1). Select an action from the dropdown: "Scroll to Top," "Scroll to Bottom," "Click Element," or "Run JavaScript." For "Click Element," enter a CSS selector in the field below (e.g., "#submit" or ".button-primary"). For "Run JavaScript," enter the code you want to execute (e.g., "document.querySelector('.modal').style.display = 'none';"). The shortcut is added to the list. Click the On/Off toggle next to any shortcut to enable or disable it without deleting it. Click the ✕ button to delete a shortcut. The shortcuts are automatically saved and active across page loads.

REAL MECHANISM — WHY THIS WORKS

Most keyboard shortcut tools require browser extensions with broad permissions or separate applications. Keyboard Shortcut Mapper uses a DOM-event-driven approach that captures keydown events and matches them against user-defined shortcuts. When a user records a shortcut, the tool listens for a keydown event and captures the modifier keys (Control, Shift, Alt, Meta) and the pressed key, normalizing them into a consistent format. The shortcut is stored as an array of key names. When a keydown event occurs, the tool checks if the current key combination matches any stored shortcut by comparing the pressed keys against each shortcut's keys array. If a match is found and the shortcut is enabled, the tool executes the associated action. For "clickSelector," it uses document.querySelector to find the element and calls click(). For "javascript," it uses the Function constructor to execute the code safely. The tool prevents default behavior and stops propagation for matched shortcuts to avoid conflicts with page shortcuts. This approach ensures fast, reliable, and fully private keyboard shortcut mapping without requiring any external services or network access.

THE PANEL

The floating panel is fully draggable and remembers its position per site, snapping to the edges of the viewport when dragged near them. You can collapse the panel to a small icon to minimize screen distraction and expand it back with a single click. The panel is resizable from the bottom-right corner, giving you more space to view shortcuts and controls. Press the Escape key to close the panel instantly. The panel remains open across page navigation within the same domain, maintaining your current view state. All preferences—panel position and all shortcut data—are saved per domain for a seamless experience.

PLEASE NOTE

Keyboard Shortcut Mapper requires the free BotGentz extension to be installed and enabled, as it relies on the cross-extension messaging API provided by BotGentz for DOM access permissions. The tool captures keydown events on the page; shortcuts may conflict with existing page shortcuts or browser shortcuts. The "Run JavaScript" action executes code in the page context and can be used for automation, but careful with security—only use trusted code. The tool does not support complex key combinations or multi-key sequences. All shortcut data is stored locally in your browser using GM_setValue. No shortcut data, page content, or usage information is ever sent to any server. The extension does not read, store, or transmit any personal information. It only captures keyboard events and executes actions at your request.