{"id":13341369,"url":"https://github.com/aaronamk/hkd","last_synced_at":"2025-03-11T21:30:46.765Z","repository":{"id":58104754,"uuid":"393477213","full_name":"aaronamk/hkd","owner":"aaronamk","description":"Display-Server-Agnostic Hotkey Daemon for Linux","archived":false,"fork":false,"pushed_at":"2022-09-23T03:13:54.000Z","size":56,"stargazers_count":23,"open_issues_count":4,"forks_count":2,"subscribers_count":4,"default_branch":"main","last_synced_at":"2024-07-30T21:02:02.755Z","etag":null,"topics":["c","evdev","hotkey-daemon","hotkeys","linux","suckless","tty","wayland","xorg"],"latest_commit_sha":null,"homepage":"","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/aaronamk.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-08-06T19:09:13.000Z","updated_at":"2024-02-22T20:16:53.000Z","dependencies_parsed_at":"2023-01-18T18:45:12.982Z","dependency_job_id":null,"html_url":"https://github.com/aaronamk/hkd","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronamk%2Fhkd","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronamk%2Fhkd/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronamk%2Fhkd/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/aaronamk%2Fhkd/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/aaronamk","download_url":"https://codeload.github.com/aaronamk/hkd/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":221249547,"owners_count":16784961,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["c","evdev","hotkey-daemon","hotkeys","linux","suckless","tty","wayland","xorg"],"created_at":"2024-07-29T19:25:24.628Z","updated_at":"2024-10-23T23:31:03.456Z","avatar_url":"https://github.com/aaronamk.png","language":"C","funding_links":[],"categories":[],"sub_categories":[],"readme":"## DESCRIPTION\nA key mapper program.\n\nFeatures:\n* Map a key plus any number of modifiers to a command\n* Map a modifier release to a command\n* Configure which keys to use as modifiers\n* Works in Xorg, Wayland, and the TTY (using [libevdev](https://www.freedesktop.org/software/libevdev/doc/latest/index.html))\n\n## INSTALLATION\n### From source\n1. Run:\n```\ngit clone https://github.com/aaronamk/hkd.git\ncd hkd\nsudo make install\n```\n2. Add yourself to the `input` group: `sudo usermod -a -G input \u003cusername\u003e`. This allows hkd to access/modify input devices in the filesystem without root access.\n3. Reboot for the change to take affect\n\n## CONFIGURATION\nThe file `config.h` is where you set your key bindings. This is similar to [suckless](https://suckless.org/philosophy)'s software practices. `config.h` is part of the source, so you must recompile and restart the program for any changes to take effect. Some default bindings are provided; you can add or remove them as needed.\n\nSee [linux/input-event-codes.h](https://github.com/torvalds/linux/blob/master/include/uapi/linux/input-event-codes.h) for a list of available key codes or use the [evtest](https://gitlab.freedesktop.org/libevdev/evtest) command to see device events printed to the terminal.\n\n## USAGE\n```\nhkd /dev/input/by-id/\u003cdevice-id-1\u003e /dev/input/by-id/\u003cdevice-id-2\u003e ...\n```\n\n## RELATED/SIMILAR SOFTWARE\n* [swhkd](https://github.com/waycrate/swhkd)\n* [Interception Tools](https://gitlab.com/interception/linux/tools)\n---\n\n*NOTICE*: Please check the issues board if you find a bug or would like a feature added. Open a new issue if it is not listed.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronamk%2Fhkd","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Faaronamk%2Fhkd","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Faaronamk%2Fhkd/lists"}