<div align="center">

Television (tv)

A very fast, portable and hackable fuzzy finder.

<img width="1473" height="761" alt="image" src="https://github.com/user-attachments/assets/0ff21160-6060-4804-ae0b-2ce9500ed9c5" /> </div>

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 (<kbd>Ctrl</kbd>+<kbd>T</kbd>) and history search (<kbd>Ctrl</kbd>+<kbd>R</kbd>):

# 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

• Getting Started
• User Guide
• Tips and Tricks
• Reference

Credits

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

Thanks to all contributors:

<a href="https://github.com/alexpasmantier/television/graphs/contributors"> <img src="https://contrib.rocks/image?repo=alexpasmantier/television" /> </a>