https://github.com/ir33k/tb-keycast
Emacs keycast minor mode that shows pressed keys in tab bar line.
https://github.com/ir33k/tb-keycast
emacs emacs-lisp
Last synced: about 2 months ago
JSON representation
Emacs keycast minor mode that shows pressed keys in tab bar line.
- Host: GitHub
- URL: https://github.com/ir33k/tb-keycast
- Owner: ir33k
- License: gpl-3.0
- Created: 2022-01-20T20:45:34.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2022-01-30T15:51:41.000Z (over 3 years ago)
- Last Synced: 2025-03-29T06:11:27.212Z (2 months ago)
- Topics: emacs, emacs-lisp
- Language: Emacs Lisp
- Homepage:
- Size: 1.54 MB
- Stars: 20
- Watchers: 3
- Forks: 1
- Open Issues: 5
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Emacs Tab Bar Keycast
Emacs global minor mode showing last pressed key with corresponding
function name and repeat counter in `tab-bar-mode` line. Ignore
typing, mouse drag, none key related minibuffer commands and other
random undefined bindings.
Can be aligned to the right (default) or left side of `tab-bar-mode`
line free space (after tabs). Tabs may be hidden so you don't have to
use them to have `tb-keycast` status enabled.
**Emacs 29.1 is required.**
See [examples.el](./examples.el) file used in [demo.gif](demo.gif) to
learn about customizations. Read variables documentation with `C-h v`
to learn more or use `M-x customize-grouptb-keycast` to
customize using GUI interface.
## Installation and usage
Get `tb-keycast.el` file.
```shell
# You can clone entire repo
git clone [email protected]:ir33k/tb-keycast.git
# Or just get the file with one of those:
wget https://raw.githubusercontent.com/ir33k/tb-keycast/master/tb-keycast.el
curl -O https://raw.githubusercontent.com/ir33k/tb-keycast/master/tb-keycast.el
```
Use `M-x load-filepath_to/tb-keycast.el` or load with code:
```elisp
;; Put tb-keycast.el file to one of `load-path' dirs or add new path
;; to tb-keycast.el file in `load-path' list so Emacs know how to find
;; `tb-keycast' library.
(add-to-list 'load-path "~/path_dir_with_file")
;; Load with require or type: M-x load-librarytb-keycast.
(require 'tb-keycast)
```
Toggle with `M-x tb-keycast-mode`.
## Note
- Tested only on Emacs 29.0.
- Counter does not work for `C-k (kill-line)`.
- Big thanks to thuna\` from #emacs@libera for help with
`tb-keycast-format` type description.