agoramachina / swhkd

Sxhkd clone for Wayland (works on TYY and X11 too) | mirrored at https://git.sr.ht/~shinyzenith/swhkd

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

SWHKD

A next-generation hotkey daemon for Wayland/X11 written in Rust.

SWHKD

Simple Wayland HotKey Daemon

swhkd is a display protocol-independent hotkey daemon made in Rust. swhkd uses an easy-to-use configuration system inspired by sxhkd so you can easily add or remove hotkeys.

It also attempts to be a drop-in replacement for sxhkd, meaning, your sxhkd config file is also compatible with swhkd.

Because swhkd can be used anywhere, the same swhkd config can be used across Xorg or Wayland desktops, and you can even use swhkd in a tty.

Installation

See INSTALL.md for installing swhkd.

Note: swhks is not a typo, it is the server process of the program.

Running:

swhks &
pkexec swhkd

Runtime signals

After opening swhkd, you can control the program through signals:

  • sudo pkill -USR1 swhkd - Pause key checking
  • sudo pkill -USR2 swhkd - Resume key checking
  • sudo pkill -HUP swhkd - Reload config file
  • sudo pkill -INT swhkd - Pause key checking temporarily (resume by pressing super+shift+escape)

Configuration

Swhkd closely follows sxhkd syntax, so most existing sxhkd configs should be functional with swhkd.

The default configuration directory is /etc/swhkd/swhkdrc. If you don't like having to edit the file as root every single time, you can create a symlink from ~/.config/swhkd/swhkdrc to /etc/swhkd/swhkdrc.

Support server:

https://discord.gg/KKZRDYrRYW

Contributors:

About

Sxhkd clone for Wayland (works on TYY and X11 too) | mirrored at https://git.sr.ht/~shinyzenith/swhkd

License:BSD 2-Clause "Simplified" License


Languages

Language:Rust 95.0%Language:Shell 3.0%Language:Makefile 2.0%