Skip to main content

tv(1)

A very fast, portable and hackable fuzzy finder for the terminal.

$curl -fsSL https://alexpasmantier.github.io/television/install.sh | bash
tv - filesTelevision running in a terminal, fuzzy-searching channel files with a TOML preview panel

tv is a general-purpose fuzzy finder: it reads lines from a source command, lets you search through them in real time with a live preview, and prints your selection to stdout, so it composes with scripts and pipes like any other unix tool.

fd -t f | tv | xargs -o nvim

Searches you run often don't need to be retyped: a channel bundles a source command with an optional preview, keybindings, and actions to run on the selection when you exit, all in a single TOML file.

~/.config/television/cable/git-log.toml
[metadata]
name = "git-log"
description = "Search through git log"

[source]
command = "git log --oneline --color=always"

[preview]
command = "git show -p '{split: :0}'"

tv ships with channels for files, git repositories, environment variables, processes and more. tv update-channels pulls from the community collection (100+ channels), or write your own.