Emacs: Xah Fly Keys Customization
This page shows how to customize Emacs: Xah Fly Keys.
Set Command Mode Activation Key
Here's a example of how to set the command mode activation key.
;; make key 【f4】 key do activate command mode. (global-set-key (kbd "<f4>") 'xah-fly-command-mode-activate)
For emacs key syntax see Emacs: How to Define Keys
On a typical PC keyboard, i recommend you make the Caps Lock key to send ↖ Home key signal for activating command mode.
How to Make the CapsLock Key do Home Key
Set Insert Mode Activation Key
If you have a nice keyboard with extra thumb keys such as kinesis, ergodox, you can set a dedicated key to switch to insert mode.
;; make key 【end】 to activate insertion mode. (global-set-key (kbd "<end>") 'xah-fly-insert-mode-activate)
Disable Changes to Control Key
xah-fly-keys supports standard control key such as 【Ctrl+o】 open, 【Ctrl+w】 close 【Ctrl+v】 paste 【Ctrl+z】 undo, etc.
You can disable them by:
(setq xah-fly-use-control-key nil) ; must come before loading xah-fly-keys
when disabled, no control binding will be touched by xah-fly-keys.
Why is disabling control binding useful?
- When learning xah-fly-keys. You can still rely on GNU Emacs keys to operate emacs.
- If you wan to define your own control keys. This makes a lot control spot available.
The following keybinding you should NOT override:
- 【Ctrl+c】 for major mode commands.
- 【Ctrl+g】 for cancel.
- 【Ctrl+q】 for
- 【Ctrl+h】 for Help.
Disable Changes to Meta Key
The only meta keybinding
xah-fly-keys bind is
as a extra key for
(so, out of the box, it's convenient for people who haven't bothered setting Caps Lock.)
You can disable this by:
(setq xah-fly-use-meta-key nil) ; must come before loading xah-fly-keys
Make Escape Key Do C-g
You can make the Esc key do emacs's 【Ctrl+g】.
(define-key key-translation-map (kbd "ESC") (kbd "C-g"))
Note: this will work 99% of time. When it doesn't work, just press 【Ctrl+g】. (the only case i know it doesn't work is when you quit emacs, and emacs says there are unsaved file and if you still want to quit, and pressing Esc to cancel quit doesn't work, but 【Ctrl+g】 works.)
Change Global Leader Key
You can set your own choice of the global leader key like this:
(define-key xah-fly-key-map (kbd "<f9>") xah-fly-leader-key-map) ; must come after loading xah-fly-keys
Put the above in your init, after loading xah-fly-keys.
Add or Change Leader Key Sequence
Here's how to change leader key sequence of a command.
Example, put this in your init, after loading xah-fly-keys:
;; make xah-fly-keys 【leader t】 do my-command-1 (define-key xah-fly-leader-key-map (kbd "t") 'my-command-1) ;; be sure that you want to replace existing command or keymap of 【leader t】
Here's a example of adding or creating a 3-key sequence:
;; make xah-fly-keys 【leader t x】 do sort-lines. (【leader t】 is qwerty 【leader k】) (define-key xah-leader-t-keymap (kbd "x") 'sort-lines)
Here's a example of creating a whole keymap.
(setq my-nice-keymap (make-sparse-keymap)) (define-key my-nice-keymap (kbd "a") 'my-command-1) (define-key my-nice-keymap (kbd "b") 'my-command-3) (define-key my-nice-keymap (kbd "c") 'my-command-4) (define-key my-nice-keymap (kbd "TAB") 'my-command-5) ;; make xah-fly-keys 【leader t】 as prefix for my-nice-keymap (define-key xah-fly-leader-key-map (kbd "t") my-nice-keymap) ;; so now, ;; 【leader t a】 is my-command-1 ;; 【leader t b】 is my-command-2
Here's a helpful command to convert Dvorak key to QWERTY.
(xah--dvorak-to-qwerty "e") ; return "d"
There are these hooks you can use:
- xah-fly-command-mode-activate-hook → hook variable. Value should be a list of function symbols. When command mode is activated, these functions are called after activation.
- xah-fly-insert-mode-activate-hook → hook variable. Value should be a list of function symbols. When insert mode is activated, these functions are called after activation.
Auto Save When Switching to Command Mode
By default, when you switch to command mode, current file is saved. It is done like this:
;; automatic save buffer when switching to command mode (add-hook 'xah-fly-command-mode-activate-hook 'xah-fly-save-buffer-if-file)
You can remove hook like this:
;; remove a hook (remove-hook 'xah-fly-command-mode-activate-hook 'xah-fly-save-buffer-if-file)
Change Cursor Shape, Command Mode, Insert Mode
You can make the mode state more obvious, by changing current line highlight. For example:
(defun hl-line-mode-on () (global-hl-line-mode 1)) (defun hl-line-mode-off () (global-hl-line-mode 0)) (add-hook 'xah-fly-command-mode-activate-hook 'hl-line-mode-on) (add-hook 'xah-fly-insert-mode-activate-hook 'hl-line-mode-off)
You can also use background color, such as:
Advanced Customization, How Does xah-fly-keys Work
If you look at the file, in 10 minutes you should have a basic idea. The code is simple.
Here's a outline of the code, as of 2017-02-13.
Note: the implementation may change in the future.
There's these 3 important command/variable:
xah-fly-command-mode-init→ set keybinding for command mode.
xah-fly-insert-mode-init→ set keybinding (basicall all to nil) for insert mode.
xah-fly-leader-key-map→ A variable, of leader keys sequence.
xah-fly-command-mode-init basically looks like this:
(defun xah-fly-command-mode-init () (xah-fly--define-keys xah-fly-key-map '( ("a" . execute-extended-command) ("b" . isearch-forward) ("c" . previous-line) ;; more here )))
xah-fly-insert-mode-init basically looks like this:
(defun xah-fly-insert-mode-init () (xah-fly--define-keys xah-fly-key-map '( ("a" . nil) ("b" . nil) ("c" . nil) ;; more )))
xah-fly-leader-key-map basically looks like this:
(xah-fly--define-keys (define-prefix-command 'xah-fly-leader-key-map) '( ("a" . mark-whole-buffer) ("b" . end-of-buffer) ("c" . xah-fly-c-keymap) ("d" . beginning-of-buffer) ("e" . xah-fly-e-keymap) ("f" . xah-search-current-word) ;; more ))
For example, the line
("b" . end-of-buffer)
press 【leader b】 will call
Note: All keys in the file are Dvorak keys. For example, if you see
("b" . isearch-forward), that's Dvorak b, and when user has QWERTY set, that b is automatically translated to n.
xah-fly--define-keys takes care of translating Dvorak to QWERTY, if user has qwery set
back to Emacs: Xah Fly Keys
or, buy something from Best Keyboard for Emacs