An umbrella package to support a single installation point for all Casual user interfaces for Emacs. These user interfaces built with Transient are included via the Elisp library header Package-Requires
. Included user interfaces are:
- Casual - A collection of Transient user interfaces for various built-in Emacs modes.
- Agenda - a Transient user interface for Org Agenda.
- Bookmarks - a Transient user interface for the bookmark list.
- Calc - a Transient user interface for Calc.
- Dired - a Transient user interface for the Dired file manager.
- EditKit - a Transient user interface library for Emacs editing commands.
- IBuffer - a Transient user interface for IBuffer.
- Info - a Transient user interface for Info.
- I-Search - a Transient menu for I-Search.
- RE-Builder - a Transient user interface for RE-Builder.
- Casual Avy - a Transient user interface for Avy.
- Casual Symbol Overlay - a Transient user interface for Symbol Overlay.
Casual Suite requires usage of
- Emacs ≥ 29.1
- Avy ≥ 0.5.0
- Symbol Overlay ≥ 4.2
- Casual ≥ 2.0.0
Casual Suite has been verified with the following configuration.
- Emacs 29.4 (macOS 14.5, Ubuntu Linux 22.04.4 LTS)
As Casual Suite is new, we are looking for early adopters! Your feedback is welcome as it will likely impact Casual Suite’s evolution, particularly with regards to UI.
It is highly recommended that a deep reading of the install procedure for each user interface be done beforehand as each of them have their own recommended customizations to go alongside them. Such customizations ensure that you have the best experience with each user interface.
Casual Suite requires a recent installation of Transient 0.6.0+ from either ELPA or MELPA. If your version of Emacs is ≤ 30 but also includes Transient as a built-in package, you will need to set the customizable variable package-install-upgrade-built-in
to t
to enable updating it via package.el
. Set this variable and proceed with installing Casual. Alternately invoking package-install
with a prefix (C-u
) will temporarily coerce the update of dependent built-in packages (example: C-u M-x package-install
casual
).
As Transient is closely tied to Magit, installing the latest version of Magit (via non-GNU ELPA or MELPA) before installing Casual Suite can also pick up the latest version of Transient.
Impatient readers can use the following code to put into their Emacs initialization file to immediately use Casual Suite.
The following lines illustrate an installation of the Casual Suite with no customization. The key bindings shown below are suggested but can always be changed to preference.
(require 'casual-suite)
(keymap-set calc-mode-map "C-o" #'casual-calc-tmenu)
(keymap-set dired-mode-map "C-o" #'casual-dired-tmenu)
(keymap-set isearch-mode-map "C-o" #'casual-isearch-tmenu)
(keymap-set ibuffer-mode-map "C-o" #'casual-ibuffer-tmenu)
(keymap-set ibuffer-mode-map "F" #'casual-ibuffer-filter-tmenu)
(keymap-set ibuffer-mode-map "s" #'casual-ibuffer-sortby-tmenu)
(keymap-set Info-mode-map "C-o" #'casual-info-tmenu)
(keymap-set reb-mode-map "C-o" #'casual-re-builder-tmenu)
(keymap-set reb-lisp-mode-map "C-o" #'casual-re-builder-tmenu)
(keymap-set bookmark-bmenu-mode-map "C-o" #'casual-bookmarks-tmenu)
(keymap-set org-agenda-mode-map "C-o" #'casual-agenda-tmenu)
(keymap-global-set "M-g" #'casual-avy-tmenu)
(keymap-set symbol-overlay-map "C-o" #'casual-symbol-overlay-tmenu)
(keymap-global-set "C-o" #'casual-editkit-main-tmenu)
If you enjoy using Casual Suite, consider making a modest financial contribution to help support its development and maintenance.
A heartfelt thanks to all the contributors to Calc, Dired, Info, I-Search, Info, IBuffer, RE-Builder, Bookmarks, Avy, and Transient. Casual Suite would not be possible without your efforts.