panex-tui 0.2.1

Terminal UI for PanEx file explorer
panex-tui-0.2.1 is not a library.

panex-tui

A terminal UI file explorer with multi-pane support, built with ratatui. Part of the PanEx project.

Website

Install

cargo install panex-tui

Usage

# Open in current directory
panex

# Open in a specific directory
cd ~/Projects && panex

Features

  • Multi-pane layout — split vertically (|) or horizontally (-), close with W
  • Keyboard-driven navigation with vim-style keys (j/k) or arrow keys
  • File operations: copy (y), cut (x), paste (p), rename (r/F2), delete (d)
  • Delete confirmation dialog with arrow key selection
  • Search with / or Ctrl+f
  • Sortable columns — cycle field with s, toggle direction with S
  • Show/hide hidden files (.)
  • Editable path bar (e) with ~ expansion, Tab completion, and segment-wise backspace
  • Favorite locations — press f to bookmark, e to see favorites list
  • Custom default applications per extension via ~/.panex/config.toml
  • Open files in default app (o) or open directory in terminal (t)
  • Create new files (n) and folders (N)
  • Multi-select with Shift+j/Shift+k, select all with Ctrl+a
  • Auto-clearing status messages

Keyboard Shortcuts

Key Action
j / k or Up / Down Move focus
Enter Open file / enter folder
Backspace Go up one directory
~ Go to home directory
Tab Switch pane
| Split pane vertically
- Split pane horizontally
W Close pane
y Copy
x Cut
p or Ctrl+v Paste
r / F2 Rename
d / Delete Delete (move to trash)
n New file
N New folder
o Open in default app
t Open in terminal
/ or Ctrl+f Search
s Cycle sort field
S Toggle sort direction
. Toggle hidden files
e Edit path / show favorites (Tab to autocomplete, Backspace removes path segment)
f Toggle current directory as favorite
Ctrl+a Select all
Esc Deselect / cancel
q Quit

Configuration

PanEx stores its config at ~/.panex/config.toml. Favorites are managed via keyboard (f to toggle, e to browse). You can also set custom applications for opening files by extension:

[open.tui]
".md" = "nvim"
".pdf" = "less"
".rs" = "nvim"

Extensions not listed fall back to the OS default (open on macOS, xdg-open on Linux).

License

MIT