Emacs: Change Minor Mode Keys

By Xah Lee. Date: . Last updated: .

This page shows you how to change or remove minor mode keys.

To change minor mode keys, you need to change the mode's keymap.

Here's a simple example:

  ;; change isearch's keys to arrows
  (define-key isearch-mode-map (kbd "<up>") 'isearch-ring-retreat )
  (define-key isearch-mode-map (kbd "<down>") 'isearch-ring-advance )

  (define-key isearch-mode-map (kbd "<left>") 'isearch-repeat-backward)
  (define-key isearch-mode-map (kbd "<right>") 'isearch-repeat-forward)

General Steps

  1. Alt+x describe-function, then type the mode activation command name, then click on the link to open its elisp source code file.
  2. in the mode's source code, search for “-map” to find its keymap name. Let's say it's “xyz-map”.
  3. in the mode's source code, go all the way to bottom to find (provide 'xyz) if it exists. The “'xyz” would be the symbol for the mode.
  4. In your emacs init file, start with (require 'xyz) (if the mode has a symbol), then (define-key keymap_name (kbd "key") 'command_name)

Not all mode defines a keymap in its source file. Some inherit from other modes, some use keymaps from other elisp file that are not modes, some don't have keymaps.

When you redefine some keys in a mode's keymap, be sure to make keybinding for the displaced commands if you still want a key for them.

For example, in “shell-mode”, i wanted Alt+p to do something. The Alt+p is previous-history-element. I think that command is useful enough to have a hotkey. So, i defined some other key for that. (You can Alt+x describe-key to find out a key's binding while in that mode.)


Modify Isearch Keys

By default, 【Ctrl+s】 will do a interactive search. Pressing that again will find the next match. Suppose you prefer to have 【Alt+s】 instead, so in your emacs init file you defined:

(global-set-key (kbd "M-s") 'isearch-forward)
(global-set-key (kbd "M-S") 'isearch-backward)

You want to use “M-s” to repeat the search. However, once you are in the isearch prompt, technically it is a minor mode called isearch-mode. In isearch-mode, “C-s” is defined to run isearch-repeat-forward. You want “M-s” to run isearch-repeat-forward. Here's the code to reclaim it:

(define-key isearch-mode-map (kbd "M-s") 'isearch-repeat-forward)
(define-key isearch-mode-map (kbd "M-S") 'isearch-repeat-backward)

Modify Shell Keys

shell and shell-commandAlt+!】 have many special keys. Suppose you want to change them. They both use a keymap named comint-mode-map. The following is a example of redefining some of its keys.

  ;; "change keybindings for shell related modes."
   (define-key comint-mode-map (kbd "M-p") 'recenter) ; was comint-previous-input
   (define-key comint-mode-map (kbd "M-n") 'nil) ; was comint-next-input
   (define-key comint-mode-map (kbd "M-r") 'kill-word) ; was comint-previous-matching-input
   (define-key comint-mode-map (kbd "M-s") 'other-window) ; was comint-next-matching-input

   ;; rebind displaced commands that i still want a key
   (define-key comint-mode-map (kbd "<f11>") 'comint-previous-input)
   (define-key comint-mode-map (kbd "<f12>") 'comint-next-input)
   (define-key comint-mode-map (kbd "S-<f11>") 'comint-previous-matching-input)
   (define-key comint-mode-map (kbd "S-<f12>") 'comint-next-matching-input)

Modify Minibuffer Keys

The minibuffer is where emacs does prompts. It defines the following keys:


Here's a example of how to redefine its keybinding:

;; reclaim some bindings used in minibuffer for ergoemacs bindings for QWERTY
(define-key minibuffer-local-map (kbd "M-p") 'recenter) ; was previous-history-element. Use ↑ key or f11.
(define-key minibuffer-local-map (kbd "M-n") 'nil) ; was next-history-element. Use ↓ key or f12.

(define-key minibuffer-local-map (kbd "M-r") 'kill-word) ; was previous-matching-history-element.
(define-key minibuffer-local-map (kbd "M-s") 'other-window) ; was nest-matching-history-element

;; add back some bindings for commands whose binding we displaced
(define-key minibuffer-local-map (kbd "<f11>") 'previous-history-element)
(define-key minibuffer-local-map (kbd "<f12>") 'next-history-element)
(define-key minibuffer-local-map (kbd "S-<f11>") 'previous-matching-history-element)
(define-key minibuffer-local-map (kbd "S-<f12>") 'next-matching-history-element)

(info "(elisp) Text from Minibuffer")

Emacs Keybinding How-To

  1. How to Define Keys
  2. Change Major Mode Keys
  3. Change Minor Mode Keys
  4. Fix Minor Mode Key Priority
  5. Define Key Sequence
  6. How to Bind Super Hyper Keys
  7. How to Define Menu Key
  8. Remapping Keys Using key-translation-map
  9. How to Set Mouse Buttons

If you have a question, put $5 at patreon and message me.
Or Buy Xah Emacs Tutorial
Or buy a nice keyboard: Best Keyboards for Emacs


Emacs Lisp