Peepbo 🫣

A lightweight, Node.js + TypeScript automation tool for Linux. Control your mouse, keyboard, and screenshots programmatically.

View on GitHubView on NPM

See

Capture screenshots using scrot, gnome-screenshot, imagemagick, or gdbus for Wayland.

Click

Programmatically move the mouse and perform clicks using xdotool.

Type

Type text and press key combinations to interact with applications.

Linux Native

Optimized for Linux environments, supporting both X11 and Wayland (with configuration).

Installation

Install globally via npm:

npm install -g peepbo

Or verify requirements:

peepbo verify

Simple to Use

Capture Screenshot

peepbo image --output capture.png

Click Coordinates

peepbo click --x 500 --y 300

Type Text

peepbo type "Hello World"

Key Combinations

peepbo key "ctrl+c"