A console spreadsheet tool for discovering and arranging data
Python HTML CSS
Latest commit 371857e Aug 13, 2017 Saul Pwanson Use getGlobals() in eval instead of globals()

README.md

VisiData v0.95.1 CircleCI

A terminal interface for exploring and arranging tabular data

VisiData silent demo

A few interesting commands:

  • Shift-F pushes a frequency analysis of the current column
  • = creates a new column from the given Python expression (use column names to refer to their contents)
  • ; creates new columns from the match groups of the given regex

Getting Started

Install VisiData

from pypi (stable branch)

$ pip3 install visidata

or clone from git

$ git clone http://github.com/saulpw/visidata.git
$ cd visidata
$ pip install -r requirements.txt
$ python setup.py install

Dependencies

  • Python 3.3+
  • h5py and numpy (if opening .hdf5 files)

Remember to install the Python3 versions of these packages with e.g. pip3

Run VisiData

If installed via pip3, vd should launch without issue.

$ vd [<options>] [<inputs> ...]

If no inputs are given, vd opens the current directory. Unknown filetypes are by default viewed with a text browser.

If installed via git clone, first set up some environment variables (on terminal):

$ export PYTHONPATH=<visidata_dir>:$PYTHONPATH
$ export PATH=<visidata_dir>/bin:$PATH

Further documentation is available at readthedocs.

Contributing

VisiData was created by Saul Pwanson <vd@saul.pw>.

VisiData needs lots of usage and testing to help it become useful and reliable. If you use VisiData, I would love it if you would send me a screencast! Maybe there is an easy way to improve the tool for both of us.

Also please create a GitHub issue if anything doesn't appear to be working right. If you get an unexpected error, please include the full stack trace that you get with Ctrl-e.

Branch structure

Visidata has two main branches:

  • stable has the last known good version of VisiData (which should be on pypi).
  • develop has the most up-to-date version of VisiData (which will eventually be merged to stable).

If you wish to contribute, please fork from develop and submit a pull request against it.

A developer's guide can be found here.

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 use in other projects.

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