XLEAK(1)

📦 version 0.2.6, in ubuntu stonking

💖 XLEAK — the manual, but make it cute ✨

okay so bestie, gather round, because xleak is genuinely one of those tools that makes you go "wait, we can do that?" It's a terminal Excel viewer with a whole interactive TUI, it lives in the General Commands Manual section, and it's about to become your new main character. 💅

✨ NAME ✨

xleak — terminal Excel viewer with interactive TUI 🦋

🌸 SYNOPSIS 🌸

xleak [-i] [-H] [-s sheet] [-n rows] [-w cols] [--wrap] [--formulas]
      [--export format] [--list-tables] [-t table] [--config path] file

like. look at her. so many little flags to play with 🎀

💜 DESCRIPTION 💜

xleak is a command-line tool for viewing Excel spreadsheets directly in the terminal, no Microsoft Excel required, no cap. It supports .xlsx, .xls, .xlsm, .xlsb, and .ods files. the range?? iconic. 🔥

When you invoke it without -i, xleak prints a formatted table of the spreadsheet to standard output. Plain and simple, no drama. ✨

With -i tho? it launches a full interactive TUI — keyboard navigation, search, multi-sheet browsing, and clipboard support. it's giving "spreadsheet but make it a vibe." 👑

🎀 OPTIONS 🎀

👀 Viewing Options

  • -s, --sheet sheet — which sheet to display, by name or by 1-based index. defaults to the first sheet, obviously.
  • -n, --max-rows rows — the max number of rows to display. set it to 0 to show literally all of them. Default: 50
  • -w, --max-width cols — maximum column width in characters. Default: 30
  • --wrap — wrap long text instead of truncating it. no more mysterious ... bestie 🫶
  • -f, --formulas — show the raw formulas instead of the computed values. peek behind the curtain fr fr

🕹️ Interactive Mode

  • -i, --interactive — launch the interactive TUI mode. this is the one. the moment. 💅
  • -H, --horizontal-scroll — enable horizontal scrolling with auto-sized columns in TUI mode

📤 Export Options

  • -e, --export format — export the sheet to stdout in whatever format you name. possible values:
    • csv — Comma-separated values
    • json — JSON array of row objects
    • text — Tab-separated plain text

🗂️ Table Options

  • --list-tables — list all named Excel tables in the workbook. Output format: Sheet<tab>Table. Only supported for .xlsx files.
  • -t, --table table — extract and display a specific named Excel table. Can be combined with --export. Only supported for .xlsx files.

⚙️ General Options

  • --config path — path to a custom configuration file. Default: $XDG_CONFIG_HOME/xleak/config.toml.
  • -h, --help — print help information.
  • -V, --version — print version information.

⌨️ INTERACTIVE CONTROLS ⌨️

these keyboard shortcuts are available in TUI mode. learn them, live them, slay them. 💅

  • Up, k — Move cursor up one row
  • Down, j — Move cursor down one row
  • Left, h — Move cursor left one column
  • Right, l — Move cursor right one column
  • PageUp, Ctrl+u — Scroll up one page
  • PageDown, Ctrl+d — Scroll down one page
  • Home — Jump to start of current row
  • End — Jump to end of current row
  • Ctrl+Home, g — Jump to first row
  • Ctrl+End, G — Jump to last row
  • Tab — Switch to next sheet
  • Shift+Tab — Switch to previous sheet
  • / — Enter search mode (type query, then Enter to confirm)
  • n — Jump to next search match
  • N — Jump to previous search match
  • Esc — Clear active search
  • Backspace — Delete last character in search query

🎬 Actions

  • Enter — Show full cell content in a detail view
  • c — Copy current cell value to clipboard
  • C — Copy current row to clipboard
  • t — Toggle colour theme
  • Ctrl+g — Open cell jump dialog (enter a cell reference such as B5)
  • ? — Show keyboard shortcut help overlay
  • q — Quit

🌈 ENVIRONMENT 🌈

  • XDG_CONFIG_HOME — Base directory for user configuration files. If unset, defaults to ~/.config

🦋 FILES 🦋

  • $XDG_CONFIG_HOME/xleak/config.toml — Configuration file for theme, UI options, and custom keybindings. Created automatically on first run if absent. nah because it just appears for you, that's so thoughtful 😭

⭐ EXAMPLES ⭐

View the first sheet of a workbook:

$ xleak report.xlsx

View a specific sheet by name:

$ xleak report.xlsx --sheet Q1 Results

View a specific sheet by index:

$ xleak report.xlsx --sheet 2

Open in interactive TUI mode:

$ xleak report.xlsx -i

Show all rows without truncation:

$ xleak report.xlsx -n 0

Show raw formulas instead of values:

$ xleak report.xlsx --formulas

Export a sheet to CSV:

$ xleak report.xlsx --export csv > output.csv

Export a sheet to JSON:

$ xleak report.xlsx --export json > output.json

List all named tables in a workbook:

$ xleak report.xlsx --list-tables

Extract a named table as CSV:

$ xleak report.xlsx --table SalesData --export csv

Use a custom config file:

$ xleak report.xlsx -i --config ~/my-xleak.toml

👀 SEE ALSO 👀

doxx(1), less(1)

go read those too bestie, they're the extended universe 🫶

💖 AUTHORS 💖

xleak was written by Brandon Greenwell <greenwell.brandon@gmail.com>

This manual page was written by Nadzeya Hutsko <nadzya.info@gmail.com>

and that's the whole manual, no notes, 10/10, would read again 💅✨

so this lovely thing shipped from Debian, dated May 2, 2026, and it's page XLEAK(1) of the manual — that's the whole vibe check, periodt. 🎀💖🌈

📦 where this page comes from