# octalmage/robotjs

Node.js Desktop Automation.

Repository: https://github.com/octalmage/robotjs
Canonical: https://ross.abutalabs.com/products/robotjs
Homepage: http://robotjs.dev
Language: C
License: MIT
License Family: permissive
Last push: 2026-08-07T09:32:11+00:00

## Health v2 (maintenance only)
Score: 93/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 96, release rhythm 84, longevity 100
- inputs: {"age_days": 4385, "days_push": 26, "days_rel": 26, "gap_med": 35.5, "n_releases_24m": 5}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 12770, forks 1003 (observed 2026-08-28T04:10:59.738422+00:00)

## What it is
RobotJS is a Node.js desktop automation library for controlling the mouse and keyboard and reading the screen, with native prebuilt binaries for Mac, Windows, and Linux. Version 0.8 adds image and color search, BMP/PNG handling, and multi-monitor display-aware capture.

## Use cases
- automate mouse clicks and keyboard input from node
- write desktop ui automation scripts
- capture the screen and find images or colors
- build a bot that types strings and presses keys
- automate repetitive tasks on mac windows and linux
- read pixel colors under the mouse
- create electron apps that control the desktop

## When to choose
- you need cross-platform desktop automation from Node.js or Electron
- you want prebuilt binaries without compiling native code
- you need screen capture with image or color matching for UI automation

## When to avoid
- you need browser-only automation (use Puppeteer or Playwright)
- you need a stable 1.0 API - the project is still pre-1.0 and APIs may change
- you need mobile or headless-server automation

## Facets
- artifact type: library
- maturity: active
- function: workflow-automation, gui, image-processing, computer-vision, developer-tools
- domain: desktop-applications, cross-platform, developer-tools
- platform: windows, cross-platform
- tags: desktop-automation, mouse-control, keyboard-control, screen-capture, image-search, rpa, native-addon, automation, nodejs, macos, linux, electron

## Member repositories
- octalmage/robotjs (main) score 93

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:10:59.738422+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-29T17:13:48.539986+00:00, confidence not recorded.
  - readme: https://github.com/octalmage/robotjs (fetched 2026-08-28T04:10:59.738422+00:00, sha a1603449d9e2)
  - homepage: http://robotjs.dev (fetched 2026-08-29T08:09:57.110563+00:00, sha 81dc38ac956e)
  - site_page: http://robotjs.dev/docs (fetched 2026-08-29T08:09:57.117192+00:00, sha 7e31c233bdc6)
- Data as of 2026-08-30T08:39:29.467469+00:00.