LinuxCommandLibrary
GitHubF-DroidGoogle Play Store

tidy-viewer

Cross-platform tabular data pretty-printer

TLDR

Pretty-print a CSV file
$ tidy-viewer [path/to/file.csv]
copy
Pretty-print data piped from stdin
$ cat [path/to/file.csv] | tidy-viewer
copy
Use a custom delimiter
$ tidy-viewer -s "|" [path/to/file.psv]
copy
Tab-separated input via delimiter
$ tidy-viewer -s $'\t' [path/to/file.tsv]
copy
Display with a specific color palette
$ tidy-viewer -c [3] [path/to/file.csv]
copy
Print all rows with color and page through output
$ tidy-viewer -af [path/to/file.csv] | less -RS
copy

SYNOPSIS

tidy-viewer [options] [file]

DESCRIPTION

tidy-viewer is a cross-platform CLI tool for pretty-printing tabular data in the terminal. It reads CSV, TSV, PSV, Parquet, Arrow IPC, and Feather files from paths or stdin, then renders column-aligned tables with color styling, significant-figure formatting, and NA highlighting for missing values.The tool prints row and column dimensions first, truncates long strings to preserve alignment, and skips columns that do not fit the terminal width (listing extras in a footer). Large files stream automatically for memory efficiency. Output is optimized for readability rather than literal fidelity.Commonly aliased as tv; the installed binary name is tidy-viewer.

PARAMETERS

-s, --delimiter DELIM

Field separator. Default: comma. Use a tab character for TSV.
-c, --color N
Color palette: 1 (nord), 2 (one_dark), 3 (gruvbox), 4 (dracula), 5 (solarized light).
-n, --number-of-rows-to-output ROWS
Number of rows to display. Default: 25.
-t, --title TITLE
Optional table title.
-a, --color-always
Force color output even when not a TTY.
-f, --force-all-rows
Print every row instead of the default preview limit.
-e, --extend-width-and-length
Extend output beyond terminal width/length for paging with less.
-g, --sigfig N
Significant digits for numbers (default 3, max 7).
-C, --config-details
Show the active configuration.
-h, --help
Show help and example configuration.

CONFIGURATION

Settings live in a TOML dotfile. Location depends on OS:

Linux: $XDG_CONFIG_HOME/tv.toml or ~/.config/tv.toml
macOS: ~/Library/Application Support/tv.toml
Windows: %AppData%\tv.toml
Every key must be present or the file is ignored. Run tidy-viewer --help for a full example template. Use tidy-viewer --config-details to inspect active settings.

INSTALL

brew install tidy-viewer
copy
nix profile install nixpkgs#tidy-viewer
copy

CAVEATS

Multiple unrelated tools share the short name tv. This entry documents the Rust tidy-viewer binary. Partial config files are silently ignored.

SEE ALSO

tv(1), column(1), csvlook(1), miller(1)

RESOURCES

Source code · Documentation

Copied to clipboard
Kai