@hackage hdmenu0.3.0

A small wrapper around dmenu

hdmenu

hdmenu is a small wrapper around dmenu—it can't do very much, though I guess that's the point. It might be most notable for being a discount yeganesh.

Features

  1. Display commands in order of usage and, optionally, apply a frequency decay every time an item is selected.
  2. Specify extra files to consider, which will be opened by a program of your choice (e.g., xdg-open).
  3. Open certain executables inside of your terminal.

Configuration

Hdmenu is configured using a TOML file inside the $XDG_CONFIG_HOME/hdmenu directory (probably ~/.config/hdmenu). See example.toml for an example configuration.

Note that, while having a config file is optional, the $XDG_CONFIG_HOME/hdmenu directory will be created in either case, in order to store the history file there.

Configuration option

The configuration file takes the following arguments:

  • open : A custom opening script (default: xdg-open).

  • files: Files one wishes to edit; they will be opened according to open. This can also take directories

    files = [ "~/.config/emacs/" ]
    

    in which case all files in that directory will be added to the list of files that hdmenu cares about. Directories can also be traversed recursively:

    # Files from `~/.config/emacs/' and all of its subdirectories.
    files = [ "~/.config/emacs/" ]
    
  • executable: Custom dmenu executable (default: dmenu).

  • terminal: A terminal emulator (default: xterm).

  • tty-programs: A list of programs to be opened in the above terminal emulator. For example, specifying

    tty-programs = [ "htop" ]
    

    will effectively enable one to start htop directly from dmenu without having to open an extraneous terminal.

  • decay: A frequency decay; all non-selected items will be multiplied by this number (default: 1). A good value may be something like 0.997

Command line options

  • --histFile

    • Short: -f
    • Description: Path to the history file to use.
  • --files-only

    • Short: -o
    • Description: Whether to only show the user-specified files.
  • --decay

    • Short: -d
    • Description: A frequency decay; all non-selected items will be multiplied by this

All options after -- will be directly forwarded to dmenu, so you may specify options in the following way:

hdmenu -f /path/to/file -- -i -f -nb '#282A36' -nf '#BBBBBB' -sb '#8BE9FD' -sf '#000000' -fn 'Inconsolata Regular-10'

Installation

Stack

Build with stack build, then copy the executable to a convenient location (or just use stack install, to copy the executable to the local-bin-path).

Cabal

Build with cabal install.