Emacs: Command Frequency Statistics

This page lists emacs's commands in the order of their frequency of use.

In emacs, each key press invokes a command. For example, pressing a invokes the command self-insert-command. Pressing Ctrl+f invokes the command forward-char. Pressing Alt+x invokes execute-extended-command. Pressing the → invokes forward-char. Scrolling the mouse wheel invokes the command mwheel-scroll.

The motivation of this study, is in designing a Ergonomic Keybinding. I need to know what commands are more frequently used, in order to give it a easier-to-press key.

Command Frequency Table

Total number of command calls: 4661763

Total number of data entry (char insert) command calls: 2234669

Percent of data entry command calls: 48%

Interesting Highlights

Some interesting highlights from the stat, organized by common editing operations.

† Percentage with Respect to Non Data Entry Commands Count

Explanations

This report's data are from the following people:

Total number of command calls: 4661763.

Data Entry Commands vs Non Data Entry Commands

For this report, emacs commands are divided into one of 2 categories:

• data entry
• none data entry

“data entry” commands are commands that are typing, such as pressing any of letter keys, number keys, or Enter key. Emacs command name for these are: {self-insert-command, newline, org-self-insert-command, isearch-printing-char, org-return, etc}.

All other commands are considered “none data entry”.

This division is important for our study because commands that insert characters do not need a keyboard shortcut, they already correspond to each key on the keyboard. But also, we can tell what percentage keystroke in emacs is spend on typing.

Average: 48%

A higher percentage of data entry probably indicates that the person is doing a lot tasks that are mostly continuous fast typing, such as writing email, study notes, diary, irc chat.

Command Groups

Commands that are executed by the same shortcut key are grouped together. For example, the commands {delete-backward-char, backward-delete-char-untabify, python-backspace, cperl-electric-backspace} are all just the Backspace ⌫ key.

The following is the complete list of commands that are merged, and or represented by a glyph for clarity of reading.

How the Report is Compiled

Here we describe how the report is generated. Each person, installs this emacs package: command-frequency.el. (A new version, by David Capello [https://davidcapello.com/], renamed as keyfreq.el, is available at https://github.com/dacap/keyfreq. You should use this new version. )

The package will accumulate a key/value list of all commands the user calls in emacs. The key is command name and the value is the number of times that command has been called. After some time, the user calls “command-frequency-display”. This will write the stat into a buffer, then the user save it to file.

The raw data files used in this report are here: command-frequency_data_files.tgz

A Python program command-frequency.py, is used to parse these raw data files. The program aggregate all user's raw data, discard some commands such as mwheel-scroll, “nil”, keyboard macros, etc, then groups some commands together as described in this report, and replace some command names by a corresponding glyph, then computes the various statistics used for this report, and print them in HTML. Commands used less than 0.1% of total none data entry commands are not reported

Currently, this report is not normalized. For example Xah Lee (me)'s data is 41% of the whole. So, that means my usage pattern has major influence. You can use the Python program to select which file or group of files to use for generating the stat. The overall pattern does not change much. For comparison, see this version of report without Xah Lee (me)'s data, see: Emacs's Command Frequency Sans Xah Lee's Data. For the previous version of this report, made in 2007 with much less data, see: Emacs's Command Frequency (Old).

If you like to participate in this research, please download command-frequency.el and send me the output. I will incorporate your data into the next report update. Thank you.

Files people have sent to me for report but i haven't had time to process:

• .emacs.keyfreq.Daniel_Hackney_2012-05-18.el
• Fabrice_Niessen2,,2010-05-04.el
• erik_winkels_2010-06-21.txt
• Xue_Fuqiao_2013-05-01.txt
• Xah_Lee_2013-09-04.txt

2013-06-06, 2013-08-06 addendum: i didn't have time to work on this. This project needs to be automated. The keyfreq.el package should automatically send user's results to a server (such as github, and with user's consent in a preference), and automatically generate statistics. If you are interested, get in contact with David Capello, the author of keyfreq.el, or, you can join the ergoemacs-mode developement at https://ergoemacs.github.io/, led by Matthew Fidler.

Acknowledgment

Ryan Yeske hacked up a quick elisp code that count commands for the current session. Michal Nazarewicz made it into a full featured minor mode, with the ability to read and write to a file to accumulate log across sessions, and print percentages in report. David Capello added a feature to also log the mode the command is from.

Thanks to Katsumi Yamaoka for pointing out the problem of “this-command”. Thanks to Stefan Guath for pointing out “real-last-command”. Thanks to all the people who provided me their data.