Difference between revisions of "Main Page"
Jump to navigation
Jump to search
(→Features: Start explaining features) |
(→Features: Update list of features) |
||
(9 intermediate revisions by the same user not shown) | |||
Line 2: | Line 2: | ||
'''Vifm''' is an [https://en.wikipedia.org/wiki/Ncurses ncurses] based file manager with [https://en.wikipedia.org/wiki/Vi vi] like keybindings/modes/options/commands/configuration, which also borrows some useful ideas from [https://en.wikipedia.org/wiki/Mutt_(email_client) mutt]. If you use vi, vifm gives you complete keyboard control over your files without having to learn a new set of commands. | '''Vifm''' is an [https://en.wikipedia.org/wiki/Ncurses ncurses] based file manager with [https://en.wikipedia.org/wiki/Vi vi] like keybindings/modes/options/commands/configuration, which also borrows some useful ideas from [https://en.wikipedia.org/wiki/Mutt_(email_client) mutt]. If you use vi, vifm gives you complete keyboard control over your files without having to learn a new set of commands. | ||
− | |||
− | |||
=== Features === | === Features === | ||
− | To make it easier to understand use cases and to connect features to their configuration and controls | + | To make it easier to understand use cases and to connect features to their configuration and controls some details are provided in spoilers. |
* cross-platform (GNU/Linux, *BSD, Solaris, Windows, Mac OS) | * cross-platform (GNU/Linux, *BSD, Solaris, Windows, Mac OS) | ||
* [https://en.wikipedia.org/wiki/UTF-8 UTF-8] support | * [https://en.wikipedia.org/wiki/UTF-8 UTF-8] support | ||
− | * user mappings (almost like in vi) | + | * user mappings (almost like in vi) <spoiler text="..."> |
− | * ranges | + | Input model is very Vi[m]-alike. |
+ | Each mode has set of commands for managing mappings (see [http://vifm.info/vimdoc.shtml#vifm-%3Amap :map], [http://vifm.info/vimdoc.shtml#vifm-%3Anoremap :noremap] and [http://vifm.info/vimdoc.shtml#vifm-%3Aunmap :unmap]) associated with it. | ||
+ | One-argument or no-argument form of mapping commands can be used to list existing keys. | ||
+ | |||
+ | Ambiguity leads to timeouts (see [http://vifm.info/vimdoc.shtml#vifm-%27timeoutlen%27 'timeoutlen'] option) as with builtin commands. | ||
+ | |||
+ | Mappings can include [http://vifm.info/vimdoc.shtml#vifm-mappings angle bracket notation] to designate various special keys (e.g. <kbd>Ctrl+X</kbd>). | ||
+ | |||
+ | Note that mapped sequence can span across mode boundaries. | ||
+ | </spoiler> | ||
+ | * ranges for command-line commands <spoiler text="..."> | ||
+ | [http://vifm.info/vimdoc.shtml#vifm-ranges Ranges] provide a way to specify range of files to be processed. | ||
+ | |||
+ | Some commands process current selection by default (e.g. [http://vifm.info/vimdoc.shtml#vifm-%3Asubstitute :substitute]), others might operate on current directory (like [http://vifm.info/vimdoc.shtml#vifm-%3Agrep :grep]). | ||
+ | Employing ranges can change that to renaming all files with <code>:%substitute/pat/subst</code> or grepping only file under the cursor with <code>:.grep pattern</code>. | ||
+ | |||
+ | Since ranges are not always handy to type manually, normal mode contains <kbd>!</kbd> command, which generates range, for example, hitting <kbd>!G</kbd> yields <kbd>:.,$</kbd>. | ||
+ | </spoiler> | ||
* user defined commands (support ranges) | * user defined commands (support ranges) | ||
− | * registers | + | * registers <spoiler text="..."> |
+ | [http://vifm.info/vimdoc.shtml#vifm-registers Registers] serve as additional buffers, which allow sorting files into several groups for later processing. | ||
+ | |||
+ | Some registers are managed implicitly and provide additional convenience, others need to be named explicitly on calling commands (e.g. <kbd>"xdd</kbd> deletes file(s) to <code>x</code> register). Some registers are available by two names: lower case and upper case one; using first form reassigns register content, while the second one appends to it. | ||
+ | |||
+ | Registers are accepted by both shortcuts and command-line commands, the latter ones accept them as their arguments (for example, [http://vifm.info/vimdoc.shtml#vifm-%3Adelete :delete] and [http://vifm.info/vimdoc.shtml#vifm-%3Ayank :yank] commands). | ||
+ | |||
+ | [http://vifm.info/vimdoc.shtml#vifm-%3Aregisters :registers] command yields menu that displays files in the registers. | ||
+ | |||
+ | Content of registers can be saved across sessions. | ||
+ | </spoiler> | ||
* operation undoing/redoing <spoiler text="..."> | * operation undoing/redoing <spoiler text="..."> | ||
Foreground file operations can be reversed and replayed again if their nature allows it. For example, deletion (not moving to trash) or file overwrite can't be reversed, on the other hand any rename operations can be reversed unless previous file names conflict with names of newly created files. Irreversible operations require explicit confirmation of some form. | Foreground file operations can be reversed and replayed again if their nature allows it. For example, deletion (not moving to trash) or file overwrite can't be reversed, on the other hand any rename operations can be reversed unless previous file names conflict with names of newly created files. Irreversible operations require explicit confirmation of some form. | ||
Line 25: | Line 50: | ||
</spoiler> | </spoiler> | ||
* [https://en.wikipedia.org/wiki/Filesystem_in_Userspace FUSE] file systems support | * [https://en.wikipedia.org/wiki/Filesystem_in_Userspace FUSE] file systems support | ||
− | * trash | + | * trash <spoiler text="..."> |
+ | Apart from being storage for files which are about to be erased this is also a place for files that were "cut" (which corresponds to "delete" operation in Vi[m]), but not pasted yet. | ||
+ | |||
+ | Trash is enabled by default ([http://vifm.info/vimdoc.shtml#vifm-%27trash%27 'trash'] option) and it is better to leave it in this state. [http://vifm.info/vimdoc.shtml#vifm-%27trashdir%27 'trashdir'] can used to customize location of trash directories, which are media-specific by default and are named <code>.vifm-Trash/</code>. | ||
+ | |||
+ | List of files in trashes is available on [http://vifm.info/vimdoc.shtml#vifm-%3Alstrash :lstrash] command. [http://vifm.info/vimdoc.shtml#vifm-%3Atrashes :trashes] lists trash directories themselves, optionally along with their sizes. Inside trash directory [http://vifm.info/vimdoc.shtml#vifm-%3Arestore :restore] command restores file to the place where it used to be, it's also possible to just move files by other means, which will automatically demangle their names. | ||
+ | |||
+ | [http://vifm.info/vimdoc.shtml#vifm-%3Aempty :empty] command is there to clean trashes in background. | ||
+ | |||
+ | Registers are connected with trashes, which allows managing several groups of files at the same time. | ||
+ | </spoiler> | ||
* multiple files renaming (also known as "bulk renaming" or [https://en.wikipedia.org/wiki/Batch_renaming "batch renaming"]) | * multiple files renaming (also known as "bulk renaming" or [https://en.wikipedia.org/wiki/Batch_renaming "batch renaming"]) | ||
− | * | + | * color schemes, which can also be applied to specific sub-trees <spoiler text="..."> |
− | + | [http://vifm.info/vimdoc.shtml#vifm-color-schemes Schemes] can be viewed and setup via [http://vifm.info/vimdoc.shtml#vifm-%3Acolorscheme :colorscheme] command. | |
− | * | + | They can be applied either at global level or hierarchically for specific directory and all of its sub-directories. |
− | * | + | |
− | + | Scheme files are no more than files with regular commands (mainly [http://vifm.info/vimdoc.shtml#vifm-%3Ahighlight :highlight] command). See [http://vifm.info/colorschemes.shtml preview] or go for a [https://github.com/vifm/vifm-colors download]. | |
+ | |||
+ | {| | ||
+ | |- align="left" valign="bottom" | ||
+ | | [[File:Cs-almost-default.png|frame|Almost default look]] | ||
+ | | [[File:Cs-sane-default.png|frame|Custom scheme]] | ||
+ | | [[File:Cs-subtree.png|frame|Sub-tree specific color scheme]] | ||
+ | |} | ||
+ | </spoiler> | ||
+ | * colorization of files according to their type and/or name | ||
+ | * vi-like marks and named bookmarks (tags) | ||
* operation backgrounding | * operation backgrounding | ||
* customizable file viewers | * customizable file viewers | ||
* handy [https://en.wikipedia.org/wiki/Less_(Unix) less]-like preview mode with support of colors | * handy [https://en.wikipedia.org/wiki/Less_(Unix) less]-like preview mode with support of colors | ||
− | * (interactive) filtering out and searching for files using regular expressions | + | * (interactive) filtering out and searching with match highligh for files using regular expressions |
− | * one or two pane view | + | * one or two pane view (vertical or horizontal) <spoiler text="..."> |
− | * shell-like command line editing | + | Single pane view is enabled by <kbd>Ctrl-W+o</kbd> or [http://vifm.info/vimdoc.shtml#vifm-%3Aonly :only] command. |
− | * | + | |
− | + | Vertical split is activated by <kbd>Ctrl-W+v</kbd> or [http://vifm.info/vimdoc.shtml#vifm-%3Avsplit :vsplit] command. | |
+ | |||
+ | Horizontal split can be activated by <kbd>Ctrl-W+s</kbd> or [http://vifm.info/vimdoc.shtml#vifm-%3Asplit :split] command. | ||
+ | |||
+ | Any of the above commands can be placed into configuration file to setup initial view layout after startup. | ||
+ | |||
+ | Some operations work with both panes at the same time, e.g. [http://vifm.info/vimdoc.shtml#vifm-%3Aview :view] or [http://vifm.info/vimdoc.shtml#vifm-%3Acopy :copy] commands. | ||
+ | |||
+ | {| | ||
+ | |- align="left" valign="bottom" | ||
+ | | [[File:Layout-only.png|frame|Only layout]] | ||
+ | | [[File:Layout-split.png|frame|Horizontal layout]] | ||
+ | | [[File:Layout-vsplit.png|frame|Vertical layout]] | ||
+ | |} | ||
+ | </spoiler> | ||
+ | * shell-like command-line editing | ||
+ | * table-like or [https://en.wikipedia.org/wiki/Ls ls]-like views | ||
* customizable file name prefixes and suffixes | * customizable file name prefixes and suffixes | ||
* built-in integration with [https://en.wikipedia.org/wiki/GNU_Screen GNU Screen] and [https://en.wikipedia.org/wiki/Tmux tmux] | * built-in integration with [https://en.wikipedia.org/wiki/GNU_Screen GNU Screen] and [https://en.wikipedia.org/wiki/Tmux tmux] | ||
* external editing of command line | * external editing of command line | ||
* multi-block selection | * multi-block selection | ||
+ | * remembering position in previously visited directories | ||
+ | * remote command execution | ||
+ | * command-line abbreviations | ||
+ | * ability to script configuration for specific directories | ||
== Main sections == | == Main sections == |
Revision as of 13:27, 16 July 2016
Overview
Vifm is an ncurses based file manager with vi like keybindings/modes/options/commands/configuration, which also borrows some useful ideas from mutt. If you use vi, vifm gives you complete keyboard control over your files without having to learn a new set of commands.
Features
To make it easier to understand use cases and to connect features to their configuration and controls some details are provided in spoilers.
- cross-platform (GNU/Linux, *BSD, Solaris, Windows, Mac OS)
- UTF-8 support
- user mappings (almost like in vi) ...
- ranges for command-line commands ...
- user defined commands (support ranges)
- registers ...
- operation undoing/redoing ...
- multiple files renaming (also known as "bulk renaming" or "batch renaming")
- color schemes, which can also be applied to specific sub-trees ...
- colorization of files according to their type and/or name
- vi-like marks and named bookmarks (tags)
- operation backgrounding
- customizable file viewers
- handy less-like preview mode with support of colors
- (interactive) filtering out and searching with match highligh for files using regular expressions
- one or two pane view (vertical or horizontal) ...
- shell-like command-line editing
- table-like or ls-like views
- customizable file name prefixes and suffixes
- built-in integration with GNU Screen and tmux
- external editing of command line
- multi-block selection
- remembering position in previously visited directories
- remote command execution
- command-line abbreviations
- ability to script configuration for specific directories
Main sections
- Contributing. Advices for those who would like to contribute bug report or feature request.
- Contributing to This Wiki. A place to map out and plan the topics found in the wiki.
- Development. Some information about development process.
- FAQ. Answers to frequently asked questions.
- Glossary. Explanation of abbreviations or ambiguous words.
- HOWTOs. Tutorials on various subjects.
- Manual. Main tutorial.
- Obtaining Vifm. Details about obtaining Vifm in different environments.
- Tips and Tricks. Description of some possibly unexpected/non-obvious uses of features.
- Utility scripts. Scripts that help utilize external applications.
- Vifm on the Web. List of pages related to Vifm.