JSAutoGUI is an npm package for node.js. Inspired by pyautogui from python. (but noticably faster and better)
npm install jsautoguijsautogui to your project by typing this in your terminal:
shell
sudo apt-get install -y libxtst-dev libx11-dev
`
Windows Dependencies:
If you are on Windows, you need the build tools to compile the C++ addon.
1. Download and
install Visual Studio Build Tools.
2. During installation, ensure you select the "Desktop development with C++" workload.
Install Package:
`shell
npm install jsautogui
`
After this, you can start using the package by importing it:
`js
import jsautogui from "jsautogui"; // in modulejs
// or
const jsautogui = require("jsautogui"); // in commonjs
`
$3
---
How to contribute/fork/edit?
This project mixes C++ (for native system calls) and TypeScript (for the Node.js interface).
$3
Clone the project and install dependencies:
`bash
git clone https://github.com/OguzhanUmutlu/jsautogui.git
cd jsautogui
npm install
`
$3
This project is configured to work seamlessly with CLion for both C++ and TypeScript development.
1. Open the jsautogui folder in CLion.
2. C++: CLion will detect the CMakeLists.txt file automatically. This provides full IntelliSense for the native
code in src/.
3. TypeScript: You can edit index.ts directly. CLion uses the included tsconfig.json to handle syntax
highlighting and errors.
$3
Since this project uses TypeScript, you need to compile the TS files and build the C++ addon. I have set up a script
to handle this automatically:
`bash
Compiles TypeScript and rebuilds the C++ addon
npm run build
`
---
Testing
To ensure your changes work as expected, you can use the built-in test scripts defined in package.json.
Run tests (fast):
If you have already built the project and just changed the test logic:
`bash
npm run test
`
Build & Run tests (full):
If you have modified C++ or TypeScript source code and want to verify everything:
`bash
npm run test-build
``