diff options
Diffstat (limited to '.vifm/vifm-help.txt')
| -rw-r--r-- | .vifm/vifm-help.txt | 3099 |
1 files changed, 0 insertions, 3099 deletions
diff --git a/.vifm/vifm-help.txt b/.vifm/vifm-help.txt deleted file mode 100644 index 61b50aa..0000000 --- a/.vifm/vifm-help.txt +++ /dev/null @@ -1,3099 +0,0 @@ -vifm(1) Vifm vifm(1) - - - -NAME - vifm - vi file manager - -SYNOPSIS - vifm [OPTION]... - vifm [OPTION]... LWIN_DIR - vifm [OPTION]... LWIN_DIR RWIN_DIR - -DESCRIPTION - Vifm is a ncurses based file manager with vi like keybindings. If you - use vi, vifm gives you complete keyboard control over your files with‐ - out having to learn a new set of commands. - -OPTIONS - The vifm executable will start vifm in the current directory unless it - is given a different directory on the command line. - - <lwinpath> - Starts Vifm in the specified path. - - <lwinpath> <rwinpath> - Starts Vifm in the specified paths. - - Specifying two directories triggers split view even when vifm was in - single-view mode on finishing previous session. To suppress this be‐ - haviour :only command can be put in the vifmrc file. - - When only one path argument is found on command-line, the left/top pane - is automatically set as the current view. - - Paths to files are also allowed in case you want vifm to start with - some archive opened. If you want to select file, prepend its path with - --select. - - -f only used from the vifm.vim script. The selected files are - written to $VIFM/vimfiles and vifm exits. - - --logging - Log some errors to $VIFM/log. Also /var/log/vifm-startup-log - (on *nix) and startup-log in the directory of executable (on - Windows) is used to log startup process (when configuration - directory isn't determined). - - --remote - Sends the rest of command line to the active vifm server (one of - already running instances if any). When there is no server, - quits silently. There is no limit on how many arguments can be - processed. One can combine --remote with -c <command> or +<com‐ - mand> to execute command in already running instance of vifm. - See also "Client-Server" section below. - - -c <command> or +<command> - Run command-line mode <command> on startup. Commands in such - arguments are executed in the order they appear in command line. - Commands with spaces or special symbols must be enclosed in dou‐ - ble or single quotes or all special symbols should be escaped - (the exact syntax strongly depends on shell). - - --help, -h - Show an overview of the commandline options. - - --version, -v - Show version information and quit. - - --no-configs - Don't read vifmrc and vifminfo. - - - See Startup section below for the explanations on $VIFM. - -General keys - Ctrl-C or Escape - cancel most operations. - - Ctrl-C or Escape - clear all selected files. - - Ctrl-L clear and redraw the screen. - -Basic Movement - The basic vi key bindings are used to move through the files and popup - windows. - - k, gk, or Ctrl-P - moves cursor up one line. - - j, gj or Ctrl-N - moves cursor down one line. - - h when 'lsview' is off moves up one directory, otherwise moves - left one file. - - l when 'lsview' is off moves into a directory or launches a file, - otherwise moves left one file. - - gg move to the top of the file list. - - gh moves up one directory. - - gl or Enter - moves into a directory or launches a file. - - G move to the bottom of the file list. - - H move to the first file in the window. - - M move to the file in the middle of the window. - - L move to the last file in the window. - - Ctrl-F or Page Down - move forward one page. - - Ctrl-B or Page Up - move back one page. - - Ctrl-D jump back one half page. - - Ctrl-U jump forward one half page. - - n% move to the file that is n percent from the top of the list (for - example 25%). - - 0 or ^ move cursor to the first column. See 'lsview' option descrip‐ - tion. - - $ move cursor to the last column. See 'lsview' option descrip‐ - tion. - - Space Bar - toggles between the two file lists. - -Movement with Count - Most movement commands also accept a count, 12j would move down 12 - files. - - [count]% - move to percent of the file list. - - [count]j - move down count files. - - [count]k - move up count files. - - [count]G or [count]gg - move to list position count. - -Scrolling panes - zt redraw pane with file in top of list. - - zz redraw pane with file in center of list. - - zb redraw pane with file in bottom of list. - - Ctrl-E scroll pane one line down. - - Ctrl-Y scroll pane one line up. - -Pane manipulation - Second character can be entered with or without Control key. - - Ctrl-W H - move the pane to the far left. - - Ctrl-W J - move the pane to the very bottom. - - Ctrl-W K - move the pane to the very top. - - Ctrl-W L - move the pane to the far right. - - Ctrl-W b - switch to bottom-right window. - - Ctrl-W h - switch to the left pane. - - Ctrl-W j - switch to the pane below. - - Ctrl-W k - switch to the pane above. - - Ctrl-W l - switch to the right pane. - - Ctrl-W o - shortcut for :only - - Ctrl-W p - switch to previous window. - - Ctrl-W s - shortcut for :split - - Ctrl-W t - switch to top-left window. - - Ctrl-W v - shortcut for :vsplit - - Ctrl-W w - switch to other pane. - - Ctrl-W x - exchange panes. - - [count1]Ctrl-W[count2]+ - increase size of the view by count1*count2. - - [count1]Ctrl-W[count2]- - decrease size of the view by count1*count2.. - - [count1]Ctrl-W[count2]< - increase size of the view by count1*count2.. - - [count1]Ctrl-W[count2]> - decrease size of the view by count1*count2.. - - Ctrl-W | - maximize current view. - - Ctrl-W _ - maximize current view. - - Ctrl-W = - make size of two views equal. - -Marks - Marks are set the same way as they are in vi. - - You can use this characters for marks [a-z][A-Z][0-9]. - - m[a-z][A-Z][0-9] - to set a mark for the current file. - - '[a-z][A-Z][0-9] - moves to the file set for the mark. - -Searching - /regular expression pattern[Return] - will highlight all files matching the pattern and go to the next - match. - - ?regular expression pattern[Return] - will highlight all files matching the pattern and go to the pre‐ - vious match. - - [count]n - find the next match of / or ?. - - [count]N - find the previous match of / or ?. - - If 'hlsearch' option is set, hitting n/N to perform search and go to - the first matching item resets current selection in normal mode. It is - not the case if search was already performed on files in the directory, - thus selection is not reset after clearing selection with escape key - and hitting n/N key again. - - [count]f[character] - search forward for file with [character] as first character in - name. Search wraps around the end of the list. - - [count]F[character] - search backward for file with [character] as first character in - name. Search wraps around the end of the list. - - [count]; - find the next match of f or F. - - [count], - find the previous match of f or F. - - Note: f, F, ; and , wrap around list beginning and end when they are - used alone and they don't wrap when they are used as selectors. - -File Filters - There are three basic file filters: - - - dot files filter (excluding "." and ".." special directories, which - appearance is controlled by the 'dotdirs' option) - - - manual filter for file names - - - automatic filter for file names - - - local filter for file names (see description of the "=" normal mode - command) - - Performing operations on manual filter for file names automatically - does the same on automatic one. The file name filter is separated - mainly for convenience purpose and to get more deterministic behaviour. - - The basic vim folding key bindings are used for filtering files. - - Each file list has its own copy of each filter. - - Filtered files are not checked in / search or :commands. - - Files and directories are filtered separately. For this a slash is - appended to a directory name before testing whether it matches the fil‐ - ter. Examples: - - " filter directories which names end with '.files' - :filter /^.*\.files\/$/ - - " filter files which names end with '.d' - :filter /^.*\.d$/ - - " filter files and directories which names end with '.o' - :filter /^.*\.o\/?$/ - - zo Show all of the dot files. - - zf Filter all of the selected files. - - za Toggle the showing and hiding of dot files. - - zm Filter all of the dot files. - - zO Show the files filtered out by filename filter. - - zM Filter the files matching the filename filter. - - zR Remove all filters. - - =regular expression pattern[Return] - filter out files that don't match regular expression. This kind - of filter is automatically reset when directory is changed. - -Other Normal Mode Keys - [count]: - enter command line mode. Count will add range. - - q: open external editor to prompt for command-line command. See - "Command line editing" section for details. - - q/ open external editor to prompt for search pattern to be searched - in forward direction. See "Command line editing" section for - details. - - q? open external editor to prompt for search pattern to be searched - in backward direction. See "Command line editing" section for - details. - - q= open external editor to prompt for filter pattern. See "Command - line editing" section for details. Unlike other q{x} commands - this one doesn't work in Visual mode. - - [count]!! and [count]!<selector> - enter command line mode with entered ! command. Count will mod‐ - ify range. - - Ctrl-O go backward through history. - - Ctrl-I if 'cpoptions' contains "t" flag, <tab> and <c-i> switch active - pane just like <space> does, otherwise it goes forward through - directory history of the current view. - - Ctrl-G creates a window showing detailed information about the current - file. - - Shift-Tab - enters view mode (works only after activating view pane with - :view command). - - ga calculate directory size. - - gA like ga, but force update. - - gf find link destination (like l with 'followlinks' off, but also - finds directories). - - gr only for MS-Windows - same as l key, but tries to run program with administrative - privileges. - - gv go to visual mode restoring last selection. - - gs restore last t selection, like gv for visual mode selection. - - gu<selector> - make names of selected files lowercase. - - [count]guu and [count]gugu - make names of [count] files starting from the current one lower‐ - case. Without [count] only current file is affected. - - gU<selector> - make names of selected files uppercase. - - [count]gUU and [count]gUgU - make names of [count] files starting from the current one upper‐ - case. Without [count] only current file is affected. - - e explore file in the current pane. - - i opens file with associated program even if it's an executable. - - cw rename a file or files. - - cW change only name of file (without extension). - - cl change link target. - - co only for *nix - change file owner. - - cg only for *nix - change file group. - - cp change file attributes (permission on *nix and properties on - Windows). - - [count]C - clone file [count] times. - - [count]dd or d[count]selector - moves the selected files to trash directory (if 'trash' option - is set, otherwise delete). See "Trash directory" section below. - - [count]DD or D[count]selector - removes the selected files. - - Y, [count]yy or y[count]selector - yanks the selected files. - - Y same as yy. - - p will copy the yanked files to the current directory or move the - files to the current directory if they were deleted with dd or - :d[elete] or if the files were yanked from trash directory. See - "Trash directory" section below. - - P moves the last yanked files. The advantage of using P instead - of d followed by p is that P moves files only once. This isn't - important in case you're moving files in the same file system - where your home directory is, but using P to move files on some - other file system (or file systems, in case you want to move - files from fs1 to fs2 and your home is on fs3) can save your - time. - - al puts symbolic links with absolute paths. - - rl puts symbolic links with relative paths. - - t select or unselect (tag) the current file. - - u undo last change. - - Ctrl-R redo last change. - - v enter visual mode. - - V enter visual mode. - - [count]Ctrl-A - increment first number in file name by count (1 by default). - - [count]Ctrl-X - decrement first number in file name by count (1 by default). - - ZQ same as :quit! - - ZZ same as :quit - - . repeat last command line command (not normal mode command) of - this session (does nothing right after startup or :restart com‐ - mand). The command doesn't depend on command-line history and - can be used with completely disabled history. - - ( goto previous group. Groups are defined by primary sorting key. - For name and iname members of each group have same first letter, - for all other sorting keys vifm uses size, uid, ... - - ) goto next group. See ( key description above. - -Using Count - You can use count with commands like yy. - - [count]yy - yank count files starting from current cursor position downward. - - Or you can use count with motions passed to y, d or D. - - d[count]j - delete (count + 1) files starting from current cursor position - upward. - -Registers - vifm supports multiple registers for temporary storing list of yanked - or deleted files. - - Registers should be specified with hitting double quite key followed by - a register name. Count is specified after register name. By default - commands use unnamed register, which has double quote as its name. - - Though all commands accept registers, most of commands ignores them - (for example H or Ctrl-U). Other commands can fill register or append - new files to it. - - Presently vifm supports ", _, a-z and A-Z characters as register names. - - As mentioned above " is unnamed register and has special meaning of the - default register. Every time when you use named registers (a-z and A- - Z) unnamed register is updated to contain same list of files as the - last used register. - - _ is black hole register. It can be used for writing, but its list is - always empty. - - Registers with names from a to z and from A to Z are named ones. Low‐ - ercase registers are cleared before adding new files, while uppercase - aren't and should be used to append new files to the existing file list - of appropriate lowercase register (A for a, B for b, ...). - - Registers can be changed on :empty command if they contain files under - trash directory (see "Trash directory" section below). - - Registers do not contain one file more than once. - - Example: - - "a2yy - - will put names of two files to register a (and to the unnamed regis‐ - ter), - - "Ad - - will remove one file and append its name to register a (and to the - unnamed register), - - p or "ap or "Ap - - will insert previously yanked and deleted files into current directory. - -Selectors - y, d, D, !, gu and gU commands accept selectors. You can combine them - with any of selectors below to quickly remove or yank several files. - - Most of selectors are like vi motions: j, k, gg, G, H, L, M, %, f, F, - ;, comma, ', ^, 0 and $. But there are some additional ones. - - a all files in current view. - - s selected files. - - S all files except selected. - - Examples: - dj - delete file under cursor and one below. - d2j - delete file under cursor and two below. - y6gg - yank all files from cursor position to 6th file in the list. - - When you pass a count to whole command and its selector they are multi‐ - plied. So: - 2d2j - delete file under cursor and four below. - 2dj - delete file under cursor and two below. - 2y6gg - yank all files from cursor position to 12th file in the list. - -Visual Mode - In visual mode work almost all normal mode keys, but they do not accept - selectors. - - Enter save selection and go back to normal mode. - - gv restore previous visual selection. - - v leave visual mode. - - V leave visual mode. - - : enter command line mode. When you leave it selection will be - cleared. - - o switch active selection bound. - - O switch active selection bound. - - gu, u make names of selected files lowercase. - - gU, U make names of selected files uppercase. - -View Mode - This mode tries to imitate the less program. List of builtin shortcuts - can be found below. Shortcuts can be customized using :qmap, :qnoremap - and :qunmap command-line commands. - - Shift-Tab, Tab, q, Q, ZZ - go back to normal mode. - - [count]e, [count]Ctrl-E, [count]j, [count]Ctrl-N, [count]Enter - forward one line (or [count] lines). - - [count]y, [count]Ctrl-Y, [count]k, [count]Ctrl-K, [count]Ctrl-P - backward one line (or [count] lines). - - [count]f, [count]Ctrl-F, [count]Ctrl-V, [count]Space Bar - forward one window (or [count] lines). - - [count]b, [count]Ctrl-B, [count]Alt-V - backward one window (or [count] lines). - - [count]z - forward one window (and set window to [count]). - - [count]w - backward one window (and set window to [count]). - - [count]Alt-Space - forward one window, but don't stop at end-of-file. - - [count]d, [count]Ctrl-D - forward one half-window (and set half-window to [count]). - - [count]u, [count]Ctrl-U - backward one half-window (and set half-window to [count]). - - r, Ctrl-R, Ctrl-L - repaint screen. - - R reload view preserving scroll position. - - [count]/pattern - search forward for ([count]‐th) matching line. - - [count]?pattern - search backward for ([count]‐th) matching line. - - [count]n - repeat previous search (for [count]‐th occurrence). - - [count]N - repeat previous search in reverse direction. - - [count]g, [count]<, [count]Alt-< - go to first line in file (or line [count]). - - [count]G, [count]>, [count]Alt-> - go to last line in file (or line [count]). - - [count]p, [count]% - go to beginning of file (or N percent into file). - - v edit the current file with vim. - - - Ctrl-W H - move the pane to the far left. - - Ctrl-W J - move the pane to the very bottom. - - Ctrl-W K - move the pane to the very top. - - Ctrl-W L - move the pane to the far right. - - - Ctrl-W h - switch to left pane. - - Ctrl-W j - switch to pane below. - - Ctrl-W k - switch to pane above. - - Ctrl-W l - switch to right pane. - - - Ctrl-W b - switch to bottom-right window. - - Ctrl-W t - switch to top-left window. - - - Ctrl-W p - switch to previous window. - - Ctrl-W w - switch to other pane. - - - Ctrl-W o - leave only one pane. - - Ctrl-W s - split window horizontally. - - Ctrl-W v - split window vertically. - - - Ctrl-W x - exchange panes. - - - Ctrl-W + - increase size of the view. - - Ctrl-W - - decrease size of the view. - - Ctrl-W < - increase size of the view. - - Ctrl-W > - decrease size of the view. - - Ctrl-W | - maximize current view. - - Ctrl-W _ - maximize current view. - - Ctrl-W = - make size of two views equal. - - - In general, all "Ctrl-W x" keys above work the same was as in Normal - mode. Active mode is automatically changed on navigating among win‐ - dows. When less-like mode activated on file preview is left using one - by "Ctrl-W x" keys, its state is stored until another file is showed - using preview (it's possible to leave the mode, hide preview pane, do - something else, then get back to the file and show preview pane again - with previously stored state in it). - -Command line Mode - This keys apply to all submodes of the command line mode: command, - prompt and search. - - Down, Up, Left, Right, Home, End and Delete are extended keys and they - are not available if vifm is compiled with --disable-extended-keys - option. - - Esc, Ctrl-C - leave command line mode, cancels input. Cancelled input is - saved into appropriate history and can be recalled later. - - Ctrl-M, Enter - execute command and leave command line mode. - - Ctrl-I, Tab - complete command or its argument. - - Shift-Tab - complete in reverse order. - - Ctrl-_ stop completion and return original input. - - Ctrl-K remove characters from cursor position till the end of line. - - Ctrl-U remove characters from cursor position till the beginning of - line. - - Ctrl-H, Backspace - remove character before the cursor. - - Ctrl-D, Delete - remove character under the cursor. - - Ctrl-B, Left - move cursor to the left. - - Ctrl-F, Right - move cursor to the right. - - Ctrl-A, Home - go to line beginning. - - Ctrl-E, End - go to line end - - Alt-B go to the beginning of previous word. - - Alt-F go to the end of next word. - - Ctrl-W remove characters from cursor position till the beginning of - previous word. - - Alt-D remove characters from cursor position till the beginning of - next word. - - Ctrl-T swap the order of current and previous character and move cursor - forward or, if cursor past the end of line, swap the order of - two last characters in the line. - - Alt-. insert last part of previous command to current cursor position. - Each next call will insert last part of older command. - - Ctrl-G edit command-line content in external editor. See "Command line - editing" section for details. - - Ctrl-N recall more recent command-line from history. - - Ctrl-P recall older command-line from history. - - Up recall more recent command-line from history, that begins as the - current command-line. - - Down recall older command-line from history, that begins as the cur‐ - rent command-line. - -Command line editing - vifm provides a facility to edit several kinds of data, that is usually - edited in command-line mode, in external editor (using command speci‐ - fied by ´vicmd' or 'vixcmd' option). This has at least two advantages - over built-in command-line mode: - - one can use full power of Vim to edit text; - - finding and reusing history entries becomes possible. - - The facility is supported by four input submodes of the command-line: - - command; - - forward search; - - backward search; - - file rename (see description of cw and cW normal mode keys). - - Editing command-line using external editor is activated by the c_CTRL-G - shortcut. It's also possible to do almost the same from Normal and - Visual modes using q:, q/ and q? commands. - - Temporary file created for the purpose of editing the line has the fol‐ - lowing structure: - - 1. First line, which is either empty or contains text already entered - in command-line. - - 2. 2nd and all other lines with history items starting with the most - recent one. Altering this lines in any way won't change history - items stored by vifm. - - After editing application is finished the first line of the file is - taken as the result of operation, when the application returns zero - exit code. If the application returns an error (see :cquit command in - Vim), all the edits made to the file are ignored, but the initial value - of the first line is saved in appropriate history. - -Commands - Commands are executed with :command_name<Return> - - Commented out lines should start with the double quote symbol, which - may be preceded by whitespace characters. - - ´|' can be used to separate commands, so you can give multiple commands - in one line. If you want to use '|' in an argument, precede it with - '\'. - - These commands see '|' as part of their arguments even when it's - escaped: - - :[range]! - :cmap - :cnoremap - :command - :filetype - :fileviewer - :filextype - :map - :mmap - :mnoremap - :nmap - :nnoremap - :noremap - :normal - :qmap - :qnoremap - :vmap - :vnoremap - :windo - :winrun - - To be able to use another command after one of these, wrap it with the - :execute command. An example: - if filetype('.') == 'reg' | execute '!!echo regular file' | endif - - :[count] - - :number - move to the file number. - :12 would move to the 12th file in the list. - :0 move to the top of the list. - :$ move to the bottom of the list. - - :[count]command - The only builtin :[count]command are :[count]d[elete] and - :[count]y[ank]. - - :d3 would delete three files starting at the current file position - moving down. - - :3d would delete one file at the third line in the list. - - :command [args] - - :[range]!program - will execute the program in a shell - - :[range]!command & - - will run the process in the background using vifm's means. - - Programs that write to stdout like ls will create an error message - showing partial output of the command. - - Take note of the space before ampersand symbol, if you omit it, command - will be run in the background using job control of your shell. - - Accepts macros. - - :[range]!! <program> - is the same as :! but will pause the screen before returning to - Vifm. - - :!! will execute the last command. - - :[range]alink[!?] - creates absolute symbolic links of files in directory of other - view. With "?" vifm will open vi to edit filenames. "!" - forces overwrite. - - :[range]alink[!] path - creates absolute symbolic links of files in directory specified - with the path (absolute or relative to directory of other view). - "!" forces overwrite. - - :[range]alink[!] name1 name2... - creates absolute symbolic links of files in directory of other - view giving each next link a corresponding name from the argu‐ - ment list. "!" forces overwrite. - - :apropos manpage - will create a menu of items returned by the apropos command. - Selecting an item in the menu will open the corresponding man‐ - page. By default the command relies on the external "apropos" - utility, which can be customized by altering value of the 'apro‐ - posprg' option. - - :apropos - repeats last :apropos command. - - :cd or :cd ~ or :cd $HOME - change to your home directory. - - :cd - go to previous directory. - - :cd ~/dir - change directory to ~/dir. - - :cd /curr/dir /other/dir - change directory of the current pane to /curr/dir and directory - of the other pane to /other/dir. When using relative paths vifm - assumes that both of them are relative to current directory of - current view. Command will not fail if one of directories is - invalid. Accepts macros. - - :cd! /dir - same as :cd /dir /dir. - - :c[hange] - create a menu window to alter a files properties. - - :[range]chmod - shows file attributes (permission on *nix and properties on Win‐ - dows) change dialog. - - :[range]chmod[!] arg... - only for *nix - changes permissions for files. See 'man chmod' for arg format. - "!" means set permissions recursively. - - :[range]chown - only for *nix - same as co key in normal mode. - - :[range]chown [user][:][group] - only for *nix - changes owner and/or group of files. Operates on directories - recursively. - - :[range]clone[!?] - clones files in current directory. With "?" vifm will open vi - to edit filenames. "!" forces overwrite. Macros are expanded. - - :[range]clone[!] path - clones files to directory specified with the path (absolute or - relative to current directory). "!" forces overwrite. Macros - are expanded. - - :[range]clone[!] name1 name2... - clones files in current directory giving each next clone a cor‐ - responding name from the argument list. "!" forces overwrite. - Macros are expanded. - - :colo[rscheme]? - prints current color scheme name in the status bar. - - :colo[rscheme] - gives a menu with a list of available color schemes. You can - choose default color scheme here. It will be used for view if - no DIRECTORY in colorscheme file fits current path. It's also - used to set border color (except view titles) and colors in the - menus and dialogs. - - :colo[rscheme] color_scheme_name - changes default color scheme to color_scheme_name. - - :colo[rscheme] color_scheme_name directory - associates directory with the color scheme. The directory argu‐ - ment can be both absolute or relative path when :colorscheme - command is executed from command line, but mandatory should be - an absolute path when the command is executed in scripts loaded - at startup (until vifm is completely loaded). - - :comc[lear] - removes all user defined commands. - - :com[mand] - gives a menu of user commands. - - :com[mand] beginning - shows user defined commands that start with the beginning. - - :com[mand] name action - sets a new user command. - Trying to use a reserved command name will result in an error - message. - Use :com[mand]! to overwrite a previously set command. - Unlike vim user commands do not have to start with a capital - letter. User commands are run in a shell by default. To run a - command in the background you must set it as a background com‐ - mand with & at the end of the commands action (:com rm rm %f &). - Command name cannot contain numbers or special symbols (except - '?' and '!'). - - :com[mand] name /pattern - will set search pattern. - - :com[mand] name filter pattern - will set file name filter. - - :com[mand] cmd :commands - will set kind of alias for internal command (like in a shell). - Will pass range given to alias to an aliased command, so running - :%cp after - :command cp :copy %a - equals - :%copy - - :[range]co[py][!?][ &] - copies files to directory of other view. With "?" vifm will - open vi to edit filenames. "!" forces overwrite. - - :[range]co[py][!] path[ &] - copies files to directory specified with the path (absolute or - relative to directory of other view). "!" forces overwrite. - - :[range]co[py][!] name1 name2...[ &] - copies files to directory of other view giving each next file a - corresponding name from the argument list. "!" forces over‐ - write. - - :[range]d[elete][!][ &] - delete selected file or files. "!" means completely remove - file. - - :[range]d[elete][!] [reg] [count][ &] - will delete files to the reg register. "!" means completely - remove file. - - :delc[ommand] command_name - will remove the command_name user command. - - :delm[arks]! - will delete all marks. - - :delm[arks] marks ... - will delete specified marks, each argument is treated as a set - of marks. - - :di[splay] - popup menu with registers content. - - :di[splay] list ... - display the contents of the numbered and named registers that - are mentioned in list (for example "az to display "", "a and "z - content). - - :dirs display directory stack. - - :ec[ho] [<expr>...] - evaluates each argument as an expression and outputs them sepa‐ - rated by a space. See help on :let command for a definition of - <expr>. - - :[range]e[dit] [file...] - will load the selected or passed file or files into vi. Accepts - macros. - - :el[se] - executes commands until next matching :endif if they previously - were not being executed. See also help on :if and :endif com‐ - mands. - - :empty will permanently remove 'rm -fr' files from trash directory. It - will also remove all operations from undolist that have no sense - after :empty and remove all records about files in trash direc‐ - tory from all registers. See "Trash directory" section below. - - :en[dif] - ends conditional block. See also help on :if and :else com‐ - mands. - - :exe[cute] [<expr>...] - evaluates each argument as an expression and joins results sepa‐ - rated by a space to get a single string, which is then executed - as a command-line command. See help on :let command for a defi‐ - nition of <expr>. - - :exi[t][!] - same as :quit. - - :f[ile] - popup menu of programs set for the file type of the current - file. Add ' &' at the end of command to run program in back‐ - ground. - - :f[ile] arg - run associated command that begins with the arg without opening - menu. - - :filet[ype] pat1,pat2,... [{descr}]def_prog[ &],[{descr}]prog2[ &],... - will associate given program list to each of the patterns. - Associated program (command) is used by handlers of l and Enter - keys (and also in the :file menu). If you need to insert comma - into command just double it (",,"). Space followed by an amper‐ - sand as two last characters of a command means running of the - command in the background. Optional description can be given to - each command to ease understanding of what command will do in - the :file menu. Vifm will try the rest of the programs for an - association when the default isn't found. When program entry - doesn't contain any of vifm macros, name of current file is - appended as if program entry ended with %c macro. On Windows - path to executables containing spaces can (and should be for - correct work with such paths) be double quoted. See "Globs" - section below for pattern definition. See also "Automatic FUSE - mounts" section below. Example for zip archives and several - actions: - - filetype *.zip,*.jar,*.war,*.ear - \ {Mount with fuse-zip} - \ FUSE_MOUNT|fuse-zip %SOURCE_FILE %DESTINATION_DIR, - \ {View contents} - \ zip -sf %c | less, - \ {Extract here} - \ tar -xf %c, - - :filex[type] pat1,pat2,... [{ description }] def_program,program2,... - same as :filetype, but vifm will ignore this command if it's not running in X. - In X :filextype is equal to :filetype. See "Globs" section below for pattern - definition. See also "Automatic FUSE mounts" section below. - - :filev[iewer] pat1,pat2,... command - will associate given command as a viewer to each of the patterns. Viewer is a - command which output is captured and showed in the second pane of vifm after - running :view command. When the command doesn't contain any of vifm macros, - name of current file is appended as if command ended with %c macro. See - "Globs" section below for pattern definition. Example for zip archives: - - fileviewer *.zip,*.jar,*.war,*.ear zip -sf %c - - :filter[!] regular_expression_pattern - :filter[!] /regular_expression_pattern/ - will filter all the files out of the directory listing that match the regular - expression. Using second variant you can use the bar ('|') symbol without - escaping. Empty regular expression (specified by //, "" or '') means using of - the last search pattern. Use '!' to control state of filter inversion after - updating filter value (also see 'cpoptions' description). Filter is matched - case sensitively on *nix and case insensitively on Windows. - :filter /.o$ would filter all files ending in .o from the filelist. - Note: vifm uses extended regular expressions. - - :filter - reset filter (set it to empty string) and show all files. - - :filter! - same as :invert. - - :filter? - show current value of name and auto filters. - - :[range]fin[d] pattern - will show results of find command in the menu. Searches among selected files if - any. Accepts macros. By default the command relies on the external "find" - utility, which can be customized by altering value of the 'findprg' option. - - :[range]fin[d] -opt... - same as :find above, but user defines all find arguments. Searches among - selected files if any. - - :[range]fin[d] path -opt... - same as :find above, but user defines all find arguments. Ignores selection and - range. - - :[range]fin[d] - repeats last :find command. - - :fini[sh] - Stop sourcing a script. Can only be used in a vifm script file. This is a quick - way to skip the rest of the file. - - :[range]gr[ep][!] pattern - will show results of grep command in the menu. Add "!" to request inversion of - search (look for lines that do not match pattern). Searches among selected - files if any and no range given. Ignores binary files by default. By default - the command relies on the external "grep" utility, which can be customized by - altering value of the 'grepprg' option. - - :[range]gr[ep][!] -opt... - same as :grep above, but user defines all find arguments, which are not escaped. - Searches among selected files if any. - - :[range]gr[ep][!] - repeats last :grep command. "!" of this command inverts "!" in repeated - command. - - :h[elp] - show the help file. - - :h[elp] argument - is the same as using ':h argument' in vim. Use vifm-<something> to get help - on vifm (tab completion works). This form of the command doesn't work when - ´vimhelp' option is off. - - :hi[ghlight] - will show information about all highlight groups in the current directory. - - :hi[ghlight] group-name - will show information on given highlight group of the default color scheme. - - :hi[ghlight] group-name cterm=style | ctermfg=color | ctermbg=color - sets style (cterm), foreground (ctermfg) or/and background (ctermbg) parameters - of highlight groups of the current default color scheme. - - Available style values (some of them can be combined): - - bold - - underline - - reverse or inverse - - standout - - none - - Available group-name values: - - Win - color of all windows (views, dialogs, menus) - - Border - color of vertical parts of the border - - TopLineSel - top line color of the current pane - - TopLine - top line color of the other pane - - CmdLine - the command line/status bar color - - ErrorMsg - color of error messages in the status bar - - StatusLine - color of the line above the status bar - - WildMenu - color of the wild menu items - - CurrLine - line at cursor position in the view - - Selected - color of selected files - - Directory - color of directories - - Link - color of symbolic links in the views - - BrokenLink - color of broken symbolic links - - Socket - color of sockets - - Device - color of block and character devices - - Executable - color of executable files - - Fifo - color of fifo pipes - - Available colors: - - -1 or default or none - default or transparent - - black - - red - - green - - yellow - - blue - - magenta - - cyan - - white - - Light versions of colors are regular colors with bold attribute set. So order - of arguments of :highlight command is important and it's better to put "cterm" - in front of others to prevent it from overwriting attributes set by "ctermfg" or - "ctermbg" arguments. - - Since there are two colors and only one bold attribute it affects both colors - when "reverse" attribute is used when running vifm in terminal emulator. While - linux native console can handle boldness of foreground and background colors - independently, which is for consistency with terminal emulators accessible from - vifm only implicitly by using light versions of colors. - - Here is the hierarchy of highlight groups, which you need to know for using - transparency: - StatusLine - WildMenu - Border - CmdLine - ErrorMsg - Win - Directory - Link - BrokenLink - Socket - Device - Fifo - Executable - Selected - CurrLine - TopLine - TopLineSel - - "none" means default terminal color for highlight groups at the first level of - the hierarchy and transparency for all others. - - :his[tory] - creates a popup menu of directories visited. - - :his[tory] x - x can be: - d[ir] or . show directory history. - c[md] or : show command line history. - s[earch] or / show search history and search forward on l key. - f[search] or / show search history and search forward on l key. - b[search] or ? show search history and search backward on l key. - i[nput] or @ show prompt history (e.g. on one file renaming). - fi[lter] or = show filter history (see description of the "=" normal mode command). - - :if {expr1} - starts conditional block. Commands are executed until next matching :else of - :endif command if {expr1} evaluates to non-zero, otherwise they are ignored. - See also help on :else and :endif commands. - - :invert [f] - invert file name filter. - - :invert? [f] - show current filter state. - - :invert s - invert selection. - - :invert o - invert sorting order of the primary sorting key. - - :invert? o - show sorting order of the primary sorting key. - - :jobs shows menu of current backgrounded processes. - - :let $ENV_VAR = <expr> - sets environment variable. Warning: setting environment variable to an empty - string on Windows removes it. - - :let $ENV_VAR .= <expr> - append value to environment variable. - - Where <expr> could be a single-quoted string, double-quoted string, an environment variable, function call or a concatanation of any of them in any order using the '.' operator. Any whitespace is ignored. - - :locate filename - uses the locate command to create a menu of filenames - Selecting a file from the menu will reload the current file list in vifm - to show the selected file. By default the command relies on the external - "locate" utility (it's assumed that its database is already built), which can be - customized by altering value of the 'locateprg' option. - - :locate - repeats last :locate command. - - :[range]ma[rk][?] x [/full/path] [filename] - Set mark x (a-zA-Z0-9) at /full/path and filename. By default current directory - is being used. If no filename was given and /full/path is current directory - then last file in [range] is used. Using of macros is allowed. Question mark - will stop command from overwriting existing marks. - - :marks create a popup menu of bookmarks. - - :marks list ... - display the contents of the marks that are mentioned in list. - - :mes[sages] - shows previously given messages (up to 50). - - :mkdir[!] dir ... - creates directories with given names. "!" means make parent directories as - needed. Macros are expanded. - - :[range]m[ove][!?][ &] - moves files to directory of other view. With "?" vifm will open vi to edit - filenames. "!" forces overwrite. - - :[range]m[ove][!] path[ &] - moves files to directory specified with the path (absolute or relative to - directory of other view). "!" forces overwrite. - - :[range]m[ove][!] name1 name2...[ &] - moves files to directory of other view giving each next file a corresponding - name from the argument list. "!" forces overwrite. - - :noh[lsearch] - clear selection in current pane. - - :norm[al][!] commands - executes normal mode commands. If "!" is used, mappings will not be used. If - the last command is unfinished it will be aborted as if <esc> or <c-c> was - typed. A ":" should be completed as well. Commands can't start with a space, - so put a count of 1 (one) before it. - - :on[ly] - changes the window to show only the current file directory. - - :popd remove pane directories from stack. - - :pushd[!] /curr/dir [/other/dir] - add pane directories to stack and process arguments like :cd command. - - :pushd exchanges the top two items of the directory stack. - - :pw[d] show the present working directory. - - :q[uit][!] - will exit vifm (add ! if you don't want to save changes or check if there are - any of backgrounded commands still running). - - :[range]y[ank] [reg] [count] - will yank files to the reg register. - - :ls lists windows of active terminal multiplexer (only when terminal multiplexer is - used). This is achieved by issuing proper command for active terminal - multiplexer, thus the list is not handled by vifm. - - :reg[isters] - popup menu with registers content. - - :reg[isters] list ... - display the contents of the numbered and named registers that are mentioned in - list (for example "az to display "", "a and "z content). - - :[range]rename[!] - rename files using vi to edit names. ! means go recursively through directories. - - :[range]rename name1 name2... - rename each of selected files to a corresponding name. - - :restart - will free a lot of things (histories, commands, etc.), reread vifminfo and - vifmrc files and run startup commands passed in the argument list, thus losing - all unsaved changes (e.g. recent history or keys mapped in current session). - - :[range]restore - will restore file from trash directory, doesn't work in any other directory. - See "Trash directory" section below. - - :[range]rlink[!?] - creates relative symbolic links of files in directory of other view. With "?" - vifm will open vi to edit filenames. "!" forces overwrite. - - :[range]rlink[!] path - creates relative symbolic links of files in directory specified with the path - (absolute or relative to directory of other view). "!" forces overwrite. - - :[range]rlink[!] name1 name2... - creates relative symbolic links of files in directory of other view giving each - next link a corresponding name from the argument list. "!" forces overwrite. - - :screen - toggles whether to use the terminal multiplexer or not. - A terminal multiplexer uses pseudo terminals to allow multiple windows to be - used in the console or in a single xterm. Starting vifm from terminal - multiplexer with appropriate support turned on will cause vifm to open a new - terminal multiplexer window for each new file edited or program launched from - vifm. - This requires screen version 3.9.9 or newer for the screen -X argument or tmux - (version or newer 1.8 is recommented). - - :screen? - shows whether integration with terminal multiplexers is enabled. - - Note: the command is called screen for historical reasons (when tmux wasn't yet - supported) and might be changed in future releases, or get an alias. - - :se[t] shows all options that differ from their default value. - - :se[t] all - shows all options. - - :se[t] opt1=val1 opt2='val2' opt3="val3" ... - will set options to given values. - You can use following syntax: - - for all options - option, option? and option& - - for boolean options - nooption, invoption and option! - - for integer options - option=x, option+=x and option-=x - - for string options - option=x - - for string list options - option=x, option+=x and option-=x - - for enumeration options - option=x, option+=x and option-=x - - for enumeration options - option=x - - for set options - option=x, option+=x and option-=x - - for charset options - option=x, option+=x and option-=x - - the meaning: - - option - turn option on (for boolean) or print its value (for all others) - - nooption - turn option off - - invoption - invert option state - - option! - invert option state - - option? - print option value - - option& - reset option to its default value - - option=x or option:x - set option to x - - option+=x - add x to option - - option-=x - remove (or subtract) x from option - - Option name can be prepended and appended by any number of whitespace - characters. - - :sh[ell] - will start a shell. - - :sor[t] - creates a popup menu of different sorting methods, when one can select primary - sorting key. When 'viewcolumns' options is empty and 'lsview' is off, changing - primary sorting key will also affect view look (in particular the second column - of the view will be changed). - - :so[urce] file - reads command-line commands from the file. - - :sp[lit] - switch to a two window horizontal view. - - :sp[lit]! - toggles window horizontal splitting. - - :sp[lit] path - splits the window horizontally to show both file directories. And changes other - pane to path (absolute or relative to current directory of active pane). - - :[range]s[ubstitite]/pattern/string/[flags] - for each file in range replace a match of pattern with string. - - String can contain \0...\9 to link to capture groups (\0 - all match, \1 - - first group, etc.). - - Available flags: - - - i - ignore case (the 'ignorecase' and 'smartcase' options are not used) - - - I - don't ignore case (the 'ignorecase' and 'smartcase' options are not used) - - - g - substitute all matches in each file name (each g toggles this) - - :[range]s[ubstitute]//string/[flags] - will use previous pattern. - - :[range]s[ubstitute] - will repeat previous substitution command. - - :sync [relative path] - change the other panel to the current panel directory or to some path relative - to the current directory. Using macros is allowed. - - :sync! - change the other panel to the current panel directory and synchronize cursor - position. - - :touch file... - will create files. Aborts on errors and won't update time of existing files. - Macros are expanded. - - :[range]tr/pattern/string/ - for each file in range transliterate the characters which appear in pattern to - the corresponding character in string. When string is shorter than pattern, - it's padded with its last character. - - String can contain ...9 to link to capture groups (0 - all match, 1 - first - group, etc.). - - :undol[ist] - show list of latest changes. Add ! to see commands. - - :unl[et][!] $ENV_VAR1 $ENV_VAR2 ... - remove environment variables. Add ! to omit displaying of warnings about - nonexistent variables. - - :ve[rsion] - show menu with version information. - - :vifm same as :version. - - :vie[w] - toggle on and off the quick file view. - - :vie[w]! - turns on quick file view if it's off. - - :volumes - only for MS-Windows - will popup menu with volume list. Hitting l (or Enter) key will open - appropriate volume in the current pane. - - :vs[plit] - switch to a two window vertical view. - - :vs[plit]! - toggles window vertical splitting. - - :vs[plit] path - splits the window vertically to show both file directories. And changes other - pane to path (absolute or relative to current directory of active pane). - - :windo [command...] - Execute command for each pane (same as :winrun % command). - - :winrun type [command...] - Execute command for pane(s), which is determined by type argument: - - ^ - top-left pane - - $ - bottom-right pane - - % - all panes - - . - current pane - - , - other pane - - :w[rite] - write vifminfo file (add ! to force write even if settings weren't changed). - - :wq[!] same as :quit, but ! only disables check of backgrounded commands. - - :x[it][!] - will exit Vifm (add ! if you don't want to save changes). - - - :map lhs rhs - map lhs key sequence to rhs in normal and visual modes. - - :map! lhs rhs - map lhs key sequence to rhs in command line mode. - - - :cm[ap] lhs rhs - map lhs to rhs in command line mode. - - :mm[ap] lhs rhs - map lhs to rhs in menu mode. - - :nm[ap] lhs rhs - map lhs to rhs in normal mode. - - :qm[ap] lhs rhs - map lhs to rhs in view mode. - - :vm[ap] lhs rhs - map lhs to rhs in visual mode. - - - :cm[ap] - lists all maps in command line mode. - - :mm[ap] - lists all maps in menu mode. - - :nm[ap] - lists all maps in normal mode. - - :qm[ap] - lists all maps in view mode. - - :vm[ap] - lists all maps in visual mode. - - - :cm[ap] beginning - lists all maps in command line mode that start with the beginning. - - :mm[ap] beginning - lists all maps in menu mode that start with the beginning. - - :nm[ap] beginning - lists all maps in normal mode that start with the beginning. - - :qm[ap] beginning - lists all maps in view mode that start with the beginning. - - :vm[ap] beginning - lists all maps in visual mode that start with the beginning. - - - :no[remap] lhs rhs - map the key sequence lhs to {rhs} for normal and visual modes, but disallow - mapping of rhs. - - :no[remap]! lhs rhs - map the key sequence lhs to {rhs} for command line mode, but disallow mapping of - rhs. - - - :cno[remap] lhs rhs - map the key sequence lhs to {rhs} for command line mode, but disallow mapping of - rhs. - - :mn[oremap] lhs rhs - map the key sequence lhs to {rhs} for menu mode, but disallow mapping of rhs. - - :nn[oremap] lhs rhs - map the key sequence lhs to {rhs} for normal mode, but disallow mapping of rhs. - - :qn[oremap] lhs rhs - map the key sequence lhs to {rhs} for view mode, but disallow mapping of rhs. - - :vn[oremap] lhs rhs - map the key sequence lhs to {rhs} for visual mode, but disallow mapping of rhs. - - - :unm[ap] lhs - remove the mapping of lhs from normal and visual modes. - - :unm[ap]! lhs - remove the mapping of lhs from command line mode. - - - :cu[nmap] lhs - remove the mapping of lhs from command line mode. - - :mu[nmap] lhs - remove the mapping of lhs from menu mode. - - :nun[map] lhs - remove the mapping of lhs from normal mode. - - :qun[map] lhs - remove the mapping of lhs from view mode. - - :vu[nmap] lhs - remove the mapping of lhs from visual mode. - -Ranges - The ranges implemented include: - 2,3 - from second to third file in the list (including it) - % - the entire directory. - . - the current position in the filelist. - $ - the end of the filelist. - 't - the mark position t. - - Examples: - - :%delete - - would delete all files in the directory. - - :2,4delete - - would delete the files in the list positions 2 through 4. - - :.,$delete - - would delete the files from the current position to the end of the - filelist. - - :3delete4 - - would delete the files in the list positions 3, 4, 5, 6. - - If a backward range is given :4,2delete - an query message is given and - user can chose what to do next. - - The builtin commands that accept a range are :d[elete] and :y[ank]. - -Command macros - The command macros may be used in user commands. - - %a User arguments. When user arguments contain macros, they are - expanded before preforming substitution of %a. - - %c %"c The current file under the cursor. - - %C %"C The current file under the cursor in the other directory. - - %f %"f All of the selected files. - - %F %"F All of the selected files in the other directory list. - - %b %"b Same as %f %F. - - %d %"d Full path to current directory. - - %D %"D Full path to other file list directory. - - %rx %"rx - Full paths to files in the register {x}. In case of invalid - symbol in place of {x}, it's processed with the rest of the line - and default register is used. - - %m Show command output in a menu. - - %M Same as %m, but l (or Enter) key is handled like for :locate and - :find commands. - - %S Show command output in the status bar. - - %s Execute command in split window of active terminal multiplexer - (ignored if not running inside one). - - %i Completely ignore command output. - - Use %% if you need to put a percent sign in your command. - - Note that %m, %M, %s, %S and %i macros are mutually exclusive. Only the - last one of them in the command will take effect. - - You can use filename modifiers after %c, %C, %f, %F, %b, %d and %D - macros. Supported modifiers are: - - - :p - full path - - - :u - UNC name of path (e.g. "\\server" in - "\\server\share"), Windows only. Expands to current computer name - for not UNC paths. - - - :~ - relative to the home directory - - - :. - relative to current directory - - - :h - head of the filename - - - :t - tail of the filename - - - :r - root of the filename (without last extension) - - - :e - extension of the filename (last one) - - - :s?pat?sub? - substitute the first occurrence of pat with sub. You - can use any character for '?', but it must not occur in pat or sub. - - - :gs?pat?sub? - like :s, but substitutes all occurrences of pat with - sub. - - See ':h filename-modifiers' in Vim's documentation for the detailed - description. - - Using %x means expand corresponding macro escaping all characters - that have special meaning. And %"x means using of double quotes and - escape only backslash and double quote characters, which is more use‐ - ful on Windows systems. - - Position and quantity (if there is any) of %m, %M, %S or %s macros in - the command is unimportant. All their occurrences will be removed - from the resulting command. - - %c and %f macros are expanded to file names only, when %C and %F are - expanded to full paths. %f and %F follow this in %b too. - - :com move mv %f %D - would set the :move command to move all of the files selected in the - current directory to the other directory. - - The %a macro will substitute any arguments given in a command into the - command. All arguments are considered optional. ":com lsl !!ls -l %a" - will set the lsl command to execute ls -l with or without an argument. - - :lsl<Return> - will list the directory contents of the current directory. - - :lsl filename<Return> - will list only the given filename. - - The macros can also be used in directly executing commands. ":!mv %f - %D" would move the current directory selected files to the other direc‐ - tory. - - Appending & to the end of a command will cause it to be executed in the - background.Typically you want to run two kinds of external commands in - thebackground: - - GUI applications that doesn't fork thus block vifm (:!sxiv %f &); - - console tools that do not work with terminal (:!mv %f %D &). - - You don't want to run terminal commands, which require terminal input - oroutput something because they will mess up vifm's TUI. Anyway, if you - did runsuch a command, you can use Ctrl-L key to update vifm's TUI. - - Rewriting the example command with macros given above with background‐ - ing: - - :!mv %f %D & - - Note that %m, %M, %s, %S and %i macros have bigger priority than &. So - command containing at least one of them can't be backgrounded and " &" - at the end will be just silently ignored. - -Command backgrounding - Copy and move operation can take a lot of time to proceed. That's why - vifm supports backgrounding of this two operations. To run :copy, - :move or :delete command in the background just add " &" at the end of - a command. - - For each background operation a new thread will be created. Currently - job cannot be stopped or paused. - - You can see if command is still running in the :jobs menu. Back‐ - grounded commands have progress instead of process id at the line - beginning. - - Background operations cannot be undone. - -Globs - :filetype, :filextype and :fileviewer commands support globs to match - file names. Here is a short overview of globs and some important - points that one needs to know about them. - - Only names of files are matched by the globs, not full paths. E.g. - :filetype Makefile make %c - will match files with name "Makefile" regardless whether it's in root - or home directory. - - *, ?, [ and ] are treated as special symbols in the pattern. E.g. - :filetype * less %c - matches all files. One can use character classes for escaping, so - :filetype [*] less %c - matches only one file name, the one which contains only asterisk sym‐ - bol. - - * means any number of any characters (possibly an empty substring), - with one exception: asterisk at the pattern beginning doesn't match dot - in the first position. E.g. - :fileviewer *.zip,*.jar zip -sf %c - associates using of zip program to preview all files with zip or jar - extensions as listing of their content. - - ? means any character at this position. E.g. - :fileviewer ?.out file %c - calls file tool for all files which has exactly one character before - their extension (e.g. a.out, b.out). - - Square brackets designate character class, which means that whole char‐ - acter class matches against any of characters listed in it. For exam‐ - ple - :fileviewer *.[ch] highlight -O xterm256 -s dante --syntax c %c - makes vifm call highlight program to colorize source and header files - in C language for a 256-color terminal. Equal command would be - :fileviewer *.c,*.h highlight -O xterm256 -s dante --syntax c %c - - Inside square brackets ^ or ! can be used for symbol class negotiation - and the - symbol to set a range. ^ and ! should appear right after the - opening square bracket. For example - :filetype *.[!d]/ inspect_dir - associates inspect_dir as additional handler for all directories that - have one character extension unless it's "d" letter. And - :filetype [0-9].jpg sxiv - associates sxiv picture viewer only for JPEG-files that contain single - digit in their name. - -:set options - Local options - These are kind of options that are local to a specific view. So - you can set ascending sorting order for left pane and descending - order for right pane. - - aproposprg - type: string - default: "apropos %a" - Specifies format for an external command to be invoked by the - :apropos command. The format supports expanding of macros, spe‐ - cific for a particular *prg option, and %% sequence for insert‐ - ing percent sign literally. This option should include the %a - macro to specify placement of arguments passed to the :apropos - command. If the macro is not used, it will be implicitly added - after a space to the value of this option. - - autochpos - type: boolean - default: true - When disabled vifm will set cursor to the first line in the view - after :cd and :pushd commands instead of saved cursor position. - Disabling this will also make vifm clear information about cur‐ - sor position in the view history on :cd and :pushd commands (and - on startup if autochpos is disabled in the vifmrc). l key in - the :history . menu is treated like :cd command. This option - affects bookmarks, file position will not preserved. - - columns co - type: int - default: terminal width on startup - Terminal width in characters. - - classify - type: string list - default: ":dir:/" - Specifies file name prefixes and suffixes depending on file - types. The format is: [{prefix}]:{filetype}:[{suffix}]. Either - {prefix} or {suffix} or both of them can be omitted (which is - the default for all unspecified file types), this means empty - {prefix} and/or {suffix}. {prefix} and {suffix} should consist - exactly of one character. Elements are separated by commas. - Neither prefixes nor suffixes are part of file names, so they - don't affect commands which operate on file names in any way. - Comma (',') character should not be used. List of file type - names can be found in the description of filetype() function. - - confirm cf - type: boolean - default: true - Ask about permanent deletion of files (on D or :delete! command - or on undo/redo operation). - - cpoptions cpo - type: charset - default: "fst" - Contains a sequence of single-character flags. Each flag - enables behaviour of older versions of vifm. Flags: - f - when included, running :filter command results in not - inverted (matching files are filtered out) and :filter! in - inverted (matching files are left) filter, when omitted, meaning - of the exclamation mark changes to the opposite; - s - when included, yy, dd and DD normal mode commands act on - selection, otherwise they operate on current file only; - t - when included, <tab> (thus <c-i>) behave as <space> and - switch active pane, otherwise <tab> and <c-i> go forward in the - view history. - - dotdirs - type: set - default: nonrootparent - Controls displaying of dot directories. The following values - are possible: - - rootparent - show "../" in root directory of file system - - nonrootparent - show "../" in non-root directories of file - system - Note that empty directories will always contain "../" entry - regardless of value of this option. "../" will disappear at the - moment at least one file is created inside the directory. - - fastrun - type: boolean - default: false - With this option turned on you can run partially entered com‐ - mands with unambiguous beginning using :! (e.g. :!Te instead of - :!Terminal or :!Te<tab>). - - findprg - type: string - default: "find %s %a -print , -type d \( ! -readable -o ! -exe‐ - cutable \) -prune" - Specifies format for an external command to be invoked by the - :find command. The format supports expanding of macros, spe‐ - cific for a particular *prg option, and %% sequence for insert‐ - ing percent sign literally. This option should include the %s - macro to specify placement of list of paths to search in and the - %a macro to specify placement of arguments passed to the :find - command. If some of the macros are not used, they will be - implicitly added after a space to the value of the option in the - following order: %s, %a. - - %s and %a macro can slightly change their meaning depending on - :find command arguments. When the first argument points to an - existing directory, %s is assigned all arguments and %a is left - empty. Otherwise, %s is assigned a dot (".") meaning current - directory or list of selected filenames if any. %a is assigned - arguments when first argument starts with a dash ("-"), other‐ - wise an escaped version of arguments, prepended by "-name" (on - *nix) or "-iname" (on Windows) predicate. - - followlinks - type: boolean - default: true - Follow links on l or Enter. - - fusehome - type: string - default: "($TMPDIR | $TEMP | $TEMPDIR | $TMP)/vifm_FUSE/" - Directory to be used as a root dir for FUSE mounts. Value of - the option can contain environment variables (in form - "$envname"), which will be expanded (prepend it with a slash to - prevent expansion). The value should expand to an absolute - path. - - If you change this option, vifm won't remount anything. It - affects future mounts only. See "Automatic FUSE mounts" section - below for more information. - - gdefault gd - type: boolean - default: false - When on, 'g' flag is on for :substitute by default. - - grepprg - type: string - default: "grep -n -H -I -r %i %a %s" - Specifies format for an external command to be invoked by the - :grep command. The format supports expanding of macros, spe‐ - cific for a particular *prg option, and %% sequence for insert‐ - ing percent sign literally. This option should include the %i - macro to specify placement of "-v" string when inversion of - results is requested, the %a macro to specify placement of argu‐ - ments passed to the :grep command and the %s macro to specify - placement of list of files to search in. If some of the macros - are not used, they will be implicitly added after a space to the - value of the 'grepprg' option in the following order: %i, %a, - %s. - - Example of setup to use ack (http://beyondgrep.com/) instead of - grep: - set grepprg=ack\ -H\ -r\ %i\ %a\ %s - or The Silver Searcher (https://github.com/ggreer/the_sil‐ - ver_searcher): - set grepprg=ag\ --line-numbers\ %i\ %a\ %s - - - history hi - type: integer - default: 15 - Maximum number of directories in the view history and lines in - the prompt, command line and search histories. - - hlsearch hls - type: bool - default: true - Highlight all matches of search pattern. - - iec type: boolean - default: false - Use KiB, MiB, ... instead of KB, MB, ... - - ignorecase ic - type: boolean - default: false - Ignore case in search patterns (:substitute, / and ? commands) - and characters after f and F commands. It doesn't affect file - filtering. - - incsearch is - type: boolean - default: false - When this option is set, search will be performed starting from - initial cursor position each time search pattern is changed. - - laststatus ls - type: boolean - default: true - Controls if status bar is visible. - - lines type: int - default: terminal height on startup - Terminal height in lines. - - locateprg - type: string - default: "locate %a" - Specifies format for an external command to be invoked by the - :locate command. The format supports expanding of macros, spe‐ - cific for a particular *prg option, and %% sequence for insert‐ - ing percent sign literally. This option should include the %a - macro to specify placement of arguments passed to the :locate - command. If the macro is not used, it will be implicitly added - after a space to the value of this option. - - lsview type: boolean - default: false - type: local - When this option is set, directory view will be displayed in - multiple columns with filenames similar to output of `ls -x` - command. See ls-like view section below for format description. - - rulerformat ruf - type: string - default: "%=%l-%S " - Determines the content of the ruler. Its width is 13 characters - and it's right aligned. Following macros are supported: - %l - file number - %L - total number of files in view (including filtered) - %- - number of filtered files - %S - number of showed files - %= - separation point between left and right align items - %% - percent sign - - Percent sign can be followed by optional minimum field width. - Add '-' before minimum field width if you want field to be right - aligned. Example: - - set rulerformat="%=%2l-%S [%L] " - - runexec - type: boolean - default: false - Run executable file on Enter or l. - - scrollbind scb - type: boolean - default: false - When this option is set, vifm will try to keep difference of - scrolling positions of two windows constant. - - scrolloff so - type: int - default: 0 - Minimal number of screen lines to keep above and below the cur‐ - sor. If you want cursor line to always be in the middle of the - view (except at the beginning or end of the file list), set this - option to some large value (e.g. 999). - - shell sh - type: string - default: $SHELL or "sh" or "cmd" (on MS-Windows) - Full path to the shell to use to run external commands. - - shortmess shm - type: charset - default: "" - Contains a sequence of single-character flags. Each flag - enables shortening of some message displayed by vifm in the TUI. - Flags: - T - truncate status-bar messages in the middle if they are too - long to fit on the command line. "..." will appear in the mid‐ - dle. - - slowfs type: string list - default: "" - only for *nix - A list of mounter fs name beginnings (first column in /etc/mtab - or /proc/mounts) that work too slow for you. This option can be - used to stop vifm from making some requests to particular kinds - of file systems that can slow down file browsing. Currently - this means don't check if directory has changed and do not check - if target of symbolic links exists. - - smartcase scs - type: boolean - default: false - Overrides the ignorecase option if the search pattern contains - at least one upper case character. Only used when ignorecase - option is enabled. It doesn't affect file filtering. - - sort type: string list - default: +name on *nix and +iname on Windows - type: local - Sets list of sorting keys (first item is primary key, second is - secondary key, etc.): - [+-]ext - sort by extension - [+-]name - sort by name (including extension) - [+-]iname - sort by name (including extension, ignores case) - [+-]gid - sort by group id (*nix only) - [+-]gname - sort by group name (*nix only) - [+-]mode - sort by mode (*nix only) - [+-]perms - sort by permissions string (*nix only) - [+-]uid - sort by owner id (*nix only) - [+-]uname - sort by owner name (*nix only) - [+-]size - sort by size - [+-]atime - sort by time accessed - [+-]ctime - sort by time changed - [+-]mtime - sort by time modified - - ´+' means ascending sort for this key, and '-' means descending sort. - - In case name (iname on Windoes) is skipped, it will be added at the end - automatically. - - This option also changes view columns according to primary sorting key - set, unless 'viewcolumns' option is not empty. - - sortnumbers - type: boolean - default: false - type: local - Natural sort of (version) numbers within text. - - statusline stl - type: string - default: "" - Determines the content of the status line (the line right above - command-line). Empty string means use same format like in pre‐ - vious versions. Following macros are supported: - - - %t - file name (considering value of the 'classify' option) - - - %A - file attributes (permissions on *nix or properties on - Windows) - - - %u - user name or uid (if it cannot be resolved) - - - %g - group name or gid (if it cannot be resolved) - - - %s - file size in human readable format - - - %E - size of selected files in human readable format, same as - %s when no files are selected, except that it will never - show size of ../ in visual mode, since it cannot be - selected - - - %d - file modification date (uses 'timefmt' option) - - - all 'rulerformat' macros - - Percent sign can be followed by optional minimum field width. - Add '-' before minimum field width if you want field to be right - aligned. Example: - - set statusline=" %t%= %A %10u:%-7g %15s %20d " - - On Windows file properties include next flags (upper case means - flag is on): - A - archive - H - hidden - I - content isn't indexed - R - readonly - S - system - C - compressed - D - directory - E - encrypted - P - reparse point (e.g. symbolic link) - Z - sparse file - - sortorder - type: enumeration - default: ascending - Sets sort order for primary key: ascending, descending. - - tabstop ts - type: integer - default: value from curses library - Number of spaces that a Tab in the file counts for. - - timefmt - type: string - default: " %m/%d %H:%M" - Format of time in file list. See man date or man strf‐ - time for details. - - timeoutlen tm - type: integer - default: 1000 - The time in milliseconds that is waited for a mapped key - in case of already typed key sequence is ambiguous. - - trash type: boolean - default: true - Use trash directory. See "Trash directory" section - below. - - trashdir - type: string - default: "$HOME/.vifm/Trash" - Sets path to trash directory. Value of the option can - contain environment variables (in form "$envname"), which - will be expanded (prepend it with a slash to prevent - expansion). The value should expand to an absolute path. - - Will attempt to create the directory if it does not - exist. See "Trash directory" section below. - - undolevels ul - type: integer - default: 100 - Maximum number of changes that can be undone. - - vicmd type: string - default: "vim" - The actual command used to start vi. Ampersand sign at - the end (regardless whether it's preceded by space or - not) means backgrounding of command. - - viewcolumns - type: string - default: "" - type: local - Format string containing list of columns in the view. - When this option is empty view columns to show are chosen - automatically using sorting keys (see 'sort') as a base. - Value of this option is ignored if 'lsview' is set. See - Column view section below for format description. - - An example of setting the options for both panes (note - vifm-windo command): - windo set viewcolumns=-{name}..,6{size},11{perms} - - vixcmd type: string - default: value of vicmd - The command used to start vi when in X. Ampersand sign - at the end (regardless whether it's preceded by space or - not) means backgrounding of command. - - vifminfo - type: set - default: bookmarks - - Controls what will be saved in the $VIFM/vifminfo file. - options - all options that can be set with the :set command - filetypes - associated programs and viewers - commands - user defined commands (see :command description) - bookmarks - bookmarks, except special ones like '< and '> - tui - state of the user interface (sorting, number of - windows, quick - view state, active view) - dhistory - directory history - state - file name and dot filters and terminal multiplex‐ - ers integration - state - cs - default color scheme - savedirs - save last visited directory (needs dhistory) - chistory - command line history - shistory - search history (/ and ? commands) - phistory - prompt history - fhistory - filter history (see description of the "=" normal - mode command) - dirstack - directory stack overwrites previous stack, unless - stack of - current session is empty - registers - registers content - - vimhelp - type: boolean - default: false - Use vim help format. - - wildmenu wmnu - type: boolean - default: false - Controls whether possible matches of completion will be - shown above the command line. - - wrap type: boolean - default: true - Controls whether to wrap text in quick view. - - wrapscan ws - type: boolean - default: true - Searches wrap around end of the list. - -Mappings - Since it's not easy to enter special characters there are several spe‐ - cial sequences that can be used in place of them. They are: - - <cr> Enter key - - <bs> Backspace key - - <tab> <s-tab> - Tabulation and Shift+Tabulation keys - - <esc> <space> <home> <end> <left> <right> <up> <down> <pageup> <page‐ - down> - Keys with obvious names. - - <del> <delete> - Delete key. <del> and <delete> mean different codes, but - <delete> is more common. - - <c-a>,<c-b>,...,<c-z>,<c-[>,<c->,<c-]>,<c-^>,<c-_> - Control + some key. - - <a-a>,<a-b>,...,<a-z> - <m-a>,<m-b>,...,<m-z> Alt + some key. - - <a-c-a>,<a-c-b>,...,<a-c-z> - <m-c-a>,<m-c-b>,...,<m-c-z> only for *nix - Alt + Ctrl + some key. - - <f0> - <f63> - Functional keys - - <c-f1> - <c-f12> - only for MS-Windows - Functional keys with Control key pressed. - - <a-f1> - <a-f12> - only for MS-Windows - Functional keys with Alt key pressed. - - <s-f1> - <s-f12> - only for MS-Windows - Functional keys with Shift key pressed. - - vifm removes whitespace characters at the beginning and end of com‐ - mands. That's why you may want to use <space> at the end of rhs in - mappings. For example: - - cmap <f1> man<space> - - will put "man " in line when you hit the <f1> key in the command line - mode. - -Expression syntax - Supported expressions is a subset of what VimL provides. - - Expression syntax summary, from least to most significant: - - vifm-expr1 expr2 == expr2 equal - expr2 != expr2 not equal - - vifm-expr2 expr3 . expr3 .. string concatenation - - vifm-expr3 "string" string constant, \ is special - 'string' string constant, ' is doubled - $VAR environment variable - function(expr1, ...) function call - - ".." indicates that the operations in this level can be concatenated. - - expr1 - ----- - expr2 {cmp} expr2 - - Compare two expr2 expressions, resulting in a 0 if it evaluates to - false or 1 if it evaluates to true. - - equal == - notequal != - - Examples: - 'a' == 'a' evaluates to 1 - 'a' == 'b' evaluates to 0 - - expr2 - ----- - expr3 . expr3 .. string concatenation - - Examples: - 'a' . 'b' = 'ab' - 'aaa' . '' . 'c' = 'aaac' - - expr3 - ----- - - string - ------ - "string" string constant - - Note that double quotes are used. - - A string constant accepts these special characters: - \b backspace <bs> - \e escape <esc> - \n newline - \r return <cr> - \t tab <tab> - \\ backslash - \" double quote - - Examples: - "\"Hello,\tWorld!\"" - "Hi,\nthere!" - - literal-string - -------------- - ´string' string constant - - Note that single quotes are used. - - This string is taken as it is. No backslashes are removed or have a - special meaning. The only exception is that two quotes stand for one - quote. - - Examples: - 'All\slashes\are\saved.' - 'This string contains doubled single quotes ''here''' - - environment variable - -------------------- - $VAR environment variable - - The String value of any environment variable. When it is not defined, - the result is an empty string. - - Examples: - 'This is my $PATH env: ' . $PATH - 'vifmrc at ' . $MYVIFMRC . ' is used.' - - function call - ------------- - function(expr1, ...) function call - - See Functions section below. - - Examples: - "'" . filetype('.') . "'" - filetype('.') == 'reg' - -Functions - USAGE RESULT DESCRIPTION - - expand({expr}) String Expand macros in {expr}. - filetype({fnum}) String Returns file type from position. - - expand({expr}) - Expands macros in {expr} just like it's done for command-line commands. - Returns a string. See "Command macros" section above. Examples: - " percent sign - :echo expand('%%') - " the last part of directory name of the other pane - :echo expand('%D:t') - - filetype({fnum}) - The result is a string, which represents file type and is one of the - list: - exe executables - reg regular files - link symbolic links - dir directories - char character devices - block block devices - fifo pipes - sock *nix domain sockets - ? unknown file type (should never appear) - Parameter {fnum} can have following values: - - '.' to get type of file under the cursor in the active pane - -Menus and dialogs - General - - j, k - move. - <Escape>, Ctrl-C, ZZ, ZQ - quit. - <Return>, l - select and exit the menu. - Ctrl-L - redraw the menu. - - Escape, Ctrl-C, ZZ, ZQ, q - quit. - - In all menus - - Ctrl-B/Ctrl-F - Ctrl-D/Ctrl-U - Ctrl-E/Ctrl-Y - / and ?, n/N - [num]G/[num]gg - H/M/L - zb/zt/zz - zh - scroll menu items [count] characters to the right. - zl - scroll menu items [count] characters to the left. - zH - scroll menu items half of screen width characters to the right. - zL - scroll menu items half of screen width characters to the left. - - All these keys have the same meaning as in normal mode (but not L in - filetype menu). - - : - enter command line mode for menus (currently only :exi[t], :q[uit], - :x[it] and :{range} are supported). - - Apropos menu - - l key won't close the menu allowing user to pick another man page, use - :q to close the menu. - - Commands menu - - dd on a command to remove. - - Bookmarks menu - - Escape or Ctrl-C to abort j and k to move through. - dd on a bookmark to remove. - - Directory stack menu - - Pressing l or Enter on directory name will rotate stack to place - selected directory pair at the top of the stack. - - Filetype menu - - Commands from vifmrc or typed in command-line are displayed above empty - line. All commands below empty line are from .desktop files. - - Fileinfo dialog - - Enter - close dialog - q - close dialog - - Sort dialog - - h - switch ascending/descending. - Space - switch ascending/descending. - q - close dialog - - Attributes (permissions or properties) dialog - - h - check/uncheck. - Space - check/uncheck. - q - close dialog - - Item states: - - - * - checked flag. - - - X - means that it has different value for files in selection. - - - d (*nix only) - (only for execute flags) means u-x+X, g-x+X or o-x+X - argument for the chmod program. If you want to remove execute right - from all files, but preserve it for directories, set all execute - flags to 'd' and check ´Set Recursively' flag. - -Startup - On startup vifm determines several variables that are used during the - session. They are determined in the order they appear below. - - On *nix systems $HOME is normally present and used as is. On Windows - systems vifm tries to find correct home directory in the following - order: - - $HOME variable; - - $USERPROFILE variable; - - a combination of $HOMEDRIVE and $HOMEPATH variables. - - vifm tries to find correct configuration directory by checking the fol‐ - lowing places: - - $VIFM variable; - - parent directory of the executable file (on Windows only); - - $HOME/.vifm directory; - - $APPDATA/Vifm directory (on Windows only). - - vifm tries to find correct configuration file by checking the following - places: - - $MYVIFMRC variable; - - vifmrc in parent directory of the executable file (on Windows only); - - $VIFM/vifmrc file. - -Configure - See Startup section above for the explanations on $VIFM and $MYVIFMRC. - - The vifmrc file contains commands that will be executed on vifm - startup. See $MYVIFMRC variable description for search algorithm used - to find vifmrc. Use it to set settings, mappings, filetypes etc. To - use multi line commands precede each next line with a slash (whitespace - before slash is ignored, but all spaces at the end of the lines are - saved). For example: - set - \smartcase - equals "setsmartcase". When - set<space here> - \ smartcase - equals "set smartcase". - - The $VIFM/vifminfo file contains session settings. You may edit it by - hand to change the settings, but it's not recommended to do that, edit - vifmrc instead. You can control what settings will be saved in - vifminfo by setting ´vifminfo' option. Vifm always writes this file on - exit unless 'vifminfo' option is empty. Bookmarks, commands, directory - history, filetypes, fileviewers and registers in the file are merged - with vifm configuration (which has bigger priority). - - The $VIFM/scripts directory can contain shell scripts. vifm modifies - it's PATH environment variable to let user run those scripts without - specifying full path. All subdirectories of the $VIFM/scripts will be - added to PATH too. Script in a subdirectory overlaps script with the - same name in all its parent directories. - - The $VIFM/colors directory contains color schemes. - -Automatic FUSE mounts - vifm has a builtin support of automated FUSE file system mounts. It is - implemented using file associations mechanism. To enable automated - mounts, one needs to use a specially formated program line in filetype - or filextype commands. Currently two formats are supported: - - 1) FUSE_MOUNT This format should be used in case when all information - needed for mounting all files of a particular type is the same. E.g. - mounting of tar files don't require any file specific options. - - Format line: - FUSE_MOUNT|mounter %SOURCE_FILE %DESTINATION_DIR [%CLEAR] - - Example filetype command: - :filetype FUSE_MOUNT|fuse-zip %SOURCE_FILE %DESTINATION_DIR - - 2) FUSE_MOUNT2 This format allows one to use specially formatted files - to perform mounting and is useful for mounting remotes, for example - remote file systems over ftp or ssh. - - Format line: - FUSE_MOUNT2|mounter %PARAM %DESTINATION_DIR [%CLEAR] - - Example filetype command: - :filetype FUSE_MOUNT2|sshfs %PARAM %DESTINATION_DIR - - Example file content: - root@127.0.0.1:/ - - All % macros are expanded by vifm at runtime and have the following - meaning: - - %SOURCE_FILE is replaced by full path to selected file - - %DESTINATION_DIR is replaced by full path to mount directory, which - is created by vifm basing on the value of 'fusehome' option. - - %PARAM value is filled from the first line of file (whole line), - though in the future it can be changed to whole file content - - %CLEAR means that you want to clear screen before running mount - command. - - %CLEAR is an optional macro. Other macros are not mandatory, but mount - commands likely won't work without them. - - The mounted FUSE file systems will be automatically unmounted in two - cases: - - - when vifm quits (with ZZ, :q, etc. or when killed by signal) - - - when you explicitly leave mount point going up to its parent direc‐ - tory (with h, Enter on "../" or ":cd ..") and other pane is not in - the same directory or its child directories. - -View look - vifm supports displaying of file list view in two different ways: - - - in a table mode, when multiple columns can be set using 'viewcolumns' - option (see Column view section below for details); - - - in a multicolumn list manner which looks almost like `ls -x` command - output (see ls-like view section below for details). - - The look is local for each view and can be chosen by changing value of - the ´lsview' boolean option. - - Depending on view look some of keys change their meaning to allow more - natural cursor moving. This concerns mainly h, j, k, l and other simi‐ - lar navigation keys. - - Also some of options can be ignored if they don't affect view display‐ - ing in selected look. For example value of 'viewcolumns' when 'lsview' - is set. - -ls-like view - When this view look is enabled by setting 'lsview' option on, vifm will - display files in multiple columns. Number of columns depends on the - length of the longest file name present in current directory of the - view. Whole file list is automatically reflowed on directory change, - terminal or view resize. - - View looks close to output of `ls -x` command, so files are listed left - to right in rows. - - In this mode file manipulation commands (e.g. d) don't work line-wise - like they do in Vim, since such operations would be uncommon for file - manipulating tasks. Thus, for example, dd will remove only current - file. - -Column view - View columns are described by a comma-separated list of column descrip‐ - tions, each of which has the following format - [ '-' ] [ fw ( [ '.' tw ] | '%' ) ] '{' type '}' '.'{0,3} - where fw stands for full width and tw stands for text width. - - So it basically consists of four parts: - 1. Optional alignment specifier - 2. Optional width specifier - 3. Mandatory column name - 4. Optional cropping specifier - - Alignment specifier - - It's an optional minus sign as the first symbol of the string. - - Specifies type of text alignment within a column. Two types are sup‐ - ported: - - - left align - set viewcolumns=-{name} - - - right align (default) - set viewcolumns={name} - - Width specifier - - It's a number followed by a percent sign, two numbers (second one - should be less than or equal to the first one) separated with a dot or - a single number. - - Specifies column width and its units. There are tree size types: - - - absolute size - column width is specified in characters - set viewcolumns=-100{name},20.15{ext} - results in two columns with lengths of 100 and 20 and a reserved - space of five characters on the left of second column. - - - relative (percent) size - column width is specified in percents of - view width - set viewcolumns=-80%{name},15%{ext},5%{mtime} - results in three columns with lengths of 80/100, 15/100 and 5/100 of - view width. - - - auto size (default) - column width is automatically determined - set viewcolumns=-{name},{ext},{mtime} - results in three columns with length of one third of view width. - There is no size adjustment to content, since it will slow down ren‐ - dering. - - Columns of different sizing types can be freely mixed in one view. - Though sometimes some of columns can be seen partly or be completely - invisible if there is not enough space to display them. - - Column name - - This is just a sort key surrounded with curly braces, e.g. - {name},{ext},{mtime} - {name} and {iname} keys are the same and present both for consistency - with ´sort' option. - - Empty curly braces ({}) are replaced with the default secondary column - for primary sort key. So after the next command view will be displayed - almost as if 'viewcolumns' is empty, but adding ellipsis for long file - names: - set viewcolumns=-{name}..,6{}. - - Cropping specifier - - It's from one to three dots after closing curly brace in column format. - - Specifies type of text truncation if it doesn't fix in the column. Cur‐ - rently tree types are supported: - - - truncation - text is truncated - set viewcolumns=-{name}. - results in truncation of names that are too long too fit in the view. - - - adding of ellipsis - ellipsis on the left or right are added when - needed - set viewcolumns=-{name}.. - results in that ellipsis are added at the end of too long file names. - - - none (default) - text can pass column boundaries - set viewcolumns=-{name}...,{ext} - results in that long file names can partially be written on the ext - column. - -Color schemes - The color schemes in vifm can be applied in two different ways: - - - as the default (or main) color scheme - - - as local to a panel color scheme - - Both types are set using |vifm-:colorscheme| command, but of different - forms: - - - :colorscheme color_scheme_name - for the default color scheme - - - :colorscheme color_scheme_name directory - for local color schemes - - Look of different parts of the TUI (Text User Interface) is determined - in this way: - - - Border, TopLineSel, TopLine, CmdLine, ErrorMsg, StatusLine and Wild‐ - Menu are always determined by the default color scheme - - - CurrLine, Selected, Directory, Link, BrokenLink, Socket, Device, Exe‐ - cutable, Fifo and Win are determined by default color scheme and a - set of local colorschemes, which can be empty - - There might be a set of local color schemes because they are structured - hierarchically according to file system structure. For example, having - the following piece of file system: - - ~ - `-- bin - | - `-- my - - Two color schemes: - - # ~/.vifm/colors/for_bin - highlight Win cterm=none ctermfg=white ctermbg=red - highlight CurrLine cterm=none ctermfg=red ctermbg=black - - # ~/.vifm/colors/for_bin_my - highlight CurrLine cterm=none ctermfg=green ctermbg=black - - And these three commands in the vifmrc file: - - colorscheme Default - colorscheme for_bin ~/bin - colorscheme for_bin_my ~/bin/my - - File list will look in the following way for each level: - - - ~/ - Default color scheme - black background - cursor with blue background - - - ~/bin/ - mix of Default and for_bin color schemes - red background - cursor with black background and red foreground - - - ~/bin/my/ - mix of Default, for_bin and for_bin_my color schemes - red background - cursor with black background and green foreground - -Trash directory - vifm has support of trash directory, which is used as temporary storage - for deleted files or files that were cut. Using trash is controlled by - the ´trash' option, and exact path to the trash can be set with - 'trashdir' option. Trash directory in vifm differs from the system- - wide one by default, because of possible incompatibilities of storing - deleted files among different file managers. But one can set - 'trashdir' to "~/.local/share/Trash" to use a "standard" trash direc‐ - tory. - - There are two scenarios of using trash in vifm: - - 1. As a place for storing files that were cut by "d" and may be - inserted to some other place in file system. - - 2. As a storage of files, that are deleted but not purged yet. - - The first scenario uses deletion ("d") operations to put files to trash - and put ("p") operations to restore files from trash directory. Note - that such operations move files to and from trash directory, which can - be long term operations in case of different partitions or remote - drives mounted locally. - - The second scenario uses deletion ("d") operations for moving files to - trash directory and :empty command-line command to purge all previously - deleted files. - - Deletion and put operations depend on registers, which can point to - files in trash directory. Normally, there are no nonexistent files in - registers, but vifm doesn't keep track of modifications under trash - directory, so one shouldn't expect value of registers to be absolutely - correct if trash directory was modified not by operation that are meant - for it. But this won't lead to any issues with operations, since they - ignore nonexistent files. - -Client-Server - vifm supports remote execution of command-line mode commands as well as - remote changing of directories. This is possible using --remote com‐ - mand-line argument. - - To execute a command remotely combine --remote argument with -c <com‐ - mand> or +<command>. For example: - vifm --remote -c 'cd /' - vifm --remote '+cd /' - - To change directory not using command-line mode commands one can spec‐ - ify paths right after --remote argument, like this: - vifm --remote / - vifm --remote ~ - vifm --remote /usr/bin /tmp - - At the moment there is no way of specifying, which instance of vifm - should arguments be sent. The main purpose of --remote argument is to - provide support of using vifm as a single-instance application. - -Plugin - Plugin for using vifm in vim as a file selector. - - Commands: - - :EditVifm select a file or files to open in the current buffer. - :SplitVifm split buffer and select a file or files to open. - :VsplitVifm vertically split buffer and select a file or files to - open. - :DiffVifm select a file or files to compare to the current file - with - :vert diffsplit. - :TabVifm select a file or files to open in tabs. - - Each command accepts up to two arguments: left pane directory and right - pane directory. After arguments are checked, vifm process is spawned - in a special "file-picker" mode. To pick files just open them either - by pressing l, i or Enter keys, or by running :edit command. If no - files are selected, file under the cursor is opened, otherwise whole - selection is passed to the plugin and opened in vim. - - The plugin have only two settings. It's a string variable named - g:vifm_term to let user specify command to run gui terminal. By - default it's equal to ´xterm -e'. And another string variable named - g:vifm_exec, which equals "vifm" by default and specifies path to - vifm's executable. To pass arguments to vifm use g:vifm_exec_args, - which is empty by default. - - To use the plugin copy the vifm.vim file to either the system wide - vim/plugin directory or into ~/.vim/plugin. - - If you would prefer not to use the plugin and it is in the system wide - plugin directory add - - let loaded_vifm=1 - - to your ~/.vimrc file. - -Reserved - The following command names are reserved and shouldn't be used for user - commands. - - g[lobal] - v[global] - -SEE ALSO - Website: http://vifm.sourceforge.net/ - - Esperanto translation of the documentation by Sebastian Cyprych: - http://cyprych.neostrada.pl/tekstoj/komputiloj/vifm-help.eo.html - -AUTHOR - Vifm was written by ksteen <ksteen@users.sourceforge.net> - And currently is developed by xaizek <xaizek@openmailbox.org> - - - - Oct 19, 2013 vifm(1) |