Keyboard macros

Far Manager Macro System

Keyboard macros


  • Keyboard macros are usually used for quick recording and replaying key-press sequences. These macros are less powerful than regular macros and for the long-term use regular macros should be preferred.

  • Keyboard macros are loaded from Lua-files (extension *.lua), residing in the directory
    %FARPROFILE%\Macros\internal.

  • Far Manager automatically creates, modifies and deletes files in this directory in accordance with operations conducted on keyboard macros. It is not recommended to manually edit these files, except for their deletion.

  • Modifications to keyboard macros become permanent either after executing
    MacroControl(MCTL_SAVEALL), or automatically (when the “Auto save setup” option is on).

  • The field “area” may contain only one area name.

  • The field “key” may contain only one key name.
    In key names only modifiers Ctrl,Alt,Shift may be used, modifiers LCtrl,RCtrl,LAlt,RAlt are not supported. Regular expressions are not supported.

  • It is not allowed to have more than one keyboard macro for a (key,area) combination.

  • Keyboard macros have higher priority than all other macros. This avoids the need of resolving conflicts when one creates a temporary macro (the typical use case of keyboard macros).