https://github.com/pbogut/fzf-mru.vim

Vim plugin that is using fzf.vim (or Telescope) to display your most recently used files.
https://github.com/pbogut/fzf-mru.vim

fzf mru neovim-plugin telescope-extension telescope-plugin vim-plugin

Last synced: about 2 months ago
JSON representation

Vim plugin that is using fzf.vim (or Telescope) to display your most recently used files.

• Host: GitHub
• URL: https://github.com/pbogut/fzf-mru.vim
• Owner: pbogut
• License: mit
• Created: 2016-07-13T22:36:13.000Z (about 8 years ago)
• Default Branch: master
• Last Pushed: 2022-12-02T11:15:33.000Z (almost 2 years ago)
• Last Synced: 2024-06-10T01:39:07.997Z (3 months ago)
• Topics: fzf, mru, neovim-plugin, telescope-extension, telescope-plugin, vim-plugin
• Language: Vim Script
• Homepage:
• Size: 28.3 KB
• Stars: 103
• Watchers: 2
• Forks: 13
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE.md

Awesome Lists containing this project

README

        
# FZF :heart: MRU

[![Project Status: Active - The project has reached a stable, usable state and is being actively developed.](http://www.repostatus.org/badges/latest/active.svg)](http://www.repostatus.org/#active)

Vim plugin that allows using awesome [CtrlP](https://github.com/kien/ctrlp.vim)

MRU plugin with even more amazing [fzf](https://github.com/junegunn/fzf)

I love **FZF** fuzzy search algorithm and **CtrlP** Mru tracking - I'm using it

often to jump between two files (yes, I'm aware of ``). The way how

**fzf-vim's** `:History` works was not the best solution for me that's why I

decided to create this plugin. It requires **fzf**.

## Instalation

Using [vim-plug](https://github.com/junegunn/vim-plug):

```vim

Plug 'junegunn/fzf'

Plug 'pbogut/fzf-mru.vim'

```

Using [Vundle](https://github.com/VundleVim/Vundle.vim):

```vim

Plugin 'junegunn/fzf'

Plugin 'pbogut/fzf-mru.vim'

```

## Basic Usage

- You can run `:FZFMru`, `:FZFMru [search-query]` or `:FZFMru [fzf-command-options]`.

- For example: `:FZFMru --prompt "Sup? " -q "notmuch"` or `:FZFMru readme`

- You can also map it to a shortcut with `map p :FZFMru`.

- Set `let g:fzf_mru_relative = 1` to only list files within current directory.

- Set `let g:fzf_mru_store_relative_dirs = ['/path/to/code']` to store files as

  relative paths, as opposed to as absolute ones.  FZF-MRU will use the elements

  in this list as patterns to match the path against to see if it qualifies.

  This is useful if you have multiple copies of a repository on your computer

  that you switch between, and want to keep your MRU cache consistent between

  them.

- Set `let g:fzf_mru_no_sort = 1` to prevent `fzf` from sorting list while typing, it will keep list sorted by recency.

- Set `let g:fzf_mru_exclude_current_file = 0` to include the current file in the list since it's excluded by default.

## FZF Options/Preview

You could pass FZF options and/or enable the file preview like this:

```vim

command! -bang -nargs=? FZFMru call fzf_mru#actions#mru(,

    \{

        \'window': {'width': 0.9, 'height': 0.8},

        \'options': [

            \'--preview', 'cat {}',

            \'--preview-window', 'up:60%',

            \'--bind', 'ctrl-_:toggle-preview'

        \]

    \}

\)

nnoremap fm :FZFMru

```

If [bat](https://github.com/sharkdp/bat) is installed, which is the recommended previewer, you could replace the `cat` line in the command above:

```vim

            \'--preview', 'bat --style=numbers --color=always {}',

```

## Telescope integration

Because why not?

### Set up telescope extension

Add following to your init file to load the extension:

```

require('telescope').load_extension('fzf_mru')

```

### Telescope usage:

- `:Telescope fzf_mru` - Display MRU list as it would be display with `:FZFMru`

- `:Telescope fzf_mru current_path`  - List MRU files that are within current path (ignores `g:fzf_mru_relative` option).

- `:Telescope fzf_mru all` - List all MRU files (ignores `g:fzf_mru_relative` option).

## Todo

- [x] ~~Move CtrlP MRU functionality to the plugin itself~~

- [x] ~~Make `fzf.vim` optional dependency~~

- [ ] Add Vim help

## Credits

99% of MRU engine has been taken from [CtrlP](https://github.com/kien/ctrlp.vim).

## Contribution

Always welcome.

## License

MIT License;

The software is provided "as is", without warranty of any kind.