Repository files navigation

MyEmacsKeymap.ahk is an AutoHotkey script to simulate Emacs keybindings on Windows.

This script is made largely based on the scripts provided in the following web sites.

• WindowsでEmacs風キーバインド
  • https://github.com/usi3/emacs.ahk
• Windows の操作を emacs のキーバインドで行うための設定（AutoHotKey版）
  • http://www49.atwiki.jp/ntemacs/pages/20.html

*1.M-f andM-b move the cursor 5 times instead of moving through words. WhileM-n andM-p do not exist in Emacs keybindings, they can be a good middle ground whenC-n /C-p are too slow andC-v /M-v are too fast for page scrolling.
*2. Search is not incremental. Backward search is not implemented, either.
*3. Whether the active application is Google Sheets is determined atIfWinActive in them_IsGoogleSheets() function. The condition I set is very rough and it returnstrue whenever I am using FireFox or Google Chrome. You may want to modify the code to set a more suitable condition.
*4. The idea of usingC-q to temporarily turn off the tool is from XKeymacs, another keybinding tool I used to use. I have used XKeymacs for so long that it has become almost a reflex to typeC-q C-p for printing.
*5. Personally I useC-q C-a with Microsoft Paint, whereC-x h andC-x C-p both do not work.
*6. Personally I useC-q C-n with Web browsers.

Launch AutoHotkey (http://ahkscript.org) and loadMyEmacsKeymap.ahk. If you have a fresh installation of AutoHotkey, follow the steps below.

1. Create an empty file namedAutoHotkey.ahk in the installation directory and add the following line to the file:

#include%A_ScriptDir%\MyEmacsKeymap.ahk

2. CopyMyEmacsKeymap.ahk in the same directory

3. StartAutHotkey.exe

Note: If you run AutoHotkey without specifying a script file, the program will first look forAutoHotkey.ahk in the directory where the AutoHotkey executable resides. The path to this directory is stored in theA_ScriptDir built-in variable, and can be referenced as%A_ScriptDir%.

Refer to the following link for a tutorial on how to use AutoHotkey:

• AutoHotkey Biginner Tutorial
  • https://autohotkey.com/docs/Tutorial.htm

"Key slips" may occur when holding down keys. For example, when holding downC-f, the letterf may slip and appear on its own in the output, or the original Windows keymap gets incorrectly passed and the search box may pop up. These symptoms can be suppressed by lowering the Repeat Rate of the keyboard in Control Panel.

Add theahk_class value of such applications to them_IgnoreList list in them_IsEnabled function. Theahk_class value of each application can be identified using Window Spy (AU3_Spy.exe) that comes with AutoHotkey.

The default ignore list includesEmacs,Vim (GVim), andmintty (Cygwin Terminal).

m_IsEnabled() {global  ;; List of applications to be ignored by this script  ;; (Add applications as needed)  ;; Emacs - NTEmacs  ;; Vim - GVim  ;; mintty - Cygwin  m_IgnoreList := ["Emacs","Vim","mintty"]for index, element in m_IgnoreList  {IfWinActiveahk_class %element%Return0  }

C-M-q works as a toggle switch to suspend and resume the execution of this script. PressingC-M-q is the same as selecting "Suspend Hotkeys" from the right-click menu in the AutoHotkey task bar icon.

It is a limitation of this script. The porpuse of this script is just to make Windows a little more comfortable to use, not to perfectly emulate Emacs functionality. Also feel free to modify this script as fits your needs.