📦 Smart Backup Tool

Never lose your precious data again! 🛡️

An intelligent backup tool that makes data protection effortless with incremental backups, smart compression, and beautiful reporting.

✨ Features

• 🔄 Incremental Backups - Only backup what's changed, save time and space
• 🗜️ Smart Compression - Different algorithms optimized for different file types
• 📊 Beautiful Reports - Visual progress bars and detailed backup statistics
• ⏰ Scheduling Support - Daily, weekly, or custom backup schedules
• 🔐 Encryption Options - Secure your sensitive data with AES encryption
• 🎯 Conflict Resolution - Smart handling of file conflicts during restore
• 🌐 Cross-Platform - Works seamlessly on Linux, macOS, and Windows
• 🎨 Rich CLI - Colored output with formatted tables and progress indicators
• 🐍 Virtual Environment - Clean, isolated installation
• ⚡ Easy Alias - Simple smart-backup command after installation

🚀 Quick Start

Installation

# Clone the repository
git clone https://github.com/LinuxCTRL/smart-backup.git
cd smart-backup

# Install with virtual environment (recommended)
chmod +x install_venv.sh
./install_venv.sh

# Restart terminal or reload shell
source ~/.bashrc

Basic Usage

# Create your first backup
smart-backup create /home/user/projects --destination /backup/projects

# Create compressed backup with encryption
smart-backup create /home/user/documents --destination /backup/docs --compress --encrypt

# List all backups
smart-backup list --show-sizes

# Restore from backup
smart-backup restore /backup/projects/2024-01-15_14-30-25 --target /home/user/projects_restored

# Show backup status and statistics
smart-backup status --chart

📋 Commands

Core Commands

Command	Description	Example
create	Create a new backup	smart-backup create /source --destination /backup
restore	Restore from backup	smart-backup restore /backup/snapshot --target /restore/path
list	List all backups	smart-backup list --show-sizes
status	Show backup status	smart-backup status --detailed

Advanced Commands

Command	Description	Example
schedule	Set up automatic backups	smart-backup schedule --daily --time 02:00
verify	Verify backup integrity	smart-backup verify /backup/snapshot
cleanup	Remove old backups	smart-backup cleanup --keep-last 10
diff	Compare backup with source	smart-backup diff /backup/snapshot /source

🛠️ Advanced Usage

Creating Backups

# Basic backup
smart-backup create /home/user/projects --destination /backup

# Compressed backup (saves 60-80% space)
smart-backup create /home/user/projects --destination /backup --compress

# Encrypted backup for sensitive data
smart-backup create /home/user/documents --destination /backup --encrypt --password

# Incremental backup (only changed files)
smart-backup create /home/user/projects --destination /backup --incremental

# Exclude specific files/folders
smart-backup create /home/user/projects --destination /backup --exclude "*.tmp,node_modules,__pycache__"

# Custom compression level
smart-backup create /home/user/projects --destination /backup --compress --level 9

# Backup with custom name
smart-backup create /home/user/projects --destination /backup --name "project_release_v1.0"

Restoring Backups

# Restore to original location
smart-backup restore /backup/projects/2024-01-15_14-30-25

# Restore to different location
smart-backup restore /backup/projects/2024-01-15_14-30-25 --target /home/user/restored_projects

# Restore with conflict resolution
smart-backup restore /backup/snapshot --target /restore/path --on-conflict ask
smart-backup restore /backup/snapshot --target /restore/path --on-conflict overwrite
smart-backup restore /backup/snapshot --target /restore/path --on-conflict skip

# Restore specific files only
smart-backup restore /backup/snapshot --target /restore/path --files "*.py,*.md"

# Dry run (preview what will be restored)
smart-backup restore /backup/snapshot --target /restore/path --dry-run

Scheduling & Automation

# Schedule daily backups at 2 AM
smart-backup schedule /home/user/projects --destination /backup --daily --time 02:00

# Schedule weekly backups on Sundays
smart-backup schedule /home/user/projects --destination /backup --weekly --day sunday --time 03:00

# Custom schedule using cron syntax
smart-backup schedule /home/user/projects --destination /backup --cron "0 2 * * 1-5"

# List scheduled backups
smart-backup schedule --list

# Remove scheduled backup
smart-backup schedule --remove backup_job_1

📊 Sample Output

Creating a Backup

📦 Smart Backup Tool v1.0.0

🔍 Analyzing source directory: /home/user/projects
📁 Found 1,247 files (2.3 GB)
🗜️ Compression: Enabled (Level 6)
🔐 Encryption: Disabled

┌─────────────────────┬─────────────────┐
│ Metric              │ Value           │
├─────────────────────┼─────────────────┤
│ Total Files         │ 1,247           │
│ Total Size          │ 2.3 GB          │
│ Estimated Backup    │ 890 MB          │
│ Compression Ratio   │ 61%             │
└─────────────────────┴─────────────────┘

🚀 Starting backup...
████████████████████████████████████████ 100% | 1247/1247 files | 2.3GB → 890MB

✅ Backup completed successfully!

┌─────────────────────┬─────────────────────────────────┐
│ Backup Details      │ Value                           │
├─────────────────────┼─────────────────────────────────┤
│ Backup ID           │ projects_2024-01-15_14-30-25   │
│ Location            │ /backup/projects_2024-01-15... │
│ Original Size       │ 2.3 GB                          │
│ Backup Size         │ 890 MB                          │
│ Compression         │ 61% reduction                   │
│ Duration            │ 2m 34s                          │
│ Files Processed     │ 1,247                           │
│ Files Skipped       │ 0                               │
└─────────────────────┴─────────────────────────────────┘

💡 Tip: Use 'smart-backup list' to see all your backups

Listing Backups

📦 Available Backups

┌─────────────────────────────┬─────────────┬─────────────┬─────────────┬─────────────┐
│ Backup Name                 │ Date        │ Size        │ Files       │ Type        │
├─────────────────────────────┼─────────────┼─────────────┼─────────────┼─────────────┤
│ projects_2024-01-15_14-30   │ 2024-01-15  │ 890 MB      │ 1,247       │ Compressed  │
│ projects_2024-01-14_14-30   │ 2024-01-14  │ 45 MB       │ 23          │ Incremental │
│ projects_2024-01-13_14-30   │ 2024-01-13  │ 885 MB      │ 1,224       │ Compressed  │
│ documents_2024-01-15_09-15  │ 2024-01-15  │ 1.2 GB      │ 3,456       │ Encrypted   │
└─────────────────────────────┴─────────────┴─────────────┴─────────────┴─────────────┘

📊 Total: 4 backups | 3.1 GB storage used
💾 Available space: 47.2 GB

⚙️ Configuration

Configuration is stored at ~/.config/smart-backup/config.json:

{
  "default_compression": true,
  "compression_level": 6,
  "default_encryption": false,
  "backup_retention": 30,
  "progress_bar": true,
  "colored_output": true,
  "default_exclude": ["*.tmp", "*.log", "__pycache__", "node_modules", ".git"],
  "compression_algorithms": {
    "text": "lzma",
    "images": "zip",
    "videos": "none",
    "archives": "none"
  }
}

🔧 Requirements

• Python 3.7+
• Virtual environment (automatically created)
• Available disk space for backups

Dependencies

click>=8.0.0           # CLI interface
rich>=12.0.0           # Beautiful terminal output
cryptography>=3.4.0    # Encryption support
psutil>=5.8.0          # System information
tqdm>=4.62.0           # Progress bars
schedule>=1.1.0        # Task scheduling

🗂️ Data Storage

• Backups: Stored in user-specified destination directories
• Config: ~/.config/smart-backup/config.json
• Logs: ~/.local/share/smart-backup/logs/
• Schedule: ~/.local/share/smart-backup/schedule.db

🛡️ Security Features

Encryption

• AES-256 encryption for sensitive data
• Password-based or key-file authentication
• Secure key derivation using PBKDF2

Integrity

• SHA-256 checksums for all backed up files
• Backup verification to ensure data integrity
• Corruption detection during restore operations

🚀 Performance

Optimization Features

• Multi-threaded processing for large directories
• Smart file type detection for optimal compression
• Memory-efficient streaming for large files
• Delta compression for incremental backups
• Parallel compression on multi-core systems

Benchmarks

• Large projects (10GB+): ~5-10 minutes with compression
• Incremental backups: ~30 seconds for typical changes
• Compression ratio: 60-80% for code projects
• Memory usage: <100MB for most operations

🛠️ Development

Manual Installation

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Run directly
python3 smart_backup.py --help

Project Structure

smart-backup/
├── smart_backup.py            # Main application
├── install_venv.sh           # Virtual environment installer
├── run.sh                    # Runner script
├── requirements.txt          # Dependencies
├── README.md                 # This file
├── LICENSE                   # MIT License
└── tests/                    # Test suite
    ├── test_backup.py
    ├── test_restore.py
    └── test_compression.py

🤝 Contributing

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

📝 License

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

🙏 Acknowledgments

• Rich for beautiful terminal output
• Click for the excellent CLI framework
• Cryptography for secure encryption

📞 Support

• 🐛 Bug Reports: Open an issue
• 💡 Feature Requests: Start a discussion
• 📧 Contact: sofalcons@outlook.com

---

⭐ Star this repo if it saves your data!

Made with ❤️ by LinuxCTRL - Controlling the world through better developer tools! 🌍💪

Part of the LinuxCTRL Developer Toolkit - Building tools that developers actually want to use.