Skip to content

cuentaprueba244w-dotcom/fileflow

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 

Repository files navigation

FileFlow

Professional file organization toolkit for your terminal.

FileFlow helps you organize, rename, and clean up files with a beautiful CLI interface. No more messy downloads folders or scattered documents.

Features

  • Organize - Auto-sort files into folders by type (images, documents, code, audio, video, archives, and more)
  • Rename - Bulk rename files with patterns (sequential numbers, dates, custom templates)
  • Find Duplicates - Scan for duplicate files by content hash
  • Analyze - Visualize disk space usage
  • Dry Run - Preview all actions before making changes
  • Undo-safe - Every operation supports dry-run mode

Installation

pip install fileflow

Quick Start

# Organize your downloads folder
fileflow organize ~/Downloads --dry-run

# Actually organize when ready
fileflow organize ~/Downloads

# See what categories are recognized
fileflow categories

# Rename all images sequentially
fileflow rename "photo_{nn}" ~/Pictures --ext .jpg

# Find duplicate files
fileflow duplicates ~/Documents

# Analyze disk usage
fileflow analyze ~ --top 30

Rename Pattern Tokens

Token Description Example
{n} Sequential number 1, 2, 3
{nn} Zero-padded number 01, 02, 03
{nnn} 3-digit number 001, 002
{date} Current date 20250614
{stem} Original filename report
{ext} File extension .txt

Buying the Standalone EXE

$3 USD in crypto (USDC/ETH on Base):

Wallet: 0xb138DF4f5f0165636b587a7703286565Cf8073de

The standalone EXE (fileflow.exe, ~32 MB, zero dependencies) includes:

  • Full file organization toolkit
  • Rich terminal UI with colors and animations
  • No Python or pip required

Ask via GitHub Issues and I'll share the EXE download link upon payment.

License

MIT

About

Smart CLI file organization toolkit — organize, rename, find duplicates, analyze storage

Resources

Stars

0 stars

Watchers

0 watching

Forks

Packages

 
 
 

Contributors

Languages