https://github.com/saulpw/visidata
A terminal spreadsheet multitool for discovering and arranging data
https://github.com/saulpw/visidata
cli csv datajournalism datawrangling devops-tools eda hdf5 json opendata pandas python reconciliation spreadsheet sqlite tabular-data tsv tui unix-toolkit
Last synced: 13 days ago
JSON representation
A terminal spreadsheet multitool for discovering and arranging data
- Host: GitHub
- URL: https://github.com/saulpw/visidata
- Owner: saulpw
- License: gpl-3.0
- Created: 2016-10-27T04:21:00.000Z (about 10 years ago)
- Default Branch: develop
- Last Pushed: 2026-09-29T01:06:22.000Z (about 1 month ago)
- Last Synced: 2026-10-11T22:36:58.683Z (20 days ago)
- Topics: cli, csv, datajournalism, datawrangling, devops-tools, eda, hdf5, json, opendata, pandas, python, reconciliation, spreadsheet, sqlite, tabular-data, tsv, tui, unix-toolkit
- Language: Python
- Homepage: http://visidata.org
- Size: 53.1 MB
- Stars: 9,332
- Watchers: 70
- Forks: 374
- Open Issues: 91
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE.gpl3
- Code of conduct: CODE_OF_CONDUCT.md
- Agents: AGENTS.md
Awesome Lists containing this project
- awesome-uvx - visidata - 07-01 | (Data Processing & Exploration)
- awesome-python - saulpw/visidata - A terminal spreadsheet multitool for discovering and arranging data (User Interface / Applications and End User Tools)
- awesome-python-applications - Repo
- fucking-Awesome-Linux-Software - ](https://github.com/saulpw/visidata/actions/workflows/main.yml)
[](https://gitpod.io/#https://github.com/saulpw/visidata)
[](https://visidata.org/chat)
[](https://fosstodon.org/@saulpw)
A terminal interface for exploring and arranging tabular data.
VisiData supports tsv, csv, sqlite, json, xlsx (Excel), hdf5, and [many other formats](https://visidata.org/formats).
## Platform requirements
- Linux, OS/X, or Windows (with WSL)
- Python 3.8+
- additional Python modules are required for certain formats and sources
## Install
To install the latest release from PyPi:
pip3 install visidata
To try VisiData without installing, use [pipx](https://pipx.pypa.io/) or [uv](https://docs.astral.sh/uv/):
pipx run visidata # or: uvx visidata
To install permanently (adds `vd` to your PATH):
pipx install visidata # or: uv tool install visidata
Additional Python packages are needed for some formats:
pipx install visidata --preinstall openpyxl --preinstall lxml
# or: uv tool install visidata --with openpyxl --with lxml
To add format packages to an existing pipx install:
pipx inject visidata openpyxl lxml
To install the cutting edge `develop` branch (no warranty expressed or implied):
pip3 install git+https://github.com/saulpw/visidata.git@develop
If VisiData reports `package X not installed` even after you installed it, `vd`
is almost certainly running from a different environment than the one you
installed the package into. Check `which vd`, then install the package into
*that* environment — e.g. `pipx inject visidata X` for a pipx install, or the
Homebrew Python for `brew install visidata`.
See [visidata.org/install](https://visidata.org/install) for detailed instructions for all available platforms and package managers.
### Usage
$ vd
$ | vd
Press `Ctrl+Q` to quit at any time.
Hundreds of other commands and options are also available; see the documentation.
### Documentation
* [VisiData documentation](https://visidata.org/docs)
* [Plugin Author's Guide and API Reference](https://visidata.org/docs/api)
* [Quick reference](https://visidata.org/man) (available within `vd` with `Ctrl+H`), which has a list of commands and options.
* [Intro to VisiData Tutorial](https://jsvine.github.io/intro-to-visidata/) by [Jeremy Singer-Vine](https://www.jsvine.com/)
### Help and Support
If you have a question, issue, or suggestion regarding VisiData, please [create an issue on Github](https://github.com/saulpw/visidata/issues) or chat with us at #visidata on [irc.libera.chat](https://libera.chat/).
If you use VisiData regularly, please [support me on Patreon](https://www.patreon.com/saulpw)!
## License
Code in the `stable` branch of this repository, including the main `vd` application, loaders, and plugins, is available for use and redistribution under GPLv3.
## Credits
VisiData is conceived and developed by Saul Pwanson ``.
Anja Kefala `` maintains the documentation and packages for all platforms.
Many thanks to numerous other [contributors](https://visidata.org/credits/), and to those wonderful users who provide feedback, for helping to make VisiData the awesome tool that it is.