alexpasmantier/television
Television
Television is a terminal-based search launcher that provides real-time fuzzy matching across multiple data sources, including files, git repositories, environment variables, shell history, and custom user-defined channels. It presents a multi-panel terminal interface where search results, previews, and input are displayed simultaneously, with a frecency-based ranking engine that combines match quality with the frequency and recency of past selections to surface the most relevant entries.
The project is built around a declarative, TOML-driven architecture where search channels, previews, and actions are defined entirely through configuration files without requiring code changes. Users can chain string transformations through a template system to format entries and previews dynamically, link multiple actions sequentially so the output of one step becomes the input of the next, and bind custom keyboard combinations to trigger shell commands or interface changes. This framework allows the tool to adapt to arbitrary data sources and workflows beyond its built-in searches.
Beyond its core search capabilities, Television supports shell autocompletion integration that analyzes text as the user types, fuzzy history search with context-aware suggestions, and the ability to execute external commands on selected entries for post-search processing. Users can create ad-hoc search sources from the command line, switch between channels mid-session, select multiple entries at once, and control result sorting on a per-channel basis. The tool also includes utilities for stripping ANSI escape codes from text and processing input piped from standard input.
Features
- TOML-Configured Search Launchers - Provides a configurable search launcher that searches files, git repos, environment variables, and custom TOML-defined sources.
- File Search - Searches files in directory trees by name with real-time fuzzy matching for selection.
- Pattern-Based Filters - Provides real-time file filtering with fuzzy, substring, prefix, suffix, and negated pattern matching.
- Terminal-Based Multi-Source Queries - Queries and filters across files, git repositories, and environment variables from a single terminal interface.
- Search Channel Definitions - Defines search channels via TOML files, specifying source commands, previews, and keybindings.
- Unified Multi-Source Queries - Queries files, git repos, environment variables, and custom channels through a single search interface.
- Chained Selection Actions - Chains multiple operations on selected entries, passing output from one step as input to the next.
- Frecency-Based Ranking - Ranks search results by combining match quality with frequency and recency of past selections.
- Fuzzy Search Tools - Searches and navigates files and directories in real-time using fuzzy matching patterns.
- Multi-Source Fuzzy Searchers - Simultaneously searches files, git repositories, environment variables, and custom channels using fuzzy matching.
- Interactive Fuzzy Finders - Provides an interactive terminal interface for searching and filtering data from multiple sources with real-time fuzzy matching.
- TOML Configuration Support - Manages all core behavior, preferences, and tool settings through a single TOML file.
- Search Framework Configurations - Defines search channels, previews, and actions entirely through TOML configuration files without requiring code changes.
- Real-Time Search Utilities - Provides instant, as-you-type fuzzy matching to search files and directories in real time.
- Contextual Preview Panels - Runs a command with the selected entry as a placeholder and shows the output in a preview panel.
- TOML Configuration Managers - Manage application behavior through a single TOML configuration file for all core settings.
- String-Pipeline Formatting - Transforms raw data into formatted entries and previews by chaining string operations through a template syntax.
- Terminal Action Pipelines - Provides a pipeline system for chaining user-defined actions on selected entries within the terminal interface.
- Multi-Panel Layouts - Renders a split-screen TUI with separate panels for results, previews, and input using terminal escape sequences.
- Real-Time Fuzzy Matchers - Filters search results in real time using a fuzzy matching algorithm as the user types.
- Channel-Specific Previews - Shows a preview of the selected entry in a separate pane using a channel-specific previewer.
- Fuzzy File Content Searches - Searches textual content within files in a directory tree using fuzzy matching to return matching lines.
- Ad-Hoc Search Channels - Creates temporary search channels from the command line using CLI flags for ad-hoc searches.
- Mid-Session Channel Switching - Switches between search channels mid-session to refine results across different data sources.
- Predefined Action Triggers - Execute a predefined operation like opening a file, copying a path, or quitting the application.
- Custom Selection Actions - Execute an external command on a selected entry to perform arbitrary post-search processing.
- Repository Name Searches - Searches git repositories on the file system by name or path with fuzzy matching.
- String Pipeline Templates - Format entries, previews, and outputs using a string-pipeline template system for dynamic, customizable display.
- Search Channel Switchers - Open a channel picker to change the active data source without restarting the application.
- Alias Value Searches - Searches shell aliases and their values with fuzzy matching for quick selection.
- Shell Autocompletion Providers - Searches shell command history and provides context-aware autocomplete suggestions.
- Shell History Search Engines - Fuzzy search command history and get context-aware autocomplete suggestions directly in the shell.
- Stdin Stream Searchers - Searches lines of text piped from standard input with fuzzy matching.
- Custom Key Action Bindings - Map a key combination to a custom action that runs a shell command in the background or replaces the interface.
- Environment Variable Browsers - Lists and filters system environment variables with real-time fuzzy search.
- Environment Variable Searchers - Searches environment variables and their values to return matching entries.
- Entry Template Processors - Apply a template to each entry, using placeholders like {} to represent the full entry text.
- Channel Field Formatters - Apply string transformations to channel fields at runtime using a templating syntax for dynamic content.
- Result List Multi-Selections - Enables selecting multiple entries from search results and outputting them together.
- Search and Discovery - A very fast general purpose fuzzy finder.
- General Utilities - General purpose fuzzy finder TUI.
- Notes & Productivity - General purpose fuzzy finder TUI.
- Productivity and Utilities - General-purpose fuzzy finder.
