Skip to content

Repository files navigation

Auto Clicker

A Chrome extension for automating repetitive clicks on web pages. Built for tasks like clearing Gmail's promotions tab, where the same sequence of clicks repeats hundreds of times.

Features

  • Visual element selection — hover any element on a page; ESC to cancel.
  • Right-click → Add to Auto Clicker — pick a target without entering selection mode.
  • Two modes:
    • Independent — each clicker runs on its own interval.
    • Sequential (chain) — clickers run in order, with a delay between each step. Each step waits up to 10s for its element to appear before moving on.
  • Robust click simulation — dispatches the full pointer + mouse + keyboard event sequence (Pointer/Mouse events, native click(), and Space/Enter for ARIA role="checkbox" / role="button"). Designed to work with Gmail, React apps, and other frameworks that ignore plain el.click().
  • Smart targeting — automatically retargets to the closest interactive ancestor (e.g. clicking an inner <span> redirects to its <button> parent).
  • Side panel UI — stays open during element selection (so the panel never closes mid-pick).
  • Debug console — every click attempt, success, failure, and chain step is logged with timestamps.

Install (development)

  1. Clone this repo.
  2. Open chrome://extensions.
  3. Enable Developer mode (top right).
  4. Click Load unpacked and select the project folder.
  5. Pin the extension; click the icon to open the side panel.

Usage

  1. Open the side panel on the page you want to automate.
  2. Click Select Element on a clicker, then click the target on the page. (Or right-click anywhere on the page → Add to Auto Clicker → assign to a clicker.)
  3. Set a delay (ms) and either start the clicker (independent mode) or add more clickers and Start Chain (sequential mode).

Permissions

Permission Why
activeTab Inject the click logic into the tab you're using.
scripting Inject the content script on demand.
sidePanel Host the UI without popups closing on click.
contextMenus Right-click → Add to Auto Clicker.
<all_urls> The user picks the page to automate; can be any URL.

The extension does not collect, store, or transmit any data.

License

MIT

About

autoclicker for chrome

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages