aboutsummaryrefslogtreecommitdiff
path: root/README.md
blob: b1b727e523c45acf4c59ca234f3886adad345655 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# Readme for keyboard-leds-trayicons

This tool, written in POSIX shell, places two icons in the notification area (aka system tray), that substitute for the keyboard LEDs for Capslock and Numlock.

## How to configure
You can set environment variable `KLT_CONF` to point to a config file, which gets loaded in a style similar to dot-sourcing a shell script. Existing environment variables will be preserved. `Keyboard-leds-trayicons` will already load the global values from `/etc/keyboard-leds-trayicons.conf` and from your user settings in `$HOME/.config/keyboard-leds-trayicons.conf`.

Here is example config file.

    KLT_CAPS_ON_ICON=capslock-on
    KLT_CAPS_OFF_ICON=capslock-off
    KLT_NUM_ON_ICON=numlock-on
    KLT_NUM_OFF_ICON=numlock-off

As a side effect of using `mktrayicon`, you can use an icon name that follows the [xdg spec](https://www.freedesktop.org/wiki/Specifications/icon-theme-spec/) or you can point to a specific filename. This project includes some simple letter icons in svg format.

## Project license
[CC-BY-SA 4.0](https://creativecommons.org/licenses/by-sa/4.0/)

## Dependencies
Package manager | packages
--------------- | ------------------------------------------------------------------
binary name     | [mktrayicon](https://gitlab.com/bgstack15/mktrayicon), awk, xset
deb             | [mktrayicon](https://build.opensuse.org/package/show/home:bgstack15/mktrayicon), mawk | gawk, x11-xserver-utils
rpm             | undefined

## Credits
Bundled icons are used under license from Icon8.
* little `c`: [https://visualpharm.com/free-icons/c%20letter-595b40b65ba036ed117d1027](https://visualpharm.com/free-icons/c%20letter-595b40b65ba036ed117d1027)
* License for icons: Use for free, but link to [icons8](https://icons8.com/license)
bgstack15