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

• Neovim: tv.nvim
• Vim: tv.vim
• VSCode: Television extension
• Zed: Telescope-style setup
• JetBrains IDEs: Television plugin

Documentation

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

Credits

• telescope.nvim
• nucleo
• ratatui