Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/slotthe/hmenu
Dmenu wrapper for fun and profit! // GitHub Mirror
https://github.com/slotthe/hmenu
dmenu haskell yeganesh
Last synced: 2 months ago
JSON representation
Dmenu wrapper for fun and profit! // GitHub Mirror
- Host: GitHub
- URL: https://github.com/slotthe/hmenu
- Owner: slotThe
- License: gpl-3.0
- Created: 2022-02-09T07:30:48.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2024-07-13T20:34:33.000Z (5 months ago)
- Last Synced: 2024-09-14T11:58:31.413Z (3 months ago)
- Topics: dmenu, haskell, yeganesh
- Language: Haskell
- Homepage: https://gitlab.com/slotThe/hmenu
- Size: 160 KB
- Stars: 4
- Watchers: 3
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- License: LICENSE
Awesome Lists containing this project
README
# 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
``` toml
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:
``` toml
# 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
``` toml
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`.
[TOML]: https://github.com/toml-lang/toml