xaizek / vifm (License: GPLv2+) (since 2018-12-07)
Vifm is a file manager with curses interface, which provides Vi[m]-like environment for managing objects within file systems, extended with some useful ideas from mutt.
<root> / data / vim /
File Mode Size
autoload/ 040000
doc/ 040000
ftdetect/ 040000
ftplugin/ 040000
plugin/ 040000
syntax/ 040000
README.md 100644 2,572B
screenshot.png 100644 45KiB

/README.md

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

Hints

Before first commit, do not forget to setup your git environment:
git config --global user.name "your_name_here"
git config --global user.email "your@email_here"

Clone this repository using HTTP(S):
git clone https://code.reversed.top/user/xaizek/vifm

Clone this repository using ssh (do not forget to upload a key first):
git clone ssh://rocketgit@code.reversed.top/user/xaizek/vifm

You are allowed to anonymously push to this repository.
This means that your pushed commits will automatically be transformed into a pull request:
... clone the repository ...
... make some changes and some commits ...
git push origin master