Guacamole dotool

A command-line Guacamole client and TypeScript/JavaScript library for headless scripting. It’s exactly like vncdotool or xdotool, but over the Guacamole protocol.

Installation

On Alpine Linux

The guacamole-dotool package is currently available in the testing repository or in my backports for v3.18.

Using npm

npm install --global guacamole-dotool

Warning: The canvas package downloads pre-built native libraries (cairo, pango, libjpeg…) from npmjs.com by default. If you want to build it from source instead (highly recommended), use option --build-from-source. See node-canvas installation for details.

Usage

Command line

guacamole-dotool --url wss://example.org/guacamole -- \
  key Cmd+t pause 2 type 'echo "Hello, world!"' key Enter pause 0.5 capture screenshot.png

Run guacamole-dotool --help to learn more.

TypeScript / JavaScript

import { Client, setDomGlobals } from 'guacamole-dotool'

// Set canvas, jsdom and ws to the global context.
setDomGlobals()

// Connect to Guacamole via WebSocket.
const c = await Client.connect('wss://example.org/guacamole')

// Run commands...
await c.keysPress('Cmd', 't')
await c.pause(2)
await c.type('echo "Hello, world!"')
await c.keysPress('Enter')
await c.pause(0.5)
await c.captureScreenToFile('screenshot.png')

c.disconnect()

See src/client.ts to learn more.

License

This project is licensed under MIT License. For the full text of the license, see the LICENSE file.