Skip to content

Casual Suite - An umbrella package to support a single install point for all Casual user interfaces.

License

Notifications You must be signed in to change notification settings

kickingvegas/casual-suite

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

87 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

https://melpa.org/packages/casual-suite-badge.svg

Casual Suite

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.

Requirements

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)

Asks

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.

Install

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.

A Note on Package Dependencies

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.

TL;DR

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)

Sponsorship

If you enjoy using Casual Suite, consider making a modest financial contribution to help support its development and maintenance.

docs/images/default-yellow.png

Acknowledgments

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.

About

Casual Suite - An umbrella package to support a single install point for all Casual user interfaces.

Resources

License

Stars

Watchers

Forks