gravityfile-tui

Interactive terminal user interface for gravityfile, built with ratatui.

This crate provides a feature-rich TUI for exploring disk usage, finding duplicates, and analyzing file ages.

Features

• Interactive Explorer - Navigate directory trees with vim-style keybindings
• Miller Columns Layout - Ranger-style three-pane view (Parent | Current | Preview)
• Multiple Views - Explorer, Duplicates, Age, and Errors views
• Drill-Down Navigation - Explore subdirectories without rescanning
• File Operations - Copy, move, rename, create, delete with vim-style keybindings
• Clipboard Support - Yank/cut/paste with conflict resolution
• Undo Support - Undo file operations with Ctrl-z
• Command Palette - Vim-style : commands for power users
• Theming - Dark and light theme support
• Details Panel - Toggle detailed file information
• Async Operations - Non-blocking scanning and file operations

Usage

As a Library

use gravityfile_tui;
use std::path::PathBuf;

// Run the TUI on a directory
gravityfile_tui::run(PathBuf::from("/path/to/explore"))?;

Programmatic Access

use gravityfile_tui::{App, Theme};

// Create app instance
let app = App::new(PathBuf::from("/path/to/explore"));

// Run with terminal
let terminal = ratatui::init();
let result = app.run(terminal);
ratatui::restore();

Keyboard Navigation

Movement

Navigation

Selection & Clipboard

File Operations

Views & Display

Command Palette

Press : to open the command palette:

Views

Explorer View

The default view showing a tree of directories and files sorted by size. The size bar shows relative size compared to the largest item.

Toggle between two layout modes with v:

• Tree Layout (default) - Hierarchical tree with expand/collapse
• Miller Layout - Three-column ranger-style view (Parent | Current | Preview)

Duplicates View

Shows groups of duplicate files found via content hashing. Files are grouped by their BLAKE3 hash and sorted by wasted space.

Age View

Shows file age distribution in buckets (Today, This Week, This Month, etc.) and identifies stale directories that haven't been modified recently.

Errors View

Displays warnings and errors encountered during scanning, such as permission denied or broken symlinks.

Architecture

The TUI is organized into focused modules:

• app/ - Application state and logic
  • mod.rs - Core App struct and event loop
  • state.rs - State types (AppMode, View, LayoutMode, ClipboardState, etc.)
  • commands.rs - Command palette parsing
  • navigation.rs - List navigation abstractions
  • input.rs - Text input handling for rename/create modes
  • render.rs - All rendering code
  • scanning.rs - Background scan operations
  • deletion.rs - File deletion logic
• ui/ - Widget implementations
  • tree.rs - Tree widget for directory display
  • miller.rs - Miller columns (three-pane ranger-style) view
  • help.rs - Help overlay
  • modals.rs - Modal dialogs (confirmation, conflict resolution, etc.)
  • size_bar.rs - Size visualization bars
• theme.rs - Color schemes
• event.rs - Terminal event handling and key bindings

License

Licensed under either of Apache License, Version 2.0 or MIT license at your option.