tv.vim

August 16, 2025 ยท View on GitHub

Ultra Fast Fuzzy finder for Vim8 and NeoVim for Television.

Television is a blazingly fast general purpose fuzzy finder TUI.

It is inspired by the neovim telescope plugin and is designed to be fast, efficient, simple to use and easily extensible. It is built on top of tokio, ratatui and the nucleo matcher used by the helix editor.

But very very experimental and some of the apis might not work yet and may change!

tv.vim

Usage

:Tv

Or type ,f

APIs

type: cmd

nnoremap <C-p> :execute system('git rev-parse --is-inside-work-tree') =~ 'true'
      \ ? tv#run({ 'type': 'cmd', 'cmd': 'git ls-files' })
      \ : 'Tv'<CR>

type: list

command! TvColors call tv#run({
    \ 'type': 'list',
    \ 'list': uniq(map(split(globpath(&rtp, "colors/*.vim"), "\n"), "substitute(fnamemodify(v:val, ':t'), '\\..\\{-}$', '', '')")),
    \ 'accept': {result->execute('colorscheme ' . result['items'][0])},
    \ })

Requirements

  • vim8 or neovim
  • tv binary v0.13.3 or later.

Installation

Install television binary from https://github.com/alexpasmantier/television/releases or use homebrew for Mac.

$ brew install television
  • Pathogen
    • git clone https://github.com/prabirshrestha/tv.vim.git ~/.vim/bundle/tv.vim
  • vim-plug
    • Plug 'prabirshrestha/tv.vim'
  • Vim packages
    • git clone https://github.com/prabirshrestha/tv.vim.git ~/.vim/pack/plugins/start/tv.vim

License

MIT

Author

Prabir Shrestha

Credits

This is heavily inspired by vim-fz