Skip to content

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

License

Notifications You must be signed in to change notification settings

dhsathiya/UMacro

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

UMacro Generic badge Open Source Love svg2

License Made With Python Tested On Ubuntu 20.04

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...