FVI — Vim paired with Grep
- Author:
Ken Kundert
- Version:
2.3
- Released:
2026-06-28
Opens files that contains a given pattern in vim. You may specify a collection of files to search, otherwise all files in the current working directory and all sub directories are searched.
Within vim use n to move to next occurrence of pattern. Ctrl-n moves to next file and ctrl-p moves to the previous file. vim is run with autowrite set. Any directories, unreadable files, or binary files in the file list are ignored.
The pattern is a literal text string. Regular expressions are not supported.
Use – to terminate the command line options. Any thing that follows – is treated as the pattern. You can search for patterns that start with - by preceding the pattern with –.
Arguments
fvi [options] [–] pattern [file … ]
Options
- -i, --ignore-case
ignore case
- -w, --word
match a word
- -o, --only <glob>
a glob string used to specify desired files, can use brace expansion to specify multiple globs
- -e, --exclude <glob>
a glob string used to filter out unwanted files, can use brace expansion to specify multiple globs
- -H, --hidden
include hidden files
- -b, --binary
do not skip binary files (any not encoded in ascii or utf-8)
- -g, --gvim
open files in gvim rather than vim
- -v, --vim
open files in vim rather than gvim
- -W, --warn
do not suppress warnings about directories and binary files
- -h, --help
show help message and exit
If both --only and --exclude are specified, both must be satisfied.
Examples
Search specified files:
fvi ‘#!/usr/bin/env python3’ ~/bin/*
Search all files in current hierarchy:
fvi ‘unknown key’
Installation
Runs only on Unix systems. Requires Python 3.6 or later.
Install using:
pip install fvi
Configuration
The file ~/.config/fvi/settings.nt is read if it exists. This is a NestedText file that can contain settings: vim, gvim, and gui. The first specify the commands used to invoke vim and gvim. The last is a Boolean that indicates whether gvim is used by default (use yes or no). For example:
vim: vimx gvim: gvim gui: yes
In this example, vimx is used rather than vim so that copy and paste using X11 works as expected.
Metadata
Release files for fvi 2.3
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| fvi-2.3.tar.gz | 16.9 kB | Without provenance | Details for fvi-2.3.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| fvi-2.3-py3-none-any.whl | Python 3 | none | any | Details for fvi-2.3-py3-none-any.whl |
Total release size: 35.2 kB
Release files / fvi-2.3.tar.gz
| Download URL | fvi-2.3.tar.gz |
|---|---|
| Size | 16.9 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
a5058741e8f0a07005614a90eb1f9b4e1ac37f6e5f1a3515958cf8532741b829
|
|
BLAKE2b-256 checksum How to use checksums |
d0e275ba24365dbe9aeb67d09c57c8c24b88db9416a44f3f58243890bf56aec1
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.5
|
Release files / fvi-2.3-py3-none-any.whl
| Download URL | fvi-2.3-py3-none-any.whl |
|---|---|
| Size | 18.3 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
2e40d8b63f479e32bebf82db132c9c08c73247ad303281c7f3944b49d1448101
|
|
BLAKE2b-256 checksum How to use checksums |
fd3fd81cfa742e6fbf5a0228b5f8b9fef1d3e275a54d1513e305542a54bd8614
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.14.5
|
Security for fvi 2.3
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.