https://github.com/fuco1/free-keys
Show free keybindings for modkeys or prefixes
https://github.com/fuco1/free-keys
Last synced: 5 months ago
JSON representation
Show free keybindings for modkeys or prefixes
- Host: GitHub
- URL: https://github.com/fuco1/free-keys
- Owner: Fuco1
- Created: 2013-11-03T14:26:45.000Z (over 12 years ago)
- Default Branch: master
- Last Pushed: 2025-05-12T15:27:51.000Z (about 1 year ago)
- Last Synced: 2025-07-09T17:05:28.788Z (12 months ago)
- Language: Emacs Lisp
- Size: 20.5 KB
- Stars: 112
- Watchers: 5
- Forks: 11
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# free-keys [](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=TAWNECQR3TTUY)
Show free bindings in current buffer. Based on https://gist.github.com/bjorne/3796607
To use, call the command `free-keys`. This package takes into account the major mode bindings as well as any bindings occupied by minor modes active in current buffer. If called with prefix argument `C-u`, you can specify a prefix map to be used, such as `C-c` or `C-c C-x` (these are specified as a string).
You can customize the variable `free-keys-modifiers` if you use non-standard modifiers, such as `H` for hyper, `s` for super or `S` for shift. By default this list contains `C`, `M`, `C-M` and no modifier.
You can customize the variable `free-keys-keys` if you use non-English keyboard layout and want to show free bindings for keys such as č, í, ö, è, å etc.
These bindings are available inside the `*Free keys*` buffer:
Key-binding | Description
-----------|---------------
`b` | Change the "active" buffer
`p` | Change the prefix
`q` | Quit
# Installation
The easiest way is to install this via `package.el` from MELPA repository. If you want to install manually, clone the git repo and add it to your `load-path`:
(add-to-list 'load-path "path-to-this-git-repo")
# See also
The [bind-key](https://github.com/jwiegley/use-package/blob/master/bind-key.el) package by @jwiegley does the "reverse thing", that is, it shows you what bindings you've already used and if you've shadowed some built-in bindings. I highly recommend using it in tandem with this package.