The TUI provides a full-screen terminal interface for directory browsing, similar to 'nnn' or 'ranger'.
Navigation: ← Back to README | Web Interface Guide | Test Plan
# Direct launch
python3 Easy-File-Cleanup.py --tui
# Start from specific directory
python3 Easy-File-Cleanup.py --tui ~/Downloads| Key | Action |
|---|---|
↑ ↓ |
Navigate up/down through directories |
Enter |
Enter selected directory |
s |
Select current directory for cleanup |
← or b |
Go up one directory level |
1-9 |
Jump directly to parent levels (1=parent, 2=grandparent, etc.) |
t |
Type path manually |
h |
Jump to home directory |
q or ESC |
Cancel and exit |
On Windows, the TUI automatically falls back to a simple numbered menu interface that provides the same functionality with a different presentation.
- Full-Screen Terminal Interface: Beautiful ncurses-based UI (macOS/Linux)
- Keyboard Navigation: Fast, keyboard-driven directory browsing
- Breadcrumb Navigation: Quick jump to parent directories with number keys (1-9)
- Smart Path Input: Type paths manually while browsing
- Quick Navigation: Jump to home directory instantly
The TUI displays breadcrumb shortcuts at the top showing which number key (1-9) corresponds to which parent directory level. This allows instant navigation to any ancestor directory without multiple "up" commands.
- Launch TUI with
--tuiflag - Navigate directories with arrow keys
- Press
sto select a directory for cleanup - The script proceeds with file organization automatically
Use TUI when:
- Working in terminal
- Prefer keyboard navigation
- No browser needed
- Minimal dependencies
Use Web Interface when:
- Want visual graphs
- Prefer mouse navigation
- Need to view logs in browser
- Want to see directory tree visualization
Related Documentation:
- README - Main documentation and quick start
- Web Interface Guide - Web-based alternative
- Automation Guide - For scripted usage
- CHANGELOG - Version history