sendkeys-macos

SendKeys for macOS

This is a CLI tool to send keys to a given app to simulate typing at a given speed.

This tool was originally created to make it easier to enter keystrokes for a smooth screen recording of code being typed in.

Installation

npm install sendkeys-macos --global

CLI usage

Basic usage:

sendkeys -a "Notes" -c "Hello<p:1> world<c:left:option,shift><c:i:command>"

Providing input from a file:

sendkeys -a "Visual Studio Code" -f example.txt

Receiving input from stdio:

cat example.txt | sendkeys -a "Notes"

Refer to the help command for more options:

sendkeys --help

Node usage

Programatic usage:

const sendKeys = require('sendkeys-macos');

sendKeys('Notes', 'hello<c:a:command><c:c:command><c:right> <c:v:command>', { delay: 0.1, initialDelay: 1 });

Markup instructions

Basic markup is supported to control the pause between keystrokes and to apply additional keystroke combinations.

Inserting a pause

A pause can be inserted with the <p:seconds> sequence.

By default, the delay between keystrokes is set with the -d or --delay option where the default is 0.1 seconds. A one-off pause of 1 second can be applied between characters by inserting <p:1>.

<P:seconds> (note upper case P) can be used to modify the default delay between subsequent keystrokes.

Special key combinations

Special key combinations including non-printable character sequences can be applied using the <c:key> or <c:key:modifiers> markup.

key can include any printable character or, one of the following key names: f1, f2, f3, f4, f5, f6, f7, f8, f9, f10, f11, f12, esc, return, enter, delete, space, tab, up, down, left, right, home, end, pgup, and pgdown.

modifiers is an optional list of comma separated values that can include command, shift, control, and option.

Example key combinations:

• tab: <c:tab>
• command + a: <c:a:command>
• option + shift + left arrow: <c:left:option,shift>

Continuation

A continuation can be used to ignore the next character. This is useful to help with formatting a long sequence of character and inserting a new line for authoring purposes.

Insert a continuation using the character sequence <\>. The character following the sequence will be skipped over.

Prerequisites

This script only works on macOS as it has a dependency on the macOS Automator application.

When running from the terminal, ensure that the terminal has permissions to send keystrokes. This can be done by navigating to System Preferences > Security & Privacy > Privacy > Accessibility and adding your terminal application there.

Changelog

1.2.0 (2020-12-24)

Features

• add experimental support for mouse movements (7f5b93f)

1.1.2 (2020-09-22)

Bug Fixes

• exclude tests from npm package (7b6f073)

1.1.1 (2020-09-22)

Bug Fixes

• exclude images from npm package (35bdb70)