README.md

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 file used in demo.gif to learn about customizations. Read variables documentation with C-h v to learn more or use M-x customize-group<RET>tb-keycast<RET> to customize using GUI interface.

Installation and usage

Get tb-keycast.el file.

# You can clone entire repo
git clone git@github.com: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-file<RET>path_to/tb-keycast.el<RET> or load with code:

;; 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-library<RET>tb-keycast<RET>.
(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.