+1
Daily
9,473
stars
378
forks
65
watchers
1,053
prs
1,728
issues
49
releases
README
VisiData v3.5
A terminal interface for exploring and arranging tabular data.
!Frequency table
VisiData supports tsv, csv, sqlite, json, xlsx (Excel), hdf5, and many other 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 or 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 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
Plugin Author's Guide and API Reference
Quick reference (available within vd with Ctrl+H), which has a list of commands and options.
Intro to VisiData Tutorial by Jeremy Singer-Vine
Help and Support
If you have a question, issue, or suggestion regarding VisiData, please create an issue on Github or chat with us at visidata on irc.libera.chat.
If you use VisiData regularly, please support me on Patreon!
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, and to those wonderful users who provide feedback, for helping to make VisiData the awesome tool that it is.Top issues
#2313[guides] Updating VisiData Documentation12 comments · 2024-02-14#3278regression: 'FileNotFoundError: [Errno 2] No such file or directory' when specifying filetype for remote URL5 comments · 2026-11-12#3279experimental/vimcompat: binding for go-pagedown-half conflicts with binding for save-cmdlog (Ctrl+D)1 comments · 2026-11-13#3276[batch] -o exits 0 when the save fails0 comments · 2026-11-11
Discussions
#3271v3.51 comments · 2026-10-28#3249vd-jev: ask a closed question about every row of a text column, get typed columns back1 comments · 2026-10-18#3183[Feature-Navigation] Any plan on adding half page up/down?1 comments · 2026-07-17#3168v3.42 comments · 2026-07-01#3135Data Cleaning Tip: Bulk Corrections with `ge`2 comments · 2026-06-07#3131Liberapay?1 comments · 2026-06-07#3110Sheet command to show name of current sheet on status line1 comments · 2026-05-28#3084Warning "setting unknown option color_selected_col" without setting option `color_selected_col`1 comments · 2026-05-14
Latest release
v3.5 v3.5 2026-10-28v3.5 v3.5 is mostly a fix-and-polish release after the big v3.4. We burned down the open issues backlog, and out of that came a rebuilt PostgreSQL loader, a new native DuckDB loader, and three security fixes. Security fixes Nine people reported three security issues in VisiData (eight of them found the same zip slip): - pandas: .pickle files are no longer loaded unless the new pandas_allow_pickle option is set (default off). Unpickling runs arbitrary code from the file, so opening an untrusted .pickle could execute it. CVE pending, reported by @Santoshkumarpuppala. - unzip_htt