Skip to content

vifm/vifm.vim

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

vifm.vim

This is a Vim-plugin that provides integration with Vifm.

Note: it is not self-sufficient and requires the application itself to be installed to work properly.

Functionality

In addition to integrating Vifm into Vim, it also provides convenience services to Vifm when it invokes Vim (for :help command in particular if you enable 'vimhelp' option) and makes Vim aware of Vifm-specific filetypes.

Vim-user perspective

  • :EditVifm - select a file or files to open in the current buffer
  • :Vifm - alias for :EditVifm to be used like :vert Vifm
  • :PeditVifm - select a file in preview window
  • :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
  • :VifmCs - attempts to convert Vim's color scheme to Vifm's one

Vifm-user perspective

  • Vim-style help for Vifm
  • Handling of rename buffers
  • Highlighting of Vifm-specific buffers (rename, external editing, configuration files)

Versioning and compatibility

Plugin always tracks the latest development of the application, which for the most part means documentation updates.

The interface between the plugin and Vifm has changed significantly in v0.8. Other than that versions don't have to match perfectly for all basic functionality to work correctly.

Installation example

Arch Linux

For a particular combination of pacman and vundle:

  1. Install the application with the following command:
sudo pacman -S vifm
  1. Add the following configuration to your .vimrc:
Plugin 'vifm/vifm.vim'
  1. Install this plugin with :PluginInstall.

Use different commands for other package/plugin managers.

Debian/Ubuntu/etc. Linux

sudo apt install vifm

Then see Vim 8+ Package install notes.

Vim 8+ Package

For vim 8 and later can install directly from git:

git clone https://github.com/vifm/vifm.vim.git ~/.vim/pack/bundle/start/vifm

Assuming bundle is the name of your plugin/packages directory.

Screenshot

Screenshot