Skip to content
/ ffscan Public

Fast Rust CLI for directory scanning, process monitoring & system info. Scan folders in parallel with filters & multiple output formats, list processes sorted by memory, kill by PID, and view detailed system specs. Built with rayon, sysinfo, walkdir, clap. πŸ¦€πŸš€

License

Notifications You must be signed in to change notification settings

swap72/ffscan

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

4 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Scan a directory and print a summary, skipping files smaller than 1024 Megabytes

ffscan scan c:\users summary skip1024

Exclude empty folders from the scan

ffscan scan /home/user/ summary --exclude-empty

Display about information and credits

ffscan about

Show help with available flags and options

ffscan --help

βš™οΈ Features

  • πŸš€ Fast parallel scanning (Rayon)
  • πŸ“ Minimum-size filter to skip small files
  • πŸ“‚ Option to exclude empty folders
  • πŸ“Š Output formats: csv, json, plain text summary
  • πŸ–₯ Processes listed by memory usage (highest first)
  • πŸ’€ Kill processes by PID (--force supported)
  • 🧰 Cross-platform (Windows, Linux, macOS)

Download and Install :

run cargo install ffscan on your termial / cmd / or your fav shell
register it on the path of you system and start using it

ffscan

Crates.io Downloads

βš™οΈ Output Formats

  • csv: Save results to output.csv
  • json: Save results to output.json
  • summary: Print a human-readable summary to the console

πŸ“‚ Example output

2.50 GB [Directory] - C:\Users\Tushar\Documents\Projects
1.20 GB [File] - C:\Users\Tushar\Videos\movie.mp4


πŸ“ Project Structure

fscan/
β”œβ”€β”€ Cargo.toml           # Project metadata & dependencies
β”œβ”€β”€ Cargo.lock           # Locked dependency versions (auto-generated)
β”œβ”€β”€ LICENSE              # LICENSE.txt
β”œβ”€β”€ README.md            # πŸ“„ Project documentation (GitHub flavored)
β”œβ”€β”€ .gitignore           # Ignore build artifacts & output files
β”œβ”€β”€ output.csv           # Example output file (should be gitignored)
β”œβ”€β”€ output.json          # Example output file (should be gitignored)
β”œβ”€β”€ src/
β”‚   β”œβ”€β”€ main.rs          # Main entry point: parses CLI & calls logic
β”‚   β”œβ”€β”€ cli.rs           # (Optional) CLI parsing module if you split
β”‚   β”œβ”€β”€ scanner.rs       # (Optional) Scanning logic module
β”‚   └── utils.rs         # (Optional) Utility functions (e.g., format_size)
└── .github/
    └── workflows/
        └── rust.yml     # (Optional) CI workflow for testing/building

πŸ“ License

This project is licensed under the MIT License.
See LICENSE for details.


πŸ™Œ Contributing

Contributions are welcome! Please feel free to submit issues or pull requests.


πŸ’– Show your support

🌱 Feel free to modify and distribute this CLI tool
⭐️ Star or fork this repo on GitHub if you find it useful!
πŸ”— Formal Portfolio
πŸ”— Not so formal Portfolio
πŸš€ Built with ❀️ and Rust πŸ¦€βš™οΈ

About

Fast Rust CLI for directory scanning, process monitoring & system info. Scan folders in parallel with filters & multiple output formats, list processes sorted by memory, kill by PID, and view detailed system specs. Built with rayon, sysinfo, walkdir, clap. πŸ¦€πŸš€

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages