vex-tui

README

Vex - Excel Viewer

A TUI Excel and CSV viewer in Go

Installation

Using go install (quickest)

go install github.com/odesaur/vex-tui@latest

From source

# Clone the repository
git clone https://github.com/odesaur/vex-tui.git
cd vex-tui

# Install dependencies
go mod download

# Build locally
go build -o vex-tui .

One-command install via Make

git clone https://github.com/odesaur/vex-tui.git
cd vex-tui
make install

Usage

# Basic usage (opens file directly)
vex-tui data.xlsx

# Start with a picker in the current directory
vex-tui

# With a specific theme
vex-tui report.csv --theme nord

# Short flag
vex-tui sales.xlsx -t tokyo-night

Keyboard Shortcuts

Press ? in the app anytime to open the built-in help with the full list. Quick reference:

Keys	Action
↑/↓/←/→ or hjkl	Move cursor
PageUp/PageDown	Page scroll
Tab / Shift+Tab	Next / previous sheet
/, n, N	Search, next result, previous
Ctrl+G	Jump to cell
Enter	Cell details
c / C	Copy cell / row
f	Toggle formulas
e	Export sheet
t	Theme selector
q or Ctrl+C	Quit

Acknowledgments

• Built with the amazing Charm ecosystem
  • Bubble Tea - TUI framework
  • Lipgloss - Terminal styling
  • Bubbles - TUI components
• Excel parsing by Excelize
• Clipboard support by clipboard
• Themes inspired by Catppuccin, Nord, Rosé Pine, Tokyo Night, Gruvbox, and Dracula