A fast and hackable fuzzy finder for the terminal.

About

Television is a fast and hackable fuzzy finder for the terminal.

It lets you search in real time through any kind of data source (called "channels") such as:

• files and directories
• code
• notes
• processes
• git repositories
• environment variables
• docker containers
• ...and much more (creating your own channels)

TL;DR

Create a new channel: ~/.config/television/cable/files.toml

[metadata]
name = "files"
description = "A channel to search through files and directories"
requirements = ["fd", "bat"]

[source]
command = "fd -t f"

[preview]
command = "bat -n --color=always '{}'"
env = { BAT_THEME = "Catppuccin Mocha" }

Start searching:

tv files

Switch channels using the remote control and pick from a list of community-maintained channels or create your own!.

See the channels docs for more info on how to set these up.

Installation

Automatic installation script:

curl -fsSL https://alexpasmantier.github.io/television/install.sh | bash

Package managers:

MacOS:

• Homebrew:

brew install television

Linux:

• Arch Linux:

pacman -S television

• Debian/Ubuntu:

VER=`curl -s "https://api.github.com/repos/alexpasmantier/television/releases/latest" | grep '"tag_name":' | sed -E 's/.*"tag_name": "([^"]+)".*/\1/'`
curl -LO https://github.com/alexpasmantier/television/releases/download/$VER/tv-$VER-x86_64-unknown-linux-musl.deb
echo $VER
sudo dpkg -i tv-$VER-x86_64-unknown-linux-musl.deb

• Chimera Linux:

apk add chimera-repo-user
apk add television

• Nix:

nix run nixpkgs#television

Windows:

• Scoop:

scoop bucket add extras
scoop install television

• Winget:

winget install --exact --id alexpasmantier.television

NetBSD:

• pkgsrc:

pkgin install television

Cross-platform:

• Cargo:

cargo install television

• Conda-forge:

pixi global install television

Precompiled binaries:

Download the latest release from the releases page.

Usage

tv  # default channel

tv [channel]  # e.g. `tv files`, `tv env`, `tv git-repos`, `tv my-awesome-channel` etc.

# pipe the output of your program into tv
my_program | tv

fd -t f . | tv --preview 'bat -n --color=always {}'

# or build your own channel on the fly
tv --source-command 'fd -t f .' --preview-command 'bat -n --color=always {}' --preview-size 70

Tip

🐚 Television has builtin shell integration. More info here.

For more information, check out the docs.

Credits

This project was inspired by the awesome work done by the telescope neovim plugin.

It also leverages the great helix editor's nucleo fuzzy matching library, the tokio async runtime as well as the formidable ratatui library.

A special thanks to tv's contributors for their help and support: