A fast, feature-rich CSV/TSV/delimited file viewer for the command line

• Features
• Installation
  • Quick Install (Linux/macOS)
  • Package Managers
  • Build from Source
• Quick Start
• Command Line Flags
• Key Bindings
• Features in Detail
  • Progressive Loading
  • Data Types and Sorting
  • Statistics and Visualization
  • Search
  • Column Filter
  • Text Wrapping
• Filter Operators Guide
• Advanced Examples
  • Biological Data Formats

tv brings spreadsheet-like functionality to your terminal with vim-inspired controls.

• Spreadsheet interface - Navigate and view tabular data with frozen headers
• Smart parsing - Automatically detects delimiters (CSV, TSV, custom separators)
• Progressive loading - Start viewing large files immediately while they load
• Gzip support - Read compressed files directly
• Powerful search - Find text across all cells with highlighting and regex pattern matching support
• Advanced filtering - Filter rows with complex regex queries
• Flexible sorting - Sort by any column with intelligent type detection
• Text wrapping - Wrap long cell content for better readability
• Statistics & plots - View column statistics with visual distribution charts
• Vim keybindings - Navigate naturally with h/j/k/l and more
• Mouse support - Click to select cells, scroll with mouse wheel, interact with dialogs
• Pipe support - Read from stdin for seamless integration with shell pipelines

curl -sSL https://raw.githubusercontent.com/codechenx/tv/master/install.sh | bash
sudo mv tv /usr/local/bin/

Debian/Ubuntu (.deb)

# Download from releases page
wget https://github.com/codechenx/tv/releases/download/v0.7.1/tv_0.7.1_linux_amd64.deb
sudo dpkg -i tv_*.deb

CentOS/Fedora (.rpm)

# Download from releases page
wget https://github.com/codechenx/tv/releases/download/v0.7.1/tv_0.7.1_linux_amd64.rpm
sudo rpm -i tv_*.rpm

Arch Linux (AUR)

yay -S tv-bin

Snap (Linux)

sudo snap install codechenx-tv
sudo snap alias codechenx-tv tv

Go Install

go install github.com/codechenx/tv@latest

Download pre-built binaries from releases for:

• Linux (x86_64, ARM, ARM64)
• macOS (Intel, Apple Silicon)
• Windows (x86_64, i386)

Requires Go 1.21 or later:

git clone https://github.com/codechenx/tv.git
cd tv
go build -ldflags="-s -w" -o tv

View a CSV file:

tv data.csv

View a TSV file (tab-separated):

tv data.tsv

Read from stdin:

cat data.csv | tv
ps aux | tv

Specify a custom delimiter:

tv data.txt -s "|"

View only specific columns:

tv data.csv --columns 1,3,5

Skip header lines (e.g., for VCF files):

tv file.vcf --skip-prefix "##"

Syntax: tv [FILE] [flags]

Examples:

# Use custom delimiter
tv data.txt -s ","

# View only columns 1, 3, and 5
tv data.csv --columns 1,3,5

# Skip lines starting with "#"
tv data.txt --skip-prefix "#"

# Disable header freezing
tv data.csv -f -1

# Disable async loading for slow systems
tv large.csv --async=false

tv uses vim-inspired keybindings for intuitive navigation.

Note: Mouse support works in most modern terminals. If your terminal doesn't support mouse events, you can still use keyboard navigation exclusively.

Start viewing large files instantly without waiting for them to fully load. The UI appears immediately and updates as data streams in.

# Default behavior - UI appears instantly
tv huge_dataset.csv

# Disable if you prefer traditional loading
tv huge_dataset.csv --async=false

Progress indicators:

• Files show percentage: Loading... 45.2% → Loaded 1,000,000 rows
• Pipes show row count: Loading... 5,234 rows → Loaded 10,000 rows
• Updates at 50 FPS for smooth rendering

tv automatically detects column types and provides intelligent sorting.

Type Detection: When loading data, tv analyzes each column to determine if it contains strings, numbers, or dates using a 90% confidence threshold.

Manual Type Toggle: Press t to cycle through types for the current column:

• String → Number → Date → String

Sorting Behavior:

• Strings: Alphabetical order
• Numbers: Numeric order (supports integers, floats, scientific notation, thousands separators)
• Dates: Chronological order (supports ISO-8601, US format, EU format, and more)

Analyze your data with comprehensive statistics and modern ASCII plots.

View Statistics: Press i on any column to open an interactive statistics dialog that displays:

For numeric columns:

• Summary stats: count, min, max, range, sum
• Central tendency: mean, median, mode
• Dispersion: standard deviation, variance
• Quartiles: Q1, Q2, Q3, and IQR
• Visual distribution: Histogram plot showing data distribution

For categorical/string columns:

• Total values, unique values, missing/empty count
• Frequency distribution with percentages
• Visual distribution: Bar chart of top 15 most frequent values

Important: When column filters are active, statistics are calculated only on the filtered/visible data, not the entire dataset. The dialog title will indicate when statistics are based on filtered data and show the number of active filters.

The statistics dialog features a split-pane layout with numerical stats on the left and an ASCII graph visualization on the right, powered by asciigraph for modern, clean plots.

Find text anywhere in your table with full highlighting support and powerful regex pattern matching.

How to search:

1. Press / to open the search dialog
2. Type your search term.
3. Optional: Press Tab to navigate to the checkboxes, then Space to enable:
   • Use Regex: for pattern matching with regular expressions.
   • Case Sensitive: for case-sensitive matching.
4. Press Enter to execute the search.
5. Navigate results with n (next) and N (previous).
6. Press Esc to clear highlighting.

Search Modes:

• Plain Text (default): Case-insensitive substring matching. Enable Case Sensitive for exact matching.
• Regex: Full regular expression support. By default, regex is case-insensitive. Enable Case Sensitive for case-sensitive regex matching.

Navigation in Search Dialog:

• Type your search query in the text field.
• Press Tab to move between the search field, checkboxes, and buttons.
• Press Space to toggle a checkbox when it is focused.
• Press Enter from anywhere in the form to execute the search.
• Press Esc to cancel and close the dialog.

Visual feedback:

• Current match: bright cyan highlight
• Other matches: gray highlight
• Footer shows position: Match 3/12 or regex matches 3/12

Example:

# Simple text search (case-insensitive)
/ → type "error" → Enter → n → n → N → Esc

# Case-sensitive text search
/ → check "Case Sensitive" → type "Error" → Enter

# Regex search examples
/ → check "Use Regex" → type "^ERROR" → Enter     # Lines starting with ERROR (case-insensitive)
/ → check "Use Regex" and "Case Sensitive" → type "^Error" → Enter # Lines starting with Error (case-sensitive)
/ → check "Use Regex" → type "\\d{4}-\\d{2}-\\d{2}" → Enter     # Date patterns (YYYY-MM-DD)
/ → check "Use Regex" → type "user(name)?" → Enter           # Match "user" or "username"
/ → check "Use Regex" → type "error|warning|critical" → Enter # Match any of these words
/ → check "Use Regex" → type "@.*\\.(com|org)$" → Enter       # Email domains ending in .com or .org

Common Regex Patterns:

Note: For case-insensitive regex search, the (?i) flag is automatically added to your pattern. For case-sensitive regex, this flag is omitted.

Show only rows where specific columns match your criteria. Supports filtering on multiple columns simultaneously.

How to filter:

1. Navigate to the column you want to filter
2. Press f to open the filter dialog
3. Use the dropdown to select an operator (e.g., contains, equals, regex, >).
4. Enter the value to filter by.
5. Optionally, check the Case Sensitive box.
6. Press Enter to apply the filter.
7. Repeat on other columns to add more filters
8. Press r on a filtered column to remove that column's filter

Multi-Column Filtering:

• Apply filters to multiple columns by pressing f on each column and entering criteria
• All filters are combined with AND logic (rows must match all active filters)
• Each column can have different filter criteria including operators
• Press f on a filtered column to edit or remove its filter (empty query removes the filter)
• The footer shows how many filters are active
• Filtered column headers display 🔎 icons with orange background

Operators:

Key Features:

• Numeric operators (>, <, >=, <=): Only work on numeric and date columns (automatically detected). Perform numeric comparisons instead of text matching.
• Regex: Provides the full power of regular expressions for complex pattern matching.
• Case-Insensitive by default: All string-based comparisons are case-insensitive unless the Case Sensitive box is checked.
• Visual indicator: Filtered column headers show 🔎 icons and an orange background

Examples:

# Simple filter - partial match
Navigate to "Status" column → f → select 'contains' → type "pending" → Enter
# Result: Matches "Pending", "Pending Review", etc.

# Exact match filter
Navigate to "Status" column → f → select 'equals' → type "active" → Enter
# Result: Rows where Status is exactly "active" (case-insensitive)

# Regex filter
Navigate to "Email" column → f → select 'regex' → type "^.+@gmail\.com$" → Enter
# Result: Rows where Email ends with "@gmail.com"

# Numeric comparison - greater than
Navigate to "Age" column → f → select '>' → type "30" → Enter
# Result: Rows where Age is greater than 30

# Multi-column filtering
Navigate to "City" column → f → select 'equals' → type "New York" → Enter
Navigate to "Department" column → f → select 'contains' → type "Engineering" → Enter
# Result: Rows where City is "New York" AND Department contains "Engineering"

# Edit existing filter
Navigate to filtered column → f → modify operator/value → Enter
# Or enter empty text to remove that column's filter

# Remove a specific filter
Navigate to filtered column → Press r
# Result: That column's filter removed, other filters remain

Visual Feedback:

• When a filter is active, the filtered column header displays 🔎 icons and an orange background
• A dedicated filter strip appears above the main footer showing the active filter on the current column.
• Filter strip format: 🔎 Filter Active: [Column Name] [operator] "query" | Press 'r' to clear
• The strip automatically hides when you move to a different column
• Press r to clear the filter and return to normal view

Handle long cell content without horizontal scrolling.

How to wrap:

• Press W (capital W) on any column to toggle wrapping
• First press: wraps at 25 characters with smart word breaks
• Second press: unwraps back to single line

Smart wrapping:

• Breaks at spaces and hyphens when possible
• Each column can be wrapped independently
• Useful for comments, descriptions, URLs

tv handles common bioinformatics file formats with comment/header prefixes.

VCF files:

# Skip VCF metadata lines
tv sample.vcf --skip-prefix "##"
tv sample.vcf.gz --skip-prefix "##"

QIIME OTU tables:

tv otu_table.txt --skip-prefix "# "

MAF (Mutation Annotation Format):

tv mutations.maf --skip-prefix "#"

Interval lists:

# Skip SAM header lines
tv intervals.interval_list --skip-prefix "@HD","@SQ"

# Or skip all @ lines
tv intervals.interval_list --skip-prefix "@"

BED files with headers:

tv peaks.bed --skip-prefix "track","browser"

Large log files:

# View first 1000 lines only
tv app.log -n 1000

# Skip timestamp lines
tv app.log --skip-prefix "2024"

CSV with specific columns:

# Show only columns 1, 3, and 5
tv data.csv --columns 1,3,5

# Hide sensitive columns 2 and 4
tv data.csv --hide-columns 2,4

Pipeline integration:

# View process list
ps aux | tv

# View git log as table
git log --pretty=format:"%h,%an,%ar,%s" | tv -s ","

# Parse JSON with jq, view as table
cat data.json | jq -r '.[] | [.id, .name, .value] | @csv' | tv

Custom delimiters:

# Pipe-separated
tv data.txt -s "|"

# Semicolon-separated
tv data.txt -s ";"

# Multiple spaces
tv data.txt -s "  "

• Large files? Let async loading work its magic - the UI appears instantly
• Can't find data? Use / to search across all cells
• Too many columns? Use --columns to show only what you need
• Long text? Press W to wrap the current column
• Wrong sort order? Press t to change the column type, then s to re-sort
• Complex filtering? Use OR for alternatives, AND for requirements, ROR to combine results
• Need insights? Press i for comprehensive statistics with visual plots - histograms for numeric data, frequency charts for categorical data
• Prefer mouse? Click cells to select them, use scroll wheel to navigate, and click buttons in dialogs

Apache License - see LICENSE file for details.