ffm-0.1.6 is not a library.

⚡ FastyFileManager

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

✨ 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:

Compile the project in release mode
Place the ffm binary in the project directory
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:

Compile the project in release mode
Copy ffm.exe to %USERPROFILE%\bin\
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!

🔁 Shell Integration: cd on quit

When you quit ffm, it saves the last visited directory to ~/.local/share/ffm/cwd (Linux) or %APPDATA%\ffm\data\cwd (Windows). Wrap the binary in a shell function to automatically cd into that directory:

Bash / Zsh

ffm() {
    command ffm "$@"
    cwd_file="${XDG_DATA_HOME:-$HOME/.local/share}/ffm/cwd"
    if [ -f "$cwd_file" ]; then
        cd "$(cat "$cwd_file")"
    fi
}

fish

function ffm
    command ffm $argv
    set cwd_file "$HOME/.local/share/ffm/cwd"
    if test -f "$cwd_file"
        cd (cat "$cwd_file")
    end
end

Windows PowerShell (profile)

function ffm { & ffm.exe $args; $cwd = "$env:APPDATA\ffm\data\cwd"; if (Test-Path $cwd) { Set-Location (Get-Content $cwd -Raw).Trim() } }

🏗️ 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

ffm 0.1.6