Skip to content

An accessibility-focused browser extension, inclusively designed for visually impaired users, that enables them to define custom keyboard shortcuts for any clickable button or element on any webpage.

Notifications You must be signed in to change notification settings

zendalona/z.WebKeyBind

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

19 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

z.WebKeyBind

z.WebKeyBind is a browser extension designed for accessibility and productivity.
It empowers users—especially those with visual impairments—to assign custom keyboard shortcuts to any clickable element (buttons, links, inputs) on any website. Instead of tabbing through dozens of elements, users can simply press a predefined key to trigger an action instantly.


🌟 Key Features

  • Custom Shortcuts
    Map any alphanumeric key (A–Z, 0–9) to a website element.
  • Intelligent Healing
    If a website updates its layout, the extension uses a Robust Profile (ARIA labels, text content, and CSS paths) to automatically find and heal the connection to your button.
  • Accessibility First
    Fully optimized for screen readers like NVDA and JAWS, with built-in ARIA-live announcements.
  • Multi-Language Support
    UI and voice announcements available in:
    • English
    • हिंदी
    • मराठी
    • മലയാളം
  • Site-Specific Logic
    Shortcuts are saved per website, preventing conflicts between different pages.
  • Cross-Browser Ready
    Compatible with Google Chrome and Mozilla Firefox.

🚀 Getting Started

Installation

  1. Download or clone this repository.

Chrome

  1. Open chrome://extensions
  2. Enable Developer mode
  3. Click Load unpacked
  4. Select the extension folder

Microsoft edge

  1. Open edge://extensions
  2. Enable Developer mode
  3. Click Load unpacked
  4. Select the extension folder

Firefox

  1. Open about:debugging#/runtime/this-firefox
  2. Click Load Temporary Add-on
  3. Select the manifest.json file

🛠 How to Use

1. Opening the Interface

  • Chrome: Alt + Shift + S
  • Firefox: Alt + Shift + E

2. Creating a Shortcut

🖱 Mouse Mode (Alt + Shift + M)

  1. Hover over the button you want to automate.
  2. Click the button to lock it (highlight turns orange).
  3. Press any key (e.g., B for Buy) to save the shortcut.

⌨ Keyboard Mode (Alt + Shift + K)

  1. Use the Tab key to navigate to the desired element.
  2. Press a key to save the shortcut.

3. Executing Shortcuts

Once saved, simply press: Alt + [Your Key]

while on the website to trigger the associated action.


4. Audio Guide

Press: Alt + Shift + A

The extension will read aloud all saved shortcuts for the current website.


♿ Accessibility Commitment

z.WebKeyBind is built with accessibility at its core and follows best practices for assistive technologies, ensuring an inclusive browsing experience for all users.


🌐 Supported Browsers

  • Google Chrome
  • Mozilla Firefox
  • Microsoft edge
  • Safari

About

An accessibility-focused browser extension, inclusively designed for visually impaired users, that enables them to define custom keyboard shortcuts for any clickable button or element on any webpage.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 3

  •  
  •  
  •