alexpasmantier/television

A very fast, portable and hackable fuzzy finder.

Source code at GitHub https://alexpasmantier.github.io/television/

{
  "createdAt": "2024-09-15T22:16:18Z",
  "defaultBranch": "main",
  "description": "A very fast, portable and hackable fuzzy finder.",
  "fullName": "alexpasmantier/television",
  "homepage": "https://alexpasmantier.github.io/television/",
  "language": "Rust",
  "name": "television",
  "pushedAt": "2026-03-21T23:24:51Z",
  "stargazersCount": 4940,
  "topics": [
    "cli",
    "command-line-tool",
    "fuzzy",
    "fuzzy-finder",
    "fuzzy-matching",
    "fuzzy-search",
    "fuzzyfinder",
    "grep",
    "rust",
    "television",
    "terminal",
    "tui",
    "tv"
  ],
  "updatedAt": "2026-03-22T02:27:38Z",
  "url": "https://github.com/alexpasmantier/television"
}

Television (tv)

A very fast, portable and hackable fuzzy finder.

GitHub Release docs.rs GitHub branch check runs GitHub License

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:

[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

Neovim: tv.nvim
Vim: tv.vim
VSCode: Television extension
Zed: Telescope-style setup

Documentation

Credits

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

Thanks to all contributors: