# Install tidy-viewer with Homebrew, Nix

CLI csv pretty printer. Version 1.8.93 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:tidy-viewer
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install tidy-viewer
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#tidy-viewer
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ti/tidy-viewer/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:tidy-viewer
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/tidy-viewer>
- **Version:** 1.8.93
- **Source summary:** CLI csv pretty printer
- **Homepage:** <https://github.com/alexhallam/tv>
- **Repository:** <https://github.com/alexhallam/tv>
- **Upstream docs:** <https://github.com/alexhallam/tv#readme>
- **License:** Unlicense
- **Source archive:** <https://github.com/alexhallam/tv/archive/refs/tags/1.8.93.tar.gz>
- **Generated:** 2026-07-08T18:08:21+00:00

## Executables

- tidy-viewer (cli)
- tidy-viewer (alias)

## Build dependencies

- rust

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, sonoma, ventura, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 1.8.93
- Local data: ok
- Upstream repository: https://github.com/alexhallam/tv
- Upstream latest detected: 1.8.93 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

Tidy Viewer, commonly invoked as tv or tidy-viewer, is a Rust command-line pretty printer for tabular data. Its project README describes it as a cross-platform data pretty printer for CSV, TSV, PSV, and Parquet files, with streaming support for large datasets.

### Project history

The public GitHub repository was created in April 2021. The README presents the project as a terminal adaptation of ideas from R's pillar/tibble formatting, emphasizing significant-digit display, column styling, missing-value coloring, and width-aware truncation for data tables.

The project grew from a CSV pretty-printer into a small data-viewing workspace: the README now documents a Cargo workspace with tidy-viewer-core, tidy-viewer-cli, and tidy-viewer-py, and it highlights support beyond CSV/TSV into Parquet, Feather, and IPC-oriented data workflows.

### Adoption history

Official installation instructions list Cargo, Debian packages, AUR, Snap, Homebrew, and prebuilt release binaries for macOS, ARM, Windows, and source builds. That package spread is the clearest source-backed sign that the tool moved beyond a single-language Rust crate into the usual CLI distribution channels.

The repository metadata also shows the project positioned with tags such as cli, csv, data-science, dataframe, terminal, and pretty-printer, matching its adoption by users who want a fast terminal preview before reaching for heavier dataframe or spreadsheet tools.

### How it is used

Tidy Viewer is used as a terminal inspection step for delimited and columnar data: examples in the README pipe CSV files into tv, pass files as arguments, and combine color output with pagers such as less -R or bat.

For package-manager users, its appeal is that it turns common shell workflows around CSV or Parquet files into a readable table without starting Python, R, a database shell, or a spreadsheet application.

### Why package nerds care

In the package-nerd niche, Tidy Viewer belongs to the family of focused Rust CLIs that make Unix pipelines friendlier for data work. It is interesting less as an ecosystem-defining project and more as a practical bridge between classic text streams and dataframe-style terminal presentation.

Its Homebrew formula matters because macOS users can install the same tiny table viewer they might otherwise install via Cargo, keeping shell aliases and data-preview scripts portable across package managers.

### Timeline

- 2021: GitHub repository created for alexhallam/tv.
- 2021-2026: Official README documents distribution through Cargo, Debian, AUR, Snap, Homebrew, and release binaries.
- 2020s: README documents expansion from CSV-oriented viewing to Parquet, Feather, IPC, streaming, and Python bindings.

### Related projects

- The README names R's pillar project as formatting inspiration.
- The README positions tv beside command-line data manipulation tools and pagers rather than as a replacement for full dataframe systems.

### Sources

- <https://api.github.com/repos/alexhallam/tv - GitHub repository metadata for creation date, language, topics, and repository status.>
- <https://github.com/alexhallam/tv#readme - official README for purpose, features, installation channels, examples, architecture, and inspiration.>


## Security Notes

narrow executable package without higher-risk signals.

- **Geiger risk:** green / low
- narrow executable package without higher-risk signals

## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** tidy-viewer
- **Version Scheme:** 0
- **Revision:** 0
- **Conflicts With:** television
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** stable

## Other Package-Manager Records

- Nix - tidy-viewer: normalized package name match | nixpkgs package indexes: pkgs/by-name/ti/tidy-viewer/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [rust](https://www.automicvault.com/pkg/brew/rust/) - Build dependency declared by Homebrew.
- [csvtk](https://www.automicvault.com/pkg/brew/csvtk/) - Shares av.db curated category or tags: cli, csv, data, tsv.
- [dsq](https://www.automicvault.com/pkg/brew/dsq/) - Shares av.db curated category or tags: cli, csv, data, parquet.
- [miller](https://www.automicvault.com/pkg/brew/miller/) - Shares av.db curated category or tags: cli, csv, data, tsv.
- [qo](https://www.automicvault.com/pkg/brew/qo/) - Shares av.db curated category or tags: cli, csv, data, tsv.
- [cqlkit](https://www.automicvault.com/pkg/brew/cqlkit/) - Shares av.db curated category or tags: cli, csv, data.
- [csvkit](https://www.automicvault.com/pkg/brew/csvkit/) - Shares av.db curated category or tags: cli, csv, data.
- [csvlens](https://www.automicvault.com/pkg/brew/csvlens/) - Shares av.db curated category or tags: cli, csv, data.
- [csvq](https://www.automicvault.com/pkg/brew/csvq/) - Shares av.db curated category or tags: cli, csv, data.

## Combined YAML source

View the package source record on GitHub. [combined/tidy-viewer.yml](https://github.com/automic-vault/db/blob/main/combined/tidy-viewer.yml)


## Sources

- Nucleus package database
- Geiger risk classifier
- package-page enrichment
- curated package history
- package version freshness
- av.db category and tag curation
- package relationship graph
- external package-manager database matches
- cross-ecosystem install command graph