• Help for far2l itself via F1 inside the program (many sections are not updated or describe artifacts of the original Windows version of far; about artifacts and typos ).

• A series of (yearly/semi-)annual reviews of far2l achievements from unxed :

  • https://habr.com/ru/articles/903796/
  • https://www.opennet.ru/opennews/art.shtml?num=62386
  • https://habr.com/ru/articles/845998/
  • https://habr.com/ru/articles/768328/
  • https://habr.com/ru/articles/724118/
  • https://habr.com/ru/articles/698450/
  • https://habr.com/ru/articles/645475/
  • https://www.opennet.ru/opennews/art.shtml?num=56492
  • https://habr.com/ru/articles/593451/
  • https://habr.com/ru/articles/524370/
  • https://www.opennet.ru/opennews/art.shtml?num=49454
  • https://www.opennet.ru/opennews/art.shtml?num=44975

• Launch from console :

  • far2l— if far2l-gui is installed, then even when launched from a terminal emulator, the wx version will be launched in the graphical environment;
  • far2l --tty— launching in the console is always the console version of TTY|Xi;
  • far2l --tty --nodetect=xi— launching a minimal console version of TTY;
  • far2l --help— list of launch keys, including FAR2L backend-specific options.
  • Launch from console and open in the current directory panel :
    • (thanks for the advice ivanshatsky ): in ~/.config/far2l/settings/panel.inithe section [Panel/Left]or [Panel/Right]register Folder=$PWD(!) attention: any saving of settings will overwrite this item and it will be necessary to register it again;
    • (thanks for the advice unxed ): far2l .or far2l --tty .or far2l --tty -cd .(you can make a short alias, for example, alias f='far2l --tty -cd .'and then just run it on command f).
  • The portable version must be launched with the first parameter specified twice , that is far2l_<что-то-там>.run -- --tty -cd .(the first empty parameter --refers to the archive itself, and then the subsequent keys are specified, passed inside far2l).

• The directory with installed far2l - after launching far2l defines the variable $FARHOME, accordingly in the internal terminal a quick transition to the directory cd $FARHOME.

• Location of far2l personal settings and history

  • by default far2l works with settings stored in ~/.config/far2lor in$XDG_CONFIG_HOME/far2l
    • When running, the key -u(or environment variable $FARSETTINGS) allows you to specify the path to an arbitrary location of the settings:
      • -u <path>— in path/.config/(if path or $FARSETTINGS is a full path)
      • -u <identity>— in ~/.config/far2l/custom/identity/or in$XDG_CONFIG_HOME/far2l/custom/identity/
  • now all settings are stored in .ini-files _{(previously, settings after windows were stored in a pseudo-registry in directories ~/.config/far2l/REG; compilation with the key -DLEGACY=yesadds code that converts settings from REG to .ini when far2l starts)}
  • some settings files (may be missing):

    - settings/config.ini — основной конфиг
    - palette.ini — цветовая палитра консоли фара 16-32 цвета
    - settings/farcolors.ini — цвета интерфейса (цвета окон, панелей, файлов до применения раскраски)
                               (настраиваются через F9->Параметры->Цвета)
    - settings/colors.ini — раскраска файлов и группы сортировки + временные цвета (раньше хранил и цвета интерфейса)
                            (настраиваются через F9->Параметры->Раскраска файлов и группы сортировки)
    - settings/key_macros.ini — клавиатурные макросы [только far2l, в far2m вместо него Lua-макросы]
    - settings/user_menu.ini — главное меню пользователя (настраиваются через F9->Команды->Меню пользователя;
                                                          формат отличается от FarMenu.ini местных меню)
    - settings/associations.ini — ассоциации файлов (настраиваются через F9->Команды->Ассоциации файлов)
    - settings/bookmarks.ini — закладки на каталоги для быстрого перехода по RCtrl-0...9 или Ctrl-Alt-0...9
                               (настраиваются через F9->Команды->Закладки на папки)
    - favorites — закладки в меню точек монтирования (дисков), которое по Alt-F1/F2
    - cp — принудительное выставление OEM и ANSI кодировок, переключаемых по F8 для просмоторщика и редактора
    - plugins — плагины
        - plugins/state.ini — кэш плагинов
        - plugins/NetRocks/sites.cfg — NetRocks sites
        - plugins/multiarc/custom.ini — добавление архиваторов командной строки
        - plugins/colorer/config.ini — пользовательский конфиг Far Colorer, сюда же удобно класть
                                       свои схемы colorer'а, которые будут применяться поверх базовых
                                       (требуют явного прописывания в настройках Far Colorer)
    - clipboard — bash-скрипт (должен иметь права выполнения chmod +x) для работы с буфером обмена,
                  если встроенные средства почему-то не получают доступ
    - notify.sh, open.sh, ps.sh, trash.sh, view.sh — пользовательские скрипты кастомизации,
                  вызываемые (при наличии) из базовых скриптов $FARHOME/open.sh и т.д.
    
    • about the ini file format: https://github.com/elfmz/far2l/wiki/INI-files-format
    • farcolors.ini— interface colors (colors of windows, panels, files on panels before applying coloring), _{introduced starting with build 07fe3a8 from 02/15/2025; if there is no farcolors.iniinterface color, they try to take it from the old format fromcolors.ini}
    • colors.ini— coloring of files and sorting groups and temporary colors from the color dialog _{(before build 07fe3a8 it also stored interface colors)}
    • about favoritessee: https://github.com/elfmz/far2l/issues/1379#issuecomment-1295961834
    • more cpdetails below
    • about plugins/NetRocks/sites.cfgsee: https://github.com/elfmz/far2l/issues/874#issuecomment-758384645
    • pro plugins/multiarc/custom.ini: instructions and example
    • pro plugins/colorer: _{custom syntax files can be placed anywhere, the main thing is to specify the path to them in the plugin settings (F9⇒Options⇒Plugins configuration / Alt+Shift+F9 ⇒ FarColorer ⇒ Users file of... or in the corresponding file fields ~/.config/far2l/plugins/colorer/config.ini), see also the general, non-Linux-specific instruction https://github.com/colorer/Colorer-library/blob/master/docs/custom.md}
    • about clipboardthe details above
    • about customization scripts:
      • _{open.sh— a custom script to override EXEC_TERM=— the terminal emulator used when Shift-Enter is pressed inside $FARHOME/open.sh, if you want to use something different from the system one from /etc/alternatives/x-terminal-emulator}
      • _{trash.sh— redefining actions when deleting to the trash, for example, see the advice for KDE users: https://github.com/elfmz/far2l/issues/2049}
      • _{$FARHOME/*.shnow the path is hardcoded into the base scripts ~/.config/far2l/, so they do not take into account the location redefinition described above}
    • keyboard macro examples see below: about Colorer and Various macros
    • in shmuz fork of far2m the classic format of far2 macros (from file settings/key_macros.ini) is ignored; only Lua macros like in far3 work (they are in Macros/scripts, details in macroapi_manual_linux.chm )

_{Note: editing config files when autosaving settings in FAR is disabled or FAR must not be running}

• Standard features of far that happily brighten up life in far2l:

  • copy a piece of the screen to the clipboard: Alt-Ins⇒ use the arrows to move to the desired position ⇒ select using Shiftthe -arrow (or mouse) ⇒ EnterorCtrl-Ins
  • quick transition on the panel to a directory/file by name via Alt-letter understands substitutions *and ?, further jump to those satisfying the criterion via Ctrl-[Shift]-Enter
  • escalation of privileges - edit the config in /etc, and when saving far2l, if necessary, it will ask for root rights (no need to remember and do sudo in advance).

• Get file name/path from panels:

  • paste with cranning \into command line :
    • Ctrl-Enter — file name or Ctrl-F — full path to file from active panel, Ctrl-Shift-Enter — file name or Ctrl-; — full path to file from passive panel, Ctrl-[ and Ctrl-] — full path to directory from left or right panel;
    • if the name/path contains spaces, quotes and other similar characters, they are escaped with a slash \, since in Linux (unlike Windows) any characters (including quotes ") are allowed in names except /;
  • copy to clipboard without backslash escaping in far2l:
    • Ctrl-Ins — file name and Ctrl-Alt-Ins — full file path from the active panel (and then you can paste it anywhere using Shift-Ins or Ctrl-V ).

• Ctrl-Alt-F — in history (commands, folders, viewing/editing files), user menu, menu for selecting mount points, etc. — switching to quick filter mode , i.e. showing only items containing the entered text ( after turning on the filter mode in the menu, the keys stop selecting items according to the set hotkeys ).

  • To automatically enable filtering in the history of commands, folders, viewing/editing files, you can use the following macros (thanks for the advice to ivanshatsky ):
    • classic macros for far2l (add to file ~/.config/far2l/settings/key_macros.ini):

      [KeyMacros/Shell/AltF8]
      Sequence=AltF8 CtrlAltF
      [KeyMacros/Shell/AltF11]
      Sequence=AltF11 CtrlAltF
      [KeyMacros/Shell/AltF12]
      Sequence=AltF12 CtrlAltF

      <clipboard-copy aria-label="Copy" class="ClipboardButton btn js-clipboard-copy m-2 p-0" data-copy-feedback="Copied!" data-tooltip-direction="w" value="[KeyMacros/Shell/AltF8] Sequence=AltF8 CtrlAltF

      [KeyMacros/Shell/AltF11] Sequence=AltF11 CtrlAltF

      [KeyMacros/Shell/AltF12] Sequence=AltF12 CtrlAltF" tabindex="0" role="button" style="box-sizing: border-box; position: relative; display: inline-block; padding: 0px !important; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; white-space: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border-width: 1px; border-style: solid; border-color: var(--button-default-borderColor-rest, var(--color-btn-border)); border-image: initial; border-radius: 6px; appearance: none; color: var(--button-default-fgColor-rest, var(--color-btn-text)); background-color: var(--button-default-bgColor-rest, var(--color-btn-bg)); box-shadow: var(--button-default-shadow-resting, var(--color-btn-shadow)),var(--button-default-shadow-inset, var(--color-btn-inset-shadow)); transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1) 0s, background-color, box-shadow, border-color; margin: var(--base-size-8, 8px) !important;">

    • lua macros for far2m (put in directory /.config/far2m/Macros/scripts):

      Macro { description="Turn filter on in command/view/edit/folders histories";
      area="Shell Info Tree"; key="AltF8 AltF11 AltF12";
      action = function()
      Keys(mf.akey(1,1).." CtrlAltF")
      end;
      }

• Using as the "default" unix editor (thanks to ivanshatsky for the tip ):

  • far2l can be written in a shell variable EDITOR, after which far2l will be used instead of the standard one viwhen calling any commands like sudo -eor crontab -eor vipw(and also for editing the description when calling git commit:)
  • For most programs it is enough to specifyEDITOR="far2l -e"
  • nuance: mcit does not use the key when calling the editor -eand as a result simply launches far (there may be other such exceptions), therefore on far2l you can use (or make yourself) a symlink with the name far2ledit, and register it in a variable, so it will work as an editor without additional keys: export EDITOR=farl2edit.

• Selecting code pages with F8 in the editor and viewer . OEM and ANSI code pages switched with F8 are determined based on the file /.config/far2l/cp(first line - OEM, second - ANSI) or, if it is absent, the environment variable LC_CTYPE(see DeduceCodepages()in WinPort/src/APIStringCodepages.cpp )

  • Method 1: according to https://github.com/shmuz/far2m/issues/16#issuecomment-1351763055

    Create a file ~/.config/far2l/cp, put 2 lines in it: 866 1251Restart FAR.

  • Method 2: Override the environment variable before running farLANG
    • to launch via shortcut - in the file /usr/share/applications/far2l.desktopedit the line, Exec=far2lfor example for Russian ANSI=1251 and OEM=866 to Exec=env LANG=ru_RU.UTF8 far2l.

• Editor 's usefulness (details: in far2l in the help under F1 see the section Editor )

  • Alt-Cursor key — vertical block mark.

  • Alt-Shift-Cursor Key - mark a vertical block (Shift is needed if you use the NumLock keyboard).

  • Shift-F2 — resave the current document with the ability to change the code page , BOM , line feed (CR LF, CR, LF).

  • F5 — turn on/off display of whitespace characters (spaces, tabs).

  • Ctrl-F5 — changes the input mode for newly entered TABs : either they remain TABs , or they change to a specified number of spaces (configurable via Shift-F5 or F9 / Alt-Shift-F9 or based on files .editorconfig, see https://editorconfig.org/ and https://github.com/elfmz/far2l/issues/1222 ).

  • Working with paired brackets in the editor is supported at the FarColorer plugin level (based on Colorer ) and has tasty features initially available only through F11⇒FarColorer. To assign key combinations to these features (as described in the FarColorer help, but does not work)

    • classic-macros for far2l _{[ click to expand/collapse ]}

      <clipboard-copy aria-label="Copy" class="ClipboardButton btn js-clipboard-copy m-2 p-0" data-copy-feedback="Copied!" data-tooltip-direction="w" value="[KeyMacros/Editor/AltL] DisableOutput=0x1 Sequence=F11 F 1 Description=Editor->FarColorer->List types

      [KeyMacros/Editor/Alt[] DisableOutput=0x1 Sequence=F11 F 2 Description=Editor->FarColorer->Match pair

      [KeyMacros/Editor/Alt]] DisableOutput=0x1 Sequence=F11 F 3 Description=Editor->FarColorer->Select block

      [KeyMacros/Editor/AltP] DisableOutput=0x1 Sequence=F11 F 4 Description=Editor->FarColorer->Select pair

      [KeyMacros/Editor/Alt;] DisableOutput=0x1 Sequence=F11 F 5 Description=Editor->FarColorer->Outliner list

      [KeyMacros/Editor/Alt'] DisableOutput=0x1 Sequence=F11 F 6 Description=Editor->FarColorer->Errors list

      [KeyMacros/Editor/AltK] DisableOutput=0x1 Sequence=F11 F 7 Description=Editor->FarColorer->Select region

      [KeyMacros/Editor/AltO] DisableOutput=0x1 Sequence=F11 F 8 Description=Editor->FarColorer->Find Function" tabindex="0" role="button" style="box-sizing: border-box; position: relative; display: inline-block; padding: 0px !important; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; white-space: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border-width: 1px; border-style: solid; border-color: var(--button-default-borderColor-rest, var(--color-btn-border)); border-image: initial; border-radius: 6px; appearance: none; color: var(--button-default-fgColor-rest, var(--color-btn-text)); background-color: var(--button-default-bgColor-rest, var(--color-btn-bg)); box-shadow: var(--button-default-shadow-resting, var(--color-btn-shadow)),var(--button-default-shadow-inset, var(--color-btn-inset-shadow)); transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1) 0s, background-color, box-shadow, border-color; margin: var(--base-size-8, 8px) !important;">

    • lua macros for far2m _{[ click to expand/collapse ]}

      <clipboard-copy aria-label="Copy" class="ClipboardButton btn js-clipboard-copy m-2 p-0" data-copy-feedback="Copied!" data-tooltip-direction="w" value="Macro { description="Colorer: Список типов"; area="Editor"; key="AltL"; action=function() Keys("F11 F 1") end; }

      Macro { description="Colorer: Найти парную скобку"; area="Editor"; key="Alt["; action=function() Keys("F11 F 2") end; }

      Macro { description="Colorer: Выделить блок со скобками"; area="Editor"; key="Alt]"; action=function() Keys("F11 F 3") end; } Macro { description="Colorer: Выделить блок между скобок"; area="Editor"; key="AltP"; action=function() Keys("F11 F 4") end; }

      Macro { description="Colorer: Список функций"; area="Editor"; key="Alt;"; action=function() Keys("F11 F 5") end; }

      Macro { description="Colorer: Список ошибок"; area="Editor"; key="Alt'"; action=function() Keys("F11 F 6") end; }

      Macro { description="Colorer: Выбрать текущий регион"; area="Editor"; key="AltK"; action=function() Keys("F11 F 7") end; }

      Macro { description="Colorer: Найти функцию"; area="Editor"; key="AltO"; action=function() Keys("F11 F 8") end; }" tabindex="0" role="button" style="box-sizing: border-box; position: relative; display: inline-block; padding: 0px !important; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; white-space: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border-width: 1px; border-style: solid; border-color: var(--button-default-borderColor-rest, var(--color-btn-border)); border-image: initial; border-radius: 6px; appearance: none; color: var(--button-default-fgColor-rest, var(--color-btn-text)); background-color: var(--button-default-bgColor-rest, var(--color-btn-bg)); box-shadow: var(--button-default-shadow-resting, var(--color-btn-shadow)),var(--button-default-shadow-inset, var(--color-btn-inset-shadow)); transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1) 0s, background-color, box-shadow, border-color; margin: var(--base-size-8, 8px) !important;">

  • Colorer and large files

    • to save resources, when opening a file, Colorer processes only the first 6000 lines of the file (unlike the version for Windows, this is not yet configurable);
    • if the file has more than 6000 lines, then when switching to them, the Colorer coloring works as if in the background - within the framework of a common/single far stream - and in order for far to be responsive, there are interrupts (it seems we are waiting for an event from far2l with the idle type and for each such event, conditionally 500 lines are parsed) - this looks slow;
    • to force coloring of the entire large file from the editor in the Colorer plugin menu F11⇒FarColorer⇒ 9 Update highlighting / 9 Update coloring ; this starts parsing the file without interruptions for other actions ( the editor freezes ).

• Viewer Utilities (details: in far2l in the help for F1 see the section Viewer: control keys / Viewer: control keys )

  • Ctrl-F7 — grep filter (temporary filtering of the contents of the viewed file using the UNIX utility grep).
  • F5 — viewing in processed mode, allowing to obtain information about the file (text representation of PDF or technical data about the image); for images also in the presence of external programs ( chafaetc.) full-color display of the image itself (unfortunately, the display size is limited by the terminal settings and the image resolution is very low quality).

• Built-in terminal usefulness - after hiding both panels (by Ctrl-O ) various usefulnesses are available in the built-in terminal (full list: in far2l in the help by F1 see the section Terminal / Terminal , also https://github.com/elfmz/far2l/issues/150#issuecomment-278467291 ):

  • Tab — Autocompletion (based on FAR2L)

  • Shift-Tab-Tab — Autocompletion (bash based)

  • F3 or Ctrl+Shift+F3 or Ctrl+Shift+MouseScrollUp — Terminal⇒View (all terminal history in View — convenient for scrolling through long output)

  • F4 or Ctrl+Shift+F4 — Terminal⇒Editor (all history of terminal output in Editor)

    ^{(the viewer/editor contains a temporary copy of the terminal at the time F3 or F4 was pressed and may not include further changes in the terminal)}

  • F8 - Clear terminal and screen history

  • mouse selection - immediately select and put into the clipboard (attention! unlike Alt-Ins, it does not require further actions, but immediately upon releasing the mouse, it throws the selected fragment into the clipboard ⇒ there may be unexpected overwriting of data in the clipboard)

• Background launch of programs, without blocking the terminal far2l :

  • program &: just add & at the end (after the space) - will close the program after closing far2l;
  • nohup program &: will leave the program running after far2l has finished, but a nohup.out file will be created in the current directory with the program's output;
  • nohup program >/dev/null 2>&1 &: will leave the program running after far2l has finished without any extra output.

• Launching programs from the user menu without blocking the terminal far2l

  • команды &: when launching various GUI programs, so that they do not occupy the terminal, it is enough to put at the end of the command as standard  & _{(see the nuances in the previous paragraph )} ;
  • $FARHOME/open.sh exec команды: to run in an external terminal - required execas the first parameter for open.sh _{(inside far2l $FARHOME/open.shit is used to run by Shift - Enter )} .

• Saving/excluding commands from saving in history :

  • in far2l history works like bash$HISTCONTROL with options ignoredups(do not save duplicates in a row) and erasedups(remove duplicates from history altogether);
  • to work as ignorespace(anything starting with a space does not get into history) add ;" "in F9⇒Options⇒Autocompletion settings ( source )

• Marking file types, directories, symlinks,... with a symbol, similar to mcandls -F

  • configured via F9⇒Options⇒File coloring and sorting groups⇒Optional mark symbol

  • starting from the build 2.6.3-2024-10-05-f9a1d3b8is the default coloring by default

    

    • for existing profiles you need to kill your current coloring F9⇒Options⇒Files highlighting and sort groups / F9⇒Options⇒Coloring of files and sorting groups and press Ctrl+R (if you feel sorry for it, save it first ~/.config/far2l/settings/colors.ini)

    • quick global switching of marker display on panels via Ctrl+Alt+M or F9⇒Panel settings dialog

    • in the current scheme, according to the Windows Far tradition, executable files after receiving a marker  are highlighted by extension due to [x] Continue processing(which is indicated by the mark in the list of groups "File coloring" ↓);

    • If you want all executables to have the same color , then for recording with a marker * you enable [ ] Continue processing.

    decoding symbols similar to man mc _{[ click to expand/collapse ]}

    <clipboard-copy aria-label="Copy" class="ClipboardButton btn js-clipboard-copy m-2 p-0" data-copy-feedback="Copied!" data-tooltip-direction="w" value="! for broken

    • for executable files (with X mode) / for directories ~ for symbolic links to directories @ for links = for sockets

    • for character devices

    • for block devices | for pipes" tabindex="0" role="button" style="box-sizing: border-box; position: relative; display: inline-block; padding: 0px !important; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; white-space: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border-width: 1px; border-style: solid; border-color: var(--button-default-borderColor-rest, var(--color-btn-border)); border-image: initial; border-radius: 6px; appearance: none; color: var(--button-default-fgColor-rest, var(--color-btn-text)); background-color: var(--button-default-bgColor-rest, var(--color-btn-bg)); box-shadow: var(--button-default-shadow-resting, var(--color-btn-shadow)),var(--button-default-shadow-inset, var(--color-btn-inset-shadow)); transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1) 0s, background-color, box-shadow, border-color; margin: var(--base-size-8, 8px) !important;">
  • an example of self-configuration on the screenshot (in this exact order) _{[ click to expand/hide ]}

    

• Using regular expressions ( PCRE ) in file mask groups (available wherever masks are, including file name search with Alt-F7 ): starting with #1395 , regular expressions work correctly in file mask groups. Example of using case-insensitive extension for images:

  

  The syntax of regular expressions is almost identical to Perl regexps, for more details see the help section Regular expressions for searching and Regular expressions .

• Entering and searching for special characters (end of line, etc.)

  • In any input fields and editor after Ctrl-Q the key combination pressed is processed in the line as a character, for example,

    • Ctrl-Q , Enter will enter a line break and will display as♪
    • Ctrl-Q , Esc will display as ←etc.

    This is useful when typing in dialog boxes, particularly search fields.

  • For example, when searching through files using Alt-F7, search with the text space , Ctrl-Q , Enter will enter  ♪and find files containing line endings with spaces.

  • Inside the text editor, the standard search/replace by F7 / Ctrl-F7 searches only within each line, so to search for text near the beginning/end of lines, use regular expressions (enabled by a check mark), for example, by pattern /\s$/- spaces at the ends of lines, /^\s/- spaces at the beginning of lines, etc.

  • In the replacement field for replacing a fragment found by lines with a multi-line text inside the editor, it helps to enter line breaks in the right places using the sequence Ctrl-Q , Enter .

    _{In far2m, the lua plugin LF Search can search/replace on multiple lines .}

• Various macros and customizations (add keyboard macros to the file ~/.config/far2l/settings/key_macros.ini, then close and open far2l):

  • a hack for calling external programs for comparing files selected on panels (thanks to bigvax ): https://github.com/elfmz/far2l/issues/1042#issuecomment-983533025

  • backlight crutch as executed only with X attribute (by default also by extension list): https://github.com/elfmz/far2l/issues/1377#issuecomment-1304708792

  • alternative file panel mode (thanks to bigvax ): https://github.com/elfmz/far2l/discussions/1300

  • Lynx style motion and various macros from bigvax : https://github.com/elfmz/far2l/discussions/1146

  • macros for working with selection and for navigating through folders by michel-nk : https://github.com/elfmz/far2l/discussions/2266

  • keyboard macros for stripped down keyboards (without Gray NumPad and, for example, in MacBookPro 13" the keyboard does not have Ins , etc.)

    • https://github.com/corporateshark/far2l-macros/issues/6

    • macros are similar to the keys Grey NumPad + , - and  ( _{Ctrl+= as an analog of Grey+ , Ctrl+- as an analog of Grey- and Ctrl+Shift+8 as an analog of Grey} ):

      [KeyMacros/Shell/Ctrl=]
      Description=Select group
      DisableOutput=0x1
      Sequence=Add
      
      [KeyMacros/Shell/Ctrl-]
      Description=Deselect group
      DisableOutput=0x1
      Sequence=Subtract
      [KeyMacros/Shell/CtrlShift8]
      Description=Invert selection
      DisableOutput=0x1
      Sequence=Multiply

      <clipboard-copy aria-label="Copy" class="ClipboardButton btn js-clipboard-copy m-2 p-0" data-copy-feedback="Copied!" data-tooltip-direction="w" value="[KeyMacros/Shell/Ctrl=] Description=Select group DisableOutput=0x1 Sequence=Add

      [KeyMacros/Shell/Ctrl-] Description=Deselect group DisableOutput=0x1 Sequence=Subtract

      [KeyMacros/Shell/CtrlShift8] Description=Invert selection DisableOutput=0x1 Sequence=Multiply" tabindex="0" role="button" style="box-sizing: border-box; position: relative; display: inline-block; padding: 0px !important; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; white-space: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border-width: 1px; border-style: solid; border-color: var(--button-default-borderColor-rest, var(--color-btn-border)); border-image: initial; border-radius: 6px; appearance: none; color: var(--button-default-fgColor-rest, var(--color-btn-text)); background-color: var(--button-default-bgColor-rest, var(--color-btn-bg)); box-shadow: var(--button-default-shadow-resting, var(--color-btn-shadow)),var(--button-default-shadow-inset, var(--color-btn-inset-shadow)); transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1) 0s, background-color, box-shadow, border-color; margin: var(--base-size-8, 8px) !important;">

    • use space as Ins (only on panels)

      [KeyMacros/Shell/Space]
      DisableOutput=0x1
      EmptyCommandLine=0x1
      NoSendKeysToPlugins=0x1
      Sequence=Num0

    • as Ins use Ctrl-Shift-T (everywhere, including in the menu by F2 )

      [KeyMacros/Common/CtrlShiftT]
      DisableOutput=0x1
      Sequence=Ins

    • alternative to F1 ... F10 in the form of Alt+1 ... Alt+0 (in practice it may be more convenient for keyboards where a number of function keys are available only via Fn ), in a pure terminal it also corresponds to successive pressing of Esc, the number as traditionally in mc (details and discussion https://github.com/elfmz/far2l/issues/2317#issuecomment-2256927220 ):

      [KeyMacros/Common/Alt1]
      Sequence=F1
      Description=Alt+1 as alternative to F1
      [KeyMacros/Common/Alt2]
      Sequence=F2
      Description=Alt+2 as alternative to F2
      [KeyMacros/Common/Alt3]
      Sequence=F3
      Description=Alt+3 as alternative to F3
      [KeyMacros/Common/Alt4]
      Sequence=F4
      Description=Alt+4 as alternative to F4
      [KeyMacros/Common/Alt5]
      Sequence=F5
      Description=Alt+5 as alternative to F5
      [KeyMacros/Common/Alt6]
      Sequence=F6
      Description=Alt+6 as alternative to F6
      [KeyMacros/Common/Alt7]
      Sequence=F7
      Description=Alt+7 as alternative to F7
      [KeyMacros/Common/Alt8]
      Sequence=F8
      Description=Alt+8 as alternative to F8
      [KeyMacros/Common/Alt9]
      Sequence=F9
      Description=Alt+9 as alternative to F9
      [KeyMacros/Common/Alt0]
      Sequence=F10
      Description=Alt+0 as alternative to F10

      <clipboard-copy aria-label="Copy" class="ClipboardButton btn js-clipboard-copy m-2 p-0" data-copy-feedback="Copied!" data-tooltip-direction="w" value="[KeyMacros/Common/Alt1] Sequence=F1 Description=Alt+1 as alternative to F1

      [KeyMacros/Common/Alt2] Sequence=F2 Description=Alt+2 as alternative to F2

      [KeyMacros/Common/Alt3] Sequence=F3 Description=Alt+3 as alternative to F3

      [KeyMacros/Common/Alt4] Sequence=F4 Description=Alt+4 as alternative to F4

      [KeyMacros/Common/Alt5] Sequence=F5 Description=Alt+5 as alternative to F5

      [KeyMacros/Common/Alt6] Sequence=F6 Description=Alt+6 as alternative to F6

      [KeyMacros/Common/Alt7] Sequence=F7 Description=Alt+7 as alternative to F7

      [KeyMacros/Common/Alt8] Sequence=F8 Description=Alt+8 as alternative to F8

      [KeyMacros/Common/Alt9] Sequence=F9 Description=Alt+9 as alternative to F9

      [KeyMacros/Common/Alt0] Sequence=F10 Description=Alt+0 as alternative to F10" tabindex="0" role="button" style="box-sizing: border-box; position: relative; display: inline-block; padding: 0px !important; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; white-space: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border-width: 1px; border-style: solid; border-color: var(--button-default-borderColor-rest, var(--color-btn-border)); border-image: initial; border-radius: 6px; appearance: none; color: var(--button-default-fgColor-rest, var(--color-btn-text)); background-color: var(--button-default-bgColor-rest, var(--color-btn-bg)); box-shadow: var(--button-default-shadow-resting, var(--color-btn-shadow)),var(--button-default-shadow-inset, var(--color-btn-inset-shadow)); transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1) 0s, background-color, box-shadow, border-color; margin: var(--base-size-8, 8px) !important;">

  • transition on the inactive panel not only to the same directory, but also positioning the cursor on the same file as in the original panel (in the example, it is assigned to Alt-] )

    [KeyMacros/Shell/Alt]]
    DisableOutput=0x1
    Sequence=Tab Ctrl\ CtrlPgUp - Tab $If (((APanel.Bof && APanel.Root) || ! APanel.Bof) && PPanel.Visible) Panel.SetPath(1,PPanel.Path,APanel.Current) $Else $End

  • example of calling a plugin by name (unfortunately, plugin GUIDs are only added with far3)

    [KeyMacros/Shell/AltC]
    DisableOutput=0x1
    Sequence=F11 $If (Menu.Select("Advanced compare",3) || Menu.Select("Расширенное сравнение",3)) Enter $Else Esc MsgBox("Warning","Advanced compare plugin is not installed!",1) $End

  • search in panels similar to MC by pressing Ctrl-S

    [KeyMacros/Shell/CtrlS]
    DisableOutput=0x1
    Sequence=Alt0 BS

• Quick jump to the mount point of the file system of the current directory using Ctrl-Alt-</font> (since build 26.10.2024 , for older versions you can use the macro from https://github.com/elfmz/far2l/issues/2010#issuecomment-1975182538 )

• Features of handling symbolic links :

  • Системные параметры ⇒ [x] Сканировать символические ссылки
  • System settings⇒[x] Scan symbolic links
  • Explanation: https://github.com/elfmz/far2l/issues/165#issuecomment-255555031

• Changing the far2l-GUI font:

  • F9⇒Options⇒Interface settings⇒Change font
  • Font ttf 10x18 "FAR as in windows console": https://github.com/elfmz/far2l/issues/886

• Logging into a remote server via NetRocks and then running far2l there allows you to fully transfer key combinations and the clipboard in both directions via TTY|F mode (see above )

• NetRocks-SFTP speed :

  • The speed of NetRocks-SFTP is significantly affected by the setting: Site connection settings ⇒ Protocol options ⇒ Max read block size, bytes. The default is 32768, and this is a very small value, try setting it to, for example, 131072.
  • Also, if the setting Site connection settings ⇒ Extra options ⇒ Keepalive, secondsis not 0, then there will be speed losses.

• Connecting from NetRocks to old servers

  • some old servers can only be accessed if set to [ Protocol options ]⇒ Authentication:⇒ Interactive login/ [ Настр. протокола ]⇒ Авторизация:⇒Интерактивный логин

• Background copying can be done via the protocol filefrom NetRocks Plugin:

  a small lifehack: far2l can't copy to the background, but NetRocks can. And NetRocks also has a pseudo-protocol file: So, if you type file: in the far2l console now, the NetRocks FS overview will open in the panel, which is not much different from the usual one. But if you start copying from there, the NetRocks "download" window will open. With the ability to output to the background.

  (source: https://github.com/elfmz/far2l/issues/247#issuecomment-493710827 )

  How to monitor/interrupt background copying?

  background copying - there the item appears in F11. Or via F9/Options/Plugins configuration

  (source: https://github.com/elfmz/far2l/issues/247#issuecomment-493738355 )

• Cascading SSH connection in NetRocks Plugin :

  • Question: there is ssh to server A, and from it ssh to server B, is it really possible to explain to NetRox how to access server B?

  • Answer _{[ click to expand/collapse ]}

    • <clipboard-copy aria-label="Copy" class="ClipboardButton btn js-clipboard-copy m-2 p-0" data-copy-feedback="Copied!" data-tooltip-direction="w" value="Host test2.domain IdentityFile ~/.ssh/id_rsa.test1 Hostname 1.2.3.4 ProxyJump [email protected]:22

      Host test3.abc IdentityFile ~/.ssh/id_rsa.test2 Hostname 5.6.7.8 ProxyJump [email protected]:22" tabindex="0" role="button" style="box-sizing: border-box; position: relative; display: inline-block; padding: 0px !important; font-size: 14px; font-weight: var(--base-text-weight-medium, 500); line-height: 20px; white-space: nowrap; vertical-align: middle; cursor: pointer; user-select: none; border-width: 1px; border-style: solid; border-color: var(--button-default-borderColor-rest, var(--color-btn-border)); border-image: initial; border-radius: 6px; appearance: none; color: var(--button-default-fgColor-rest, var(--color-btn-text)); background-color: var(--button-default-bgColor-rest, var(--color-btn-bg)); box-shadow: var(--button-default-shadow-resting, var(--color-btn-shadow)),var(--button-default-shadow-inset, var(--color-btn-inset-shadow)); transition: color 80ms cubic-bezier(0.33, 1, 0.68, 1) 0s, background-color, box-shadow, border-color; margin: var(--base-size-8, 8px) !important;">

• Using rclone in NetRocks for various protocols (Amazon S3, etc): https://github.com/elfmz/far2l/issues/1816#issuecomment-2267081585

  • _{[ click to expand/collapse ]}

(for more details see far2l by F1 in help )

Везде:

Ctrl-Alt-Shift — Временно убрать обе панели / текущий диалог и т.п.
(работает до тех пор, пока удерживаем эти клавиши)
Alt-F9 или Alt-Enter — окно во весь экран (не все терминалы поддерживают)
Alt-Ins — скопировать кусок экрана в буфер обмена:
Alt-Ins ⇒ [стрелки/Home/End/PgUp/PgDown] — переместится к нужной позиции
⇒ Shift-[стрелки/Home/End/PgUp/PgDown] (или мышью) — выделение куска экрана
⇒ Enter или Ctrl-Ins — копирование выделенного в буфер обмена
F1 — помощь
F11 — список и запуск доступных плагинов (свой различный список для панелей/просмоторщика/редактора)
F12 — список и переключением между открытыми внутри far2l окна/экранами
(панели, файлы в редакторе/просмотрощике)
Ctrl-Tab и Ctrl-Shift-Tab — переключением между окнами/экранами в прямом и обратном порядке
[окно терминала по Ctrl-O не считается отдельным экраном, а идёт как панели,
однако, открытое в нём по F3 или F4 есть отдельный экран временной копии терминала]

Внутри помощи:

Alt-F1 или BS — переход на предыдущую страницу
Shift-F2 — переход к темам помощи по внешним модулям (plugins)
Shift-F1 — содержание помощи
F7 — поиск по помощи (отображает разделы справки, содержащие искомый фрагмент текста)
В зависимости от текущей страницы Shift-F1 и F7 работают
либо с помощью основного far, либо выбранного плагина

На панелях:


Enter — Запуск (в консоли far), смена каталога, вход в архив


Shift-Enter — Запуск в отдельном окне, открытие каталога средствами оболочки


Ins или Shift-Down — пометить/снять пометку файла и сдвинуться вниз


Shift-Up — пометить/снять пометку файла и сдвинуться вверх


Ctrl-\ — Сменить каталог на корневой (/)


Ctrl-Alt-\ — Сменить каталог на точку монтирования файловой системы текущего каталога


Ctrl-` — Сменить каталог на домашний (~)


Ctrl-PgDn — Смена каталога, вход в архив


Ctrl-Shift-PgDn — аналогично Ctrl-PgDn + для symlink переход к расположению оригинального файла


Ctrl-PgUp — Перейти в каталог уровнем выше (из корня в меню точек монтирования / файловых плагинов)


Ctrl-Shift-PgUp — если ранее был переход по Ctrl-Shift-PgDn на symlink, то возврат к symlink


Ctrl-J, Ctrl-Enter — Вставить имя файла из активной панели (с экранированием)


Ctrl-Shift-Enter — Вставить имя файла из пассивной панели (с экранированием)


Ctrl-[ и Ctrl-] — Вставить полный путь к текущему каталогу из левой или правой панели (с экранированием)
[действуют также в редакторе и диалоговых окнах без экранирования]


Ctrl-F — Вставить полное имя файла из активной панели (с экранированием)


Ctrl-; — Вставить полное имя файла из пассивной панели (с экранированием)


Ctrl-Ins — Копирование имени файла из активной панели в буфер обмена (без экранирования)


Ctrl-Alt-Ins — Копирование полного пути из активной панели в буфер обмена (без экранирования)


Ctrl-E — Предыдущая команда (в командной строке)


Ctrl-X — Следующая команда (в командной строке)


Ctrl-Y — Очистить командную строку


Alt-F8 — Показать историю команд


Alt-F11 — Показать историю просмотра и редактирования


Alt-F12 — Показать историю папок


Ctrl-Up, Ctrl-Down — Изменить высоту панелей
— История в строках редактирования диалогов


Ctrl-Shift-Up, Ctrl-Shift-Down — Изменить высоту текущей панели


Ctrl-Left, Ctrl-Right — Изменить ширину (при пустой командной строке)


Alt-Left, Alt-Right, Alt-Home, Alt-End — Прокрутка длинных имён и описаний


Alt-буква — быстрый переход на панели к каталогу/файлу по имени понимает подстановочные * и ?,
дальнейший перескок к удовлетворяющим критерию по Ctrl-[Shift]-Enter


В истории (команд, папок, просмотра/редактирования файлов),
пользовательском меню, меню выбора точек монтирования и т.п.

Ctrl-Alt-F — переключение в режим быстрой фильтрации,
т.е. показывать только пункты, содержащие вводимый текст
Ctrl-F10 — Позиционировать на активной панели в каталог и, по возможности, на файл текущего пункта истории
Ctrl-T — Переключение вида истории:
- с строками дат + колонка времени
- с строками дат (как в far3)
- просто история (как в far2)

В встроенном терминале (после скрытия обоих панелей по Ctrl-O):

Tab — Автодополнение (на основе FAR2L)
Shift-Tab-Tab — Автодополнение (на основе bash)
F3 или Ctrl+Shift+F3 или Ctrl+Shift+MouseScrollUp — Терминал->Просмотр
(вся история терминала в Просмотр — удобно для пролистывания длинного вывода)
F4 или Ctrl+Shift+F4 — Терминал->Редактор
(вся история вывода терминала в Редактор)
[в просмоторщик/редактор идёт временная копия терминала на момент нажатия F3 или F4
и может не включать дальнейшие изменения в терминале]
F8 — Очистка истории терминала и экрана
выделение мышью — сразу выделить и в буфер обмена
(внимание! в отличии от Alt-Ins не требует дальнейших действий,
а сразу при отпускании мыши закидывает в буфер обмена выделенный фрагмент
⇒ может быть нежданное затирание данных в буфере обмена)
Ctrl+Alt+Z — освобождение терминала = отправка в фон запущенной
в текущий момент в терминале команды (возврат через F12)

В редакторе:

Ctrl-Up или Ctrl-Down — Прокрутка экрана вверх / вниз
(текст в редакторе должен быть длиннее высоты экрана)
Ctrl-Left и Ctrl-Right — Перескок по словам влево/вправо
Ctrl-Shift-Left и Ctrl-Shift-Right — Пометка по словам влево/вправо
Alt+[стрелки/Home/End/PgUp/PgDown] — Пометка вертикального блока
Alt+Shift+[стрелки/Home/End/PgUp/PgDown] — Пометка вертикального блока
(Shift нужен, если используется NumLock клавиатура)
Alt-BS, Ctrl-Z — Undo
Ctrl-Shift-Z — Redo
Ctrl-L — Запретить модификацию редактируемого текста (полезно для просмотра с подсветкой синтаксиса)
F7 — Поиск
Shift-F7 — Продолжить поиск
Alt-F7 — Продолжить поиск в обратном направлении
Ctrl-Shift-B — Show/Hide status line
Shift-F2 — Сохранить файл как (с возможностью изменить кодировку, BOM, символы перевода строк и т.п.)
F5 — вкл/выкл отображения пробельных символов (пробелы, табуляции).
Ctrl-F5 — смена для вновь вводимых TAB режима ввода:
либо остаются TAB, либо меняются на заданное число пробелов
(настраиваются через Shift-F5 или F9/Alt-Shift-F9 или на основе файлов .editorconfig)
Ctrl-F — Вставить полное имя редактируемого файла (без экранирования)
Ctrl-[ и Ctrl-] — Вставить полный путь к текущему каталогу из левой или правой панели (без экранирования)
Ctrl-F10 — Позиционировать на активной панели в каталог и текущий редактируемый файл (без выхода из редактора)

• All assemblies currently posted on https://github.com/spvkgn/far2l-portable/releases and https://github.com/spvkgn/far2m-portable/releases are compiled based on TTY|Xi for the corresponding platform (aarch64, amd64, i386). In the assemblies, the options "single ESC press", "OSC 52 support" and "autosave settings" are enabled by default.

• Portable assembly is a file named far2l_<что-то-там>.run, which when launched is expanded into /tmpand then starts correctly linking relative paths to all libraries integrated into the archive

  • take <что-то-там>the corresponding output in your system command uname -m, i.e. far2l_$(uname -m).run.tar. For example,far2l_x86_64.run.tar
  • to run, either the file must have execution rights set chmod +x far2l_<что-то-там>.runor be run explicitly through sh ./far2l_<что-то-там>.run;
  • /tmpmust also be mounted in the system with the rights to execute files on it;
  • ./far2l_<что-то-там>.run --target ./far2l— launch with unpacking into a directory far2linstead of /tmp;
  • ./far2l_<что-то-там>.run --help— list of keys to launch the unpacker.

• Launching the portable version with parameters: it is necessary to specify the first parameter twice , that is far2l_<что-то-там>.run -- --nodetect=xi -cd /(the first empty parameter --refers to the archive itself, and then the subsequent keys are specified, passed inside to far2l).

• By default, it stores settings where and usual in ~/.config/far2l, but you can specify when running in the command line, for example, ./far2l_<что-то-там>.run -- -u $(pwd)/far2l_profileit will save all settings in the far2l_profile folder inside the current one.

• If you copied the expanded portable version , then in this case

  • it is MANDATORY to run the unpacked file ./far2lonly when the CURRENT DIRECTORY is the directory with ./far2l(otherwise relative paths will not work);
  • workaround - run via far2l.sh

    #!/bin/bash
    pushd "$(pwd)"
    cd "$(dirname "$0")"
    chmod +x lib/ld-linux
    chmod +x far2l
    chmod +x far2l_sudoapp
    chmod +x far2l_askpass
    find . -type f -iname "far-plug" -exec chmod +x {} ;
    find . -type f -iname ".broker" -exec chmod +x {} ;
    ./far2l
    popd

  The portable version carries its own bootloader, possibly different from the system one (because its own version of the C library is linked to it libc, and all other libraries used by the portable version are linked to it), and the path to the custom bootloader in the binary can only be specified relative to the current folder.