dhsathiya / UMacro

UMacro is a CLI tool to use a keyboard as a macro keyboard.

UMacro

No need to grow plants in old keyboards anymore.

UMacro is cli tool to use a keyboard as macro keyboard.

Functions

1. Execute script
2. Execute a single command
3. Type string
4. Send keystroke
5. Copy to clipboard (selected text)
6. Paste
7. Terminal paste

Commands

Installation

wget -q -O - https://raw.githubusercontent.com/dhsathiya/umacro/master/setup.sh | sudo bash

Running

1. Run following command:

   sudo umacro

2. Select the device from the list.

Termination

sudo umacro terminate

Check key code

sudo umacro check-key

Configuration

Configuration file: /etc/umacro/umacro_conf.yml

Example Configuration

Syntax:

KEY_CODE: "FUNCTION 'ARGUMENT'"

Functions:

1. execute_shell

   • Executes a bash script.

2. execute

   • Executes a command.

3. typeto

   • Types string.

4. keystroke

   • Sends keystroke.
   • Multiple keys can be combined with +.

5. copy_to_clipboard

   • Store the selected element to a hotkey. Which later can be used by clicking the hotkey again and then paste.
   • Currently only supports standard numeric keys(top 1-0 keys).

6. paste

   • Simple paste: ctrl + v

7. term_paste

   • Paste for terminal: ctrl + shift + v

Dependency

xdotool for better support on special characters. Also works without it.

ToDo

1. Fix dirty code.
2. Multiple keyboard/input-device support.
3. Add keyboard modes.
4. Multi-key shortcut support. There's a long list...