television Documentation

File: README.md Copy Chapter

About Copy Chapter

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 Copy Chapter

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 Copy Chapter

Quick Install (Recommended) Copy Section

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

Package Managers Copy Section

For more installation options, see Installation.

Custom Channels Copy Chapter

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 Copy Chapter

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 Copy Chapter

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

Documentation Copy Chapter

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

Credits Copy Chapter

• telescope.nvim
• nucleo
• ratatui

File: docs/intro.md Copy Chapter

sidebar_position: 0 slug: / title: Television Copy Chapter

Television

A fast, portable and hackable fuzzy finder for the terminal.

Quick Install Copy Chapter

curl -sSL https://raw.githubusercontent.com/alexpasmantier/television/refs/heads/main/install.sh | sh

Or see Installation for other methods.

What is Television? Copy Chapter

Television is a fuzzy finder that lets you search through any kind of data in real-time. It comes with built-in channels for common tasks like finding files, searching git repositories, browsing environment variables, and more.

You can also create your own custom channels to search through any data source you need.

Getting Started Copy Chapter

New to Television? Start here:

• Installation - Install Television on your system
• Quickstart - Learn the basics in 5 minutes
• Your First Channel - Create a custom channel

Documentation Copy Chapter

• User Guide - Learn about channels, configuration, keybindings, and more
• Advanced - Deep dive into templates, tips and tricks, and troubleshooting
• Reference - Complete CLI, actions, and configuration reference
• Community - Community channels and contributions
• Developers - Contributing guidelines and architecture