Installation and First Run
VisiData is a Python package available via pip (recommended) or system package managers. The pip version is always the most current.
Learning Focus
Install VisiData, open a file, and confirm the interface loads correctly before moving on. Do not spend time exploring — that comes in later lessons.
Installation Methods
Method 1: pip (Recommended)
# Requires Python 3.8+
pip install visidata
# Verify installation
vd --version
# Expected: VisiData v3.x
Method 2: System Package Manager
# Debian / Ubuntu
sudo apt install visidata
# Fedora / RHEL
sudo dnf install visidata
# macOS (Homebrew)
brew install saulpw/vd/visidata
# Arch Linux
sudo pacman -S visidata
warning
The apt version may be significantly older than the pip version. For the latest features and format support, use pip install visidata.
Method 3: pipx (Isolated Install)
# Install pipx first if needed
sudo apt install pipx
# Install VisiData in an isolated environment
pipx install visidata
# Verify
vd --version
Optional Dependencies
VisiData's core is dependency-free, but additional formats require extra packages:
# Excel (.xlsx) support
pip install openpyxl
# Parquet support
pip install pyarrow
# PostgreSQL support
pip install psycopg2-binary
# HDF5 support
pip install h5py
# All extras at once
pip install "visidata[full]"
First Run: Open a File
# Create a test CSV
cat > /tmp/servers.csv << 'EOF'
hostname,ip,role,status
web01,192.168.1.10,webserver,active
web02,192.168.1.11,webserver,active
db01,192.168.1.20,database,active
cache01,192.168.1.30,cache,standby
EOF
# Open with VisiData
vd /tmp/servers.csv
Expected output on screen:
┌──────────────┬─────────────────┬───────────┬─────────┐
│ hostname │ ip │ role │ status │
│──────────────┼─────────────────┼───────────┼─────────│
│ web01 │ 192.168.1.10 │ webserv… │ active │
│ web02 │ 192.168.1.11 │ webserv… │ active │
│ db01 │ 192.168.1.20 │ database │ active │
│ cache01 │ 192.168.1.30 │ cache │ standb │
└──────────────────────────────────────────────────────┘
servers.csv 4 rows hostname
Essential First Keystrokes
Once inside VisiData, try these immediately:
| Key | Action |
|---|---|
Arrow keys / hjkl | Move cursor |
q | Quit current sheet |
gq | Quit VisiData entirely |
Ctrl+H | Open full man page |
Alt+H | Open help menu |
Ctrl+G | Show cursor position and sheet bounds |
Common Installation Issues
| Problem | Cause | Fix |
|---|---|---|
vd: command not found | pip installed to user path not in PATH | Add ~/.local/bin to PATH |
ModuleNotFoundError: curses | Windows environment | VisiData requires Unix/Linux/macOS terminal |
| Garbled display | Non-UTF-8 terminal | Set export LANG=en_US.UTF-8 |
| Colors missing | TERM not set correctly | Set export TERM=xterm-256color |
Fix PATH for pip user install
# Add to ~/.bashrc or ~/.zshrc
export PATH="$HOME/.local/bin:$PATH"
# Reload
source ~/.bashrc
Verify Supported Formats
# Open the format list inside VisiData
vd -f txt /dev/null
# Or check via man page
man vd
Hands-On Practice
# Open a log file directly
vd /var/log/syslog
# Open a directory (Directory Sheet)
vd /var/log/nginx/
# Open multiple files at once
vd /tmp/servers.csv /var/log/auth.log
# Use Shift+S to switch between them