🚀 BCMR (Better Copy Move Remove)

Making file operations simpler and more modern! BCMR is a command-line tool written in Rust that lets you elegantly copy, move, and remove files.

📥 Installation

Using Cargo (Recommended)

cargo install bcmr

Building from Source

git clone https://github.com/Bengerthelorf/bcmr
cd bcmr
cargo build --release

The compiled binary will be available at target/release/bcmr.

✨ Features

• 🎯 Real-time Progress Bar - No more guessing how long it'll take
• 🔄 Recursive Directory Operations - Handle entire folders with one command
• 🎨 Attribute Preservation - Keep timestamps, permissions, and more
• ⚡ Asynchronous I/O - Faster file operations
• 🛡️ Safe Confirmation System - Prevent accidental overwrites or deletions
• 🎭 File Exclusion - Flexibly ignore unwanted files
• 📊 Detailed Operation Info - Know exactly what's happening
• 🔌 Shell Integration - Customize command names with flexible prefixes
• 🎮 Two Progress Display Modes - Plain text (default) or fancy TUI display

📖 Detailed Usage Guide

Shell Integration

BCMR provides flexible shell integration similar to zoxide. You can customize command names with prefixes or replace native commands.

Basic syntax:

bcmr init [shell] [options]

Available options:

• --cmd <prefix>: Set command prefix (e.g., 'b' creates bcp, bmv, brm)
• --no-cmd: Don't create command aliases
• --uninstall: Remove previously installed commands

Examples:

# Add to your ~/.bashrc or ~/.zshrc:
# Use custom prefix (creates testcp, testmv, testrm)
eval "$(bcmr init zsh --cmd test)"

# Replace native commands (creates cp, mv, rm)
eval "$(bcmr init zsh --cmd '')"

# Use 'b' prefix (creates bcp, bmv, brm)
eval "$(bcmr init bash --cmd b)"

# Uninstall commands (remove previously added commands)
eval "$(bcmr init zsh --cmd test --uninstall)"

Supported shells:

• Bash
• Zsh
• Fish

Copy Command

Basic syntax:

bcmr copy [options] <source> <destination>

Available options:

• -r, --recursive: Copy directories recursively
• --preserve: Preserve file attributes (timestamps, permissions)
• -f, --force: Force overwrite existing files
• -y, --yes: Skip confirmation when using force
• --exclude=<pattern>: Exclude files matching pattern (comma-separated)
• --fancy-progress: Use fancy TUI progress display (default is plain text)

Examples:

# Copy a single file
bcmr copy document.txt backup/

# Recursively copy a directory
bcmr copy -r projects/ backup/

# Copy with attribute preservation
bcmr copy --preserve important.conf /etc/

# Force overwrite without prompting
bcmr copy -f -y source.txt destination.txt

# Copy with exclusions
bcmr copy -r --exclude=.git,*.tmp src/ dest/

# Copy with fancy progress display
bcmr copy -r --fancy-progress large_folder/ backup/

Move Command

Basic syntax:

bcmr move [options] <source> <destination>

Available options:

• -r, --recursive: Move directories recursively
• --preserve: Preserve file attributes
• -f, --force: Force overwrite existing files
• -y, --yes: Skip overwrite confirmation
• --exclude=<pattern>: Exclude matching files
• --fancy-progress: Use fancy TUI progress display (default is plain text)

Examples:

# Move a single file
bcmr move old_file.txt new_location/

# Recursively move a directory
bcmr move -r old_project/ new_location/

# Force move with attribute preservation
bcmr move -f --preserve config.json /etc/

# Move with exclusions
bcmr move -r --exclude=node_modules,*.log project/ new_place/

# Move with fancy progress display
bcmr move -r --fancy-progress large_folder/ new_location/

Remove Command

Basic syntax:

bcmr remove [options] <path1> [path2 ...]

Available options:

• -r, --recursive: Recursively remove directories
• -f, --force: Force removal without confirmation
• -i, --interactive: Prompt before each removal
• -v, --verbose: Show detailed removal process
• -d: Remove empty directories
• --exclude=<pattern>: Exclude matching files
• --fancy-progress: Use fancy TUI progress display (default is plain text)

Examples:

# Remove a single file
bcmr remove unnecessary.txt

# Recursively remove a directory
bcmr remove -r old_project/

# Interactive removal of multiple files
bcmr remove -i file1.txt file2.txt file3.txt

# Remove empty directory
bcmr remove -d empty_directory/

# Force recursive removal with verbose output
bcmr remove -rf -v outdated_folder/

# Remove with exclusions
bcmr remove -r --exclude=*.important,*.backup trash/

# Remove with fancy progress display
bcmr remove -r --fancy-progress large_folder/

Progress Display Modes

BCMR offers two progress display modes:

1. Plain Text Mode (Default): Simple text-based progress bars that work in any terminal
2. Fancy TUI Mode: Rich terminal UI with enhanced visual elements

Use --fancy-progress flag to enable the fancy TUI mode for a more visually appealing experience.

🤝 Contributing

Issues and PRs are welcome! Whether it's bug reports or feature suggestions, we appreciate all contributions.

1. Fork the project
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

🐛 Bug Reports

If you find a bug or have any suggestions, please submit them to the GitHub Issues page. When reporting, please include:

• BCMR version used
• Operating system details
• Steps to reproduce the issue
• Expected behavior
• Actual behavior

📝 License

GPL-3.0 © Zane Leong