#macos #command #hotkey #extensible #daemon #modifiers #heimdall

bin+lib heimdall-cli

A simple hotkey deamon. Primarly tested on MacOS

9 releases

0.1.9 May 4, 2024
0.1.8 Apr 29, 2024
0.1.7 Dec 28, 2023
0.1.3 Nov 26, 2023

#285 in Hardware support

Download history 9/week @ 2024-02-25 51/week @ 2024-03-31 286/week @ 2024-04-28 36/week @ 2024-05-05

322 downloads per month

MIT license

14KB
195 lines

Heimdall

Note: This project is a WIP, and the following docs may be uncomplete.

Features:

  • An extensible hotkey daemon which supports multiple modifiers, and custom commands.

Installation

To get started, simply clone the whole repository, and build it with Rust:

$ cargo install heimdall-cli

Getting started

To get started with Heimdall, follow these steps:

  1. Create a config file with the path $XDG_CONFIG_HOME/heimdall/config.toml The config file has the following format:
    [[bindings]]
    key = "C"
    modifiers = ["Ctrl", "Shift"]
    command = "echo hello"
    [[bindings]]
    key = "D"
    modifiers = ["Ctrl"]
    command = "osascript -e 'display notification  with title \"Hello 👋!\" subtitle \"Hello from Heimdall 😊\" sound name \"Crystal\"'"
    

2. Start heimdall with the `heim` command. If you want to start the service
    $ heim --start-service


Dependencies

~9–24MB
~360K SLoC