Skip to main content
Help us improve PyPI by participating in user testing. All experience levels needed!

curses interface for exploring and arranging tabular data

Project description

# VisiData v1.2 [![CircleCI](https://circleci.com/gh/saulpw/visidata/tree/stable.svg?style=svg)](https://circleci.com/gh/saulpw/visidata/tree/stable)

A terminal interface for exploring and arranging tabular data.

## Dependencies

### Install via pip3

Best installation method for users who wish to take advantage of VisiData in their own code, or integrate it into a Python3 virtual environment.

To install VisiData, with loaders for the most common data file formats (including csv, tsv, fixed-width text, json, sqlite, http, html and xls):

$ pip3 install visidata

### Install via conda

To install from [conda-forge](https://github.com/conda-forge/visidata-feedstock):

Add the conda-forge channel.

$ conda config –add channels conda-forge

You can then install VisiData by typing:

$ conda install visidata

And update VisiData with:

$ conda update visidata

### Install via brew

Ideal for MacOS users who primarily want to engage with VisiData as an application. This is currently the most reliable way to install VisiData’s manpage on MacOS.

$ brew install saulpw/vd/visidata

Further instructions available [here](https://github.com/saulpw/homebrew-vd).

### Install via apt

Packaged for Linux users who do not wish to wrangle with PyPi or python3-pip.

Currently, VisiData v1.0 is in Debian unstable’s [main repository](https://launchpad.net/ubuntu/+source/visidata). If you want the most up-to-date version of VisiData (v1.1), it will be available in our own [Debian repo](https://github.com/saulpw/deb-vd).

To install from Debian:

Obtain the public key

$ sudo apt-key adv –keyserver keyserver.ubuntu.com –recv-keys 8B48AD6246925553

Ensure the repository is in apt’s search list

$ sudo apt install apt-transport-https $ sudo vim /etc/apt/sources.list

deb http://ftp.debian.org/debian/ unstable main

$ sudo apt update

You can then install VisiData by typing:

sudo apt install visidata

Instructions for installing from our own personal repository are available [here](https://github.com/saulpw/deb-vd).

## Usage

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

VisiData supports tsv, csv, xlsx, hdf5, sqlite, json and more. Use -f <filetype> to force a particular filetype. (See the [list of supported sources](http://visidata.org/man#sources)).

## Documentation

  • Quick reference: F1 (or z?) within vd will open the [man page](http://visidata.org/man), which has a list of all commands and options.
  • [visidata.org/docs](http://visidata.org/docs) has a complete list of links to all official documentation.

## Help and Support

For additional information, see the [support page](http://visidata.org/support).

## vdtui

The core vdtui.py can be used to quickly create efficient terminal workflows. These have been prototyped as proof of this concept:

Other workflows should also be created as separate apps using vdtui. These apps can be very small and provide a lot of functionality; for example, see the included [viewtsv](bin/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 use and distribution under GPLv3.

## Credits

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

Thanks to all the contributors, and to those wonderful users who provide feedback, for making VisiData the awesome tool that it is.

Project details


Release history Release notifications

This version
History Node

1.2

History Node

1.1

History Node

1.0

History Node

0.99

History Node

0.98.1

History Node

0.98

History Node

0.97.1

History Node

0.97

History Node

0.96

History Node

0.95.2

History Node

0.94

History Node

0.93

History Node

0.92

History Node

0.91

History Node

0.90

History Node

0.80

History Node

0.61

History Node

0.60

History Node

0.59

History Node

0.41.1

History Node

0.41

History Node

0.37

History Node

0.9

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Filename, size & hash SHA256 hash help File type Python version Upload date
visidata-1.2.tar.gz (89.7 kB) Copy SHA256 hash SHA256 Source None May 3, 2018

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging CloudAMQP CloudAMQP RabbitMQ AWS AWS Cloud computing Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page