filebyte-0.2.1 is not a library.

filebyte

A powerful, colorful CLI tool to list files and directories with intelligent size formatting, advanced filtering, and comprehensive file analysis. Built with Rust for speed and reliability.

Features

Fast & Efficient: Written in Rust with optimized file system operations
Smart Size Display: Automatically chooses appropriate units (B, KB, MB, GB, TB)
Advanced Filtering: Regex-based search and exclusion patterns
File Statistics: Type detection, size analysis, and detailed metadata
Disk Analysis: View disk usage and manage storage across mount points
Export Support: Export results to JSON or CSV formats
Duplicate Detection: Find and analyze duplicate files
Comprehensive Properties: Creation/modification dates, permissions, and more

Installation

Cargo (Recommended)

cargo install filebyte

Automated Installation

Clone the repository:

git clone https://github.com/execRooted/filebyte.git
cd filebyte

Run the installer:

sudo ./install.sh

The installer will automatically:

Install Rust if not present
Build filebyte with optimizations
Install it system-wide to /usr/local/bin/filebyte

Arch Linux (AUR)

yay -S filebyte
# Or any other AUR helper

Manual Build

git clone https://github.com/execRooted/filebyte.git
cd filebyte
cargo build --release
# Binary will be available at target/release/filebyte

Uninstallation

cd filebyte

sudo ./uninstall.sh

Arch Linux

yay -R filebyte
# Or any AUR helper

Usage

Basic Usage

# List files in current directory
filebyte

# List files in specific directory
filebyte /home/user/Documents

# Show directory tree
filebyte --tree

Size Formatting

# Show permissions and modification dates (default)
filebyte

# Show file sizes in auto-detected units
filebyte -s

# Show file sizes in specific units
filebyte -s mb          # Megabytes
filebyte -s gb          # Gigabytes
filebyte -s b           # Bytes

Advanced Filtering

# Search for specific files
filebyte --search "\.rs$"           # Find Rust files
filebyte --search "config"          # Find files containing "config"

# Exclude files
filebyte --excluding "^\."          # Hide hidden files
filebyte --excluding "temp"         # Exclude temp files

# Combine search and exclusion
filebyte --search "\.txt$" --excluding "old"

File Analysis

# Show comprehensive analysis for current directory
filebyte -p

# Show detailed properties for specific file
filebyte -p README.md

# Find duplicate files
filebyte --duplicates

Disk Operations

# List all disks
filebyte --disk list

# Analyze specific disk
filebyte --disk /dev/sda1

# Disk info with custom size units
filebyte --disk list --size gb

Sorting & Export

# Sort by different criteria
filebyte --sort-by size     # Largest files first
filebyte --sort-by date     # Newest files first
filebyte --sort-by name     # Alphabetical

# Export results
filebyte --export results.json
filebyte --export analysis.csv

Command Line Options

Option	Short	Description
`--version`	`-v`	Show version information
`--help`	`-h`	Show help information
`--size <UNIT>`	`-s`	Show file sizes with specified unit (auto, b/bytes, kb/kilobytes, mb/megabytes, gb/gigabytes, tb/terabytes)
`--tree`	`-t`	Show directory tree
`--properties`	`-p`	Show comprehensive file/directory analysis
`--no-color`		Disable colored output
`--disk <DISK>`	`-m`	Disk operations ('list' or specific disk name)
`--search <PATTERN>`	`-e`	Search files using regex pattern
`--excluding <PATTERN>`	`-x`	Exclude files matching regex pattern
`--sort-by <CRITERIA>`		Sort by: name, size, date
`--duplicates`		Find duplicate files
`--export <FILE>`		Export results to JSON/CSV

Examples

Everyday Usage

# Quick directory overview (shows permissions & dates)
filebyte

# Find large files with sizes
filebyte -s --sort-by size

# Analyze disk usage
filebyte --disk list -s gb

# Find all PDFs
filebyte --search "\.pdf$"

Advanced Analysis

# Comprehensive file analysis
filebyte -p --export analysis.json

# Find and sort duplicates by size
filebyte --duplicates -s --sort-by size

# Exclude system files and sort by date
filebyte --excluding "^\." --sort-by date

Power User Tips

# Monitor large directories
filebyte /var/log -s mb --sort-by size

# Find recently modified config files
filebyte --search "config" --sort-by date -p

# Disk space analysis
filebyte --disk list -s gb | head -10

Output Features

Directories first: Always listed before files for better navigation
Colored output: Intuitive color coding (directories=blue, files=green, sizes=cyan)
Smart sizing: Automatically chooses appropriate units
File type detection: MIME type identification
Timestamps: Creation and modification dates
Permissions: Read/write access indicators

License

This project is licensed under the MIT License - see the LICENSE file for details.

Made by execRooted

filebyte 0.2.1