television 0.15.5

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

Television (tv)

A very fast, portable and hackable fuzzy finder.

GitHub Release docs.rs GitHub branch check runs GitHub License Discord

About

Television is a fast, portable fuzzy finder for the terminal. It lets you search in real-time through any kind of data source such as files, text, git repositories, environment variables, docker containers, and more.

Read the documentation

Quick Start

tv              # Search files (default channel)
tv text         # Search file contents
tv git-repos    # Find git repositories
tv --help       # See all options

For a complete introduction, see the Quickstart Guide.

Installation

Quick Install (Recommended)

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

Package Managers

Platform Command
Arch Linux pacman -S television
Homebrew brew install television
Cargo cargo install television
Scoop scoop bucket add extras && scoop install television
WinGet winget install --exact --id alexpasmantier.television
Nix nix run nixpkgs#television

For more installation options, see Installation.

Custom Channels

Create custom channels for any workflow. Here's an example TLDR channel:

# ~/.config/television/cable/tldr.toml
[metadata]
name = "tldr"
description = "Browse TLDR pages"

[source]
command = "tldr --list"

[preview]
command = "tldr '{}'"

[keybindings]
ctrl-e = "actions:open"

[actions.open]
command = "tldr '{}'"
mode = "execute"

Learn more about creating channels.

Shell Integration

Enable smart autocomplete (Ctrl+T) and history search (Ctrl+R):

# Zsh
echo 'eval "$(tv init zsh)"' >> ~/.zshrc

# Bash
echo 'eval "$(tv init bash)"' >> ~/.bashrc

See Shell Integration for more shells.

Editor Integration

Documentation

Credits

Inspired by telescope.nvim. Built with nucleo (fuzzy matching), tokio (async runtime), and ratatui (TUI framework).

Thanks to all contributors: