shin-kinoshita / visidata

A console spreadsheet tool for discovering and arranging data

VisiData v0.98.1

A terminal interface for exploring and arranging tabular data.

Dependencies

• Linux or OS/X
• Python 3.4+
• python-dateutil
• other modules may be required for opening particular data sources
  • for a breakdown, see supported sources in the VisiData manpage

Install

To install VisiData, with loaders for formats supported by the Python standard library (which includes csv, tsv, fixed-width text, json, sqlite and graphs):

$ pip3 install visidata

To install VisiData, plus external dependencies for all available loaders:

pip3 install "visidata[full]"

Run

$ vd [<options>] <input> ...
$ <command> | vd [<options>]

VisiData supports tsv, csv, xlsx, hdf5, sqlite, and more. Use -f <filetype> to force a particular filetype.

Documentation

• Quick reference: F1 (or z?) within vd will open the man page, which has a list of all commands and options.
• visidata.org has asciicasts of its tests, which serve as example workflows.

Support

If you want to chat about VisiData, make a feature request, or submit a bug report, we can be reached on either IRC or Reddit:

• r/visidata on reddit
• #visidata on freenode.net

For more detailed information about how you can contribute as a developer, influence the roadmap as a user, or provide us with sufficient information to better support you through any issues you come across see the CONTRIBUTING.md.

vdtui

The core vdtui.py can be used to quickly create efficient terminal workflows.

• vgit: a git interface
• vdgalcon: a port of the classic game Galactic Conquest

Other workflows should also be created as separate apps using vdtui. These apps can be very small; for example, see the included viewtsv.

License

The innermost core file, vdtui.py, is a single-file stand-alone library that provides a solid framework for building text user interface apps. It is distributed under the MIT free software license, and freely available for inclusion in other projects.

Other VisiData components, including the main vd application, addons, loaders, and other code in this repository, are available for reuse under GPLv3.

Credits

VisiData was created by Saul Pwanson <[email protected]>. Thanks to @anjakefala for test and release support, to @databranner for documentation, and to those wonderful users who contribute feedback in any form, for helping to make VisiData the awesome tool that it is.