1 unstable release

0.1.0 Jun 13, 2020

#29 in #keyboard-layout

GPL-3.0 license

19KB
428 lines

alt

alt is an extension to ktrl. It listens to system events such as window-focus changes, Emacs hooks, etc... These events are aggregated and sent over to ktrl via its ipc interface.

Usage

alt 0.1
Itay G. <thifixp@gmail.com>
An Event Aggregator for ktrl

USAGE:
    alt [FLAGS] [OPTIONS]

FLAGS:
        --debug      Enables debug level logging
    -h, --help       Prints help information
    -V, --version    Prints version information

OPTIONS:
        --cfg <CONFIG>     Path to your alt config file. Default: .alt.ron
        --log <LOGFILE>    Path to the log file. Default: .alt.log```

Install

  • Install alt
cargo install --path .
  • Setup your ~/.alt.ron file (See my example below).
  • Add this to your window manager autostart (ex: i3) -
exec ~/.cargo/bin/alt

Configuration

The default config file path is ~/.alt.ron. You can override this with the --cfg cli argument.

Example

(
  aggs: [
  // Ivy Event Aggregator
    (requirements: [
        RqFocus("emacs"),
        RqExtEvent("ivy"),
    ],
    on_ipc: "TurnOnLayerAlias(\"ivy\")",
    off_ipc: "TurnOffLayerAlias(\"ivy\")"),
  ],
)

This will toggle the ivy ktrl layer when Emacs is in foucs AND ivy is active

Dependencies

~8–18MB
~221K SLoC