ffm 0.1.0

A blazing-fast terminal file manager with three-panel layout, fuzzy search, multi-select, and full keyboard control
ffm-0.1.0 is not a library.

⚡ FastyFileManager

A blazing-fast terminal file manager built with Rust & Ratatui

Rust License: MIT Platform

✨ Features

  • 🗂️ Three-panel layout — Favorites, Drives, Files, and Preview
  • 📋 Clipboard — Copy, Cut and Paste files & folders (recursive)
  • ★ Favorites — Pin any file or folder for instant access (persisted between sessions)
  • 🔍 Fuzzy Search — Instantly filter files as you type (characters in order, not necessarily contiguous)
  • 🎨 Nerd Font icons — Per-extension color coding and icons (60+ file types)
  • ⚙️ Configurable — Full keybinding and theme customization via config.toml
  • 🖊️ Editor integration — Open files in your $EDITOR (nvim, vim, nano…)
  • 💾 Hot config reload — Apply changes without restarting (F5)
  • 📐 Sort modes — Toggle between Name / Size / Date with s
  • 🔲 Multi-select — Select multiple files with Space, batch operations
  • ✏️ Rename — Rename files and folders with r
  • 🗑️ Delete confirmation — Safe deletion with y/N prompt
  • 📏 Resizable panels — Adjust panel widths with Shift+← / Shift+→
  • 📂 Drive info — Shows available free space for each drive
  • ⚡ Compact popups — Minimal Vim-style command bar for input and confirmations
  • 🔄 Conflict resolution — Overwrite / Skip / Auto-rename when pasting existing files

🚀 Installation

Prerequisites

  • Rust (stable, 1.75+)
  • A terminal with Nerd Fonts support (e.g. JetBrainsMono Nerd Font)

🐧 Linux / macOS

git clone https://github.com/SMOLDEVI/FastyFileManager.git
cd FastyFileManager
chmod +x build.sh
./build.sh

The script will:

  1. Compile the project in release mode
  2. Place the ffm binary in the project directory
  3. You can then move it to ~/.local/bin/ or /usr/local/bin/ to add it to PATH
# Optional: add to PATH manually
cp ffm ~/.local/bin/ffm

🪟 Windows

git clone https://github.com/SMOLDEVI/FastyFileManager.git
cd FastyFileManager
build.bat

The script will:

  1. Compile the project in release mode
  2. Copy ffm.exe to %USERPROFILE%\bin\
  3. Automatically add %USERPROFILE%\bin to your user PATH

⚠️ Restart your terminal after first install for PATH changes to take effect.

📦 Manual build

git clone https://github.com/SMOLDEVI/FastyFileManager.git
cd FastyFileManager
cargo build --release
# Binary is at: target/release/ffm  (or ffm.exe on Windows)

⌨️ Keybindings

🗂️ File Panel

Key Action
j / ↓ Move down
k / ↑ Move up
l / → / Enter Open directory
h / ← / Backspace Go to parent directory
a Create new file or folder (end name with / for folder)
r Rename selected item
D Delete selected file/folder (with confirmation)
Space Toggle multi-selection
s Cycle sort mode: Name → Size → Date
e Open file in $EDITOR
y Copy selected item(s) to clipboard
x Cut selected item(s) (move)
p Paste clipboard into current directory
f Add selected item to Favorites
/ Start search / filter
Tab Switch focus: Files → Drives → Favorites
Shift+← Shrink center panel
Shift+→ Expand center panel

★ Favorites Panel

Key Action
j / ↓ Move down
k / ↑ Move up
Enter / → Navigate to favorited item
D or F Remove from favorites
Tab Switch focus

💾 Drive Panel

Key Action
j / ↓ Move down
k / ↑ Move up
Enter / → Switch to selected drive
Tab Switch focus

🔍 Search Mode

Key Action
type anything Filter files in real time
Enter Confirm and return to Normal mode
Esc Cancel search and clear filter
↑ / ↓ Navigate filtered results

🌐 Global

Key Action
q Quit
? Toggle help popup
F5 Hot-reload config
Ctrl-h Focus Drives panel
Ctrl-l Focus Files panel
Ctrl-b Toggle status bar
Tab Cycle focus: Files → Drives → Favorites

📦 Paste Conflict

Key Action
O Overwrite existing file
S Skip this file
R Auto-rename (adds suffix)
Esc Cancel entire paste operation

⚙️ Configuration

Config is stored at:

  • Windows: %APPDATA%\ffm\config.toml
  • Linux/macOS: ~/.config/ffm/config.toml

The file is auto-created on first run with default values.

[theme]
background     = "Reset"
text           = "#EADBB8"
selected_bg    = "#D2B48C"
selected_fg    = "#282828"
directory      = "#E0C097"
file           = "#C8B6A6"
highlight_symbol = "> "

[keys]
quit         = "q"
search       = "/"
cancel       = "esc"
submit       = "l"
down         = "j"
up           = "k"
delete       = "D"
create       = "a"
focus_files  = "ctrl-l"
focus_drives = "ctrl-h"
back_dir     = "h"
reload       = "F5"
edit         = "e"
rename       = "r"
help         = "?"
sort         = "s"

Apply changes instantly with F5 — no restart needed!

🏗️ Project Structure

FastyFileManager/
├── src/
│   ├── main.rs      # Entry point
│   ├── app.rs       # Application state & input handling
│   ├── ui.rs        # Terminal UI rendering (ratatui)
│   ├── config.rs    # Config loading & defaults
│   ├── icons.rs     # File type icons & colors
│   └── theme.rs     # Color parsing
├── build.sh         # Linux/macOS build + install script
├── build.bat        # Windows build + PATH setup script
└── Cargo.toml       # Dependencies

📄 License

MIT © SMOLDEVI