/BlinkSafari

Primary LanguageJavaScriptMIT LicenseMIT

BlinkSafari Chrome Extension

BlinkSafari is a Chrome extension that enables eye-controlled scrolling, allowing users to scroll web pages simply by blinking their eyes. With the help of WebGazer.js, this extension tracks eye movements through the webcam and translates them into scrolling actions. Say goodbye to traditional scrolling methods and embrace a new, intuitive way to navigate web content.

Features

  • Eye-controlled scrolling: Scroll web pages effortlessly by blinking your eyes.
  • Smooth scrolling: Enjoy a seamless scrolling experience with smooth transitions.
  • Customizable sensitivity: Adjust the sensitivity of eye tracking to match your comfort and eye movement patterns.
  • On-screen feedback: Get visual cues and indicators to understand where your focus is on the web page.
  • Temporary disablement: Temporarily disable eye-controlled scrolling for situations when you need to read or interact with specific content without unintentional scrolling.

Installation

To install the BlinkSafari Chrome extension, follow these steps:

Node version 16.20.1
Yarn version 1.22.19
  1. Clone this repository or download the source code as a ZIP file and extract it.
  2. Open Google Chrome and navigate to chrome://extensions.
  3. Enable the "Developer mode" toggle on the top right corner of the page.
  4. Click on "Load unpacked" and select the folder containing the extracted source code.
  5. The BlinkSafari extension should now be installed and ready to use.

Usage

  1. Make sure your webcam is connected and accessible by the Chrome browser.
  2. Navigate to any web page you want to scroll.
  3. Calibrate the eye tracking by following the on-screen instructions.
  4. Once calibration is complete, blink your eyes to initiate scrolling.
  5. Adjust the sensitivity settings if needed to match your eye movement patterns.
  6. Enjoy the eye-controlled scrolling experience! Blink to scroll up or down.

Settings

The BlinkSafari extension offers customizable settings to enhance your scrolling experience:

  • Sensitivity: Adjust the sensitivity of eye tracking to control the scrolling responsiveness. Higher sensitivity means even slight eye movements will trigger scrolling, while lower sensitivity requires more pronounced eye movements.
  • Smooth Scrolling: Enable or disable smooth scrolling to control the transition speed when scrolling.
  • On-screen Feedback: Toggle on/off the visual feedback indicators that highlight the area of focus on the web page.
  • Disable Blink Scroll: Temporarily disable eye-controlled scrolling with a single click. Useful when you need to perform other tasks without triggering unintentional scrolling.

Contributions

Contributions to BlinkSafari are welcome! If you encounter any bugs, have suggestions for new features, or would like to contribute improvements to the codebase, please follow these steps:

  1. Fork the repository.
  2. Create a new branch for your contribution: git checkout -b feature/your-feature-name.
  3. Commit your changes: git commit -m 'Add some feature'.
  4. Push the branch to your forked repository: git push origin feature/your-feature-name.
  5. Open a pull request with a detailed description of your changes.

License

The BlinkSafari Chrome extension is licensed under the MIT License.

Disclaimer

BlinkSafari is an experimental extension built for demonstration purposes. It may not be suitable for all users or environments. Use it responsibly and ensure your privacy and safety while using the extension.

Contact

If you have any questions, suggestions, or feedback, feel free to reach out to the BlinkSafari team at your-email@example.com.

Happy Blink Scrolling!