Macro-Manager

Searches and executes a script that is associated with the given ID and SET for the active application.

If the current current executable isn't configured or a fallback is allowed for the current set it will try to use the default as fallback if available.

If the script config says the current script is switchable it will stop already running instance of that script or otherwise start a new one. This is intended for turning infinite running scripts on and off.

Make sure your script is marked as executable.

• Config file location: $XDG_CONFIG_HOME/macro-manager/config.toml
• Script search location: $XDG_DATA_HOME/macro-manager/

It exposes the following environment variables to called scripts when optional dependencies are available:

MACRO_MANAGER_WINDOW
MACRO_MANAGER_WINDOW_BIN
MACRO_MANAGER_WINDOW_PID
MACRO_MANAGER_WINDOW_WIDTH
MACRO_MANAGER_WINDOW_HEIGHT
MACRO_MANAGER_MOUSE_X        // Only on X11
MACRO_MANAGER_MOUSE_Y        // Only on X11
MACRO_MANAGER_MOUSE_SCREEN   // Only on X11

• On X11 xdotool will request the information.
• On Gnome Wayland the extension Window Calls will request the information. dbus is required for this.

Installation

Build with make build or directly with cargo build --release.
The executable is in target/release/macro-manager.

Install with make install.
Adjust PREFIX and DESTDIR as needed.

By default the library libmacro_manager.so will be installed which exposes the Manager::new() object together with get_macro(set: String, id: String). The Macro object runs with the run() method.

Example config

[default.set1.id3]
script = ["autoclicker.sh"]
toggle = true

["program.exe".set1]
default_fallback = true

["program.exe".set1.id8]
script = ["awesome_script1.sh"]

[firefox.m1]
g13.script = ["awesome_script2.sh", "arg1", "arg2"]
g14 = { script = ["subfolder/awesome_script3.sh"], toggle = true }

Example scripts

Generic dotool wrapper

#!/bin/bash

echo "$@" | dotoolc

# example config:
# [default.m1]
# g3.script = ["general/dotool.sh", "mousemove", "0", "-1"] # mouse 1px up

Autoclicker

#!/bin/bash
# using https://sr.ht/~geb/dotool/

# define signal handler
term_handler() {
    sleep 0.5
    echo buttonup left | dotoolc
    exit 0
}

# register signal handler
trap term_handler SIGTERM

while true; do
    {
        echo buttondown left
        sleep 0.021
        echo buttonup left
        sleep 0.021
    } | dotoolc
done

Emergency script - close all currently running scripts

#!/bin/sh

find "$XDG_RUNTIME_DIR/macro-manager" -name "*.pid" -exec pkill -TERM -F {} \; -exec rm {} \;