Orbit v0.6.0

Orbit v0.6.0

Installation

Download the appropriate binary for your platform below, extract it, and add it to your PATH.

Linux (x86_64)

wget https://github.com/saworbit/orbit/releases/download/v0.6.0/orbit-v0.6.0-x86_64-unknown-linux-gnu.tar.gz
tar xzf orbit-v0.6.0-x86_64-unknown-linux-gnu.tar.gz
sudo mv orbit /usr/local/bin/
orbit --version

macOS (Apple Silicon)

wget https://github.com/saworbit/orbit/releases/download/v0.6.0/orbit-v0.6.0-aarch64-apple-darwin.tar.gz
tar xzf orbit-v0.6.0-aarch64-apple-darwin.tar.gz
sudo mv orbit /usr/local/bin/
orbit --version

Windows (x86_64)

Download orbit-v0.6.0-x86_64-pc-windows-msvc.zip, extract orbit.exe, and add to PATH.

What's Changed

See CHANGELOG.md for full details.

Documentation

• Main README: https://github.com/saworbit/orbit/blob/main/README.md
• Web GUI Guide: https://github.com/saworbit/orbit/blob/main/docs/WEB_GUI.md
• Full Documentation: https://github.com/saworbit/orbit/tree/main/docs

---

Full Changelog: v0.6.0...v0.6.0

Orbit v0.5.0

Orbit v0.5.0

Installation

Download the appropriate binary for your platform below, extract it, and add it to your PATH.

Linux (x86_64)

wget https://github.com/saworbit/orbit/releases/download/v0.5.0/orbit-v0.5.0-x86_64-unknown-linux-gnu.tar.gz
tar xzf orbit-v0.5.0-x86_64-unknown-linux-gnu.tar.gz
sudo mv orbit /usr/local/bin/
orbit --version

macOS (Apple Silicon)

wget https://github.com/saworbit/orbit/releases/download/v0.5.0/orbit-v0.5.0-aarch64-apple-darwin.tar.gz
tar xzf orbit-v0.5.0-aarch64-apple-darwin.tar.gz
sudo mv orbit /usr/local/bin/
orbit --version

Windows (x86_64)

Download orbit-v0.5.0-x86_64-pc-windows-msvc.zip, extract orbit.exe, and add to PATH.

What's Changed

See CHANGELOG.md for full details.

Documentation

• Main README: https://github.com/saworbit/orbit/blob/main/README.md
• Web GUI Guide: https://github.com/saworbit/orbit/blob/main/docs/WEB_GUI.md
• Full Documentation: https://github.com/saworbit/orbit/tree/main/docs

---

Full Changelog: v0.5.0...v0.5.0

v0.4.0 - SMB Protocol Architecture

🌐 Orbit v0.4.0 - SMB Protocol Architecture

Major architectural release introducing protocol abstraction layer for network share support.

✨ What's New

• Protocol Abstraction Layer - Clean StorageBackend trait for multiple backends
• SMB/CIFS Architecture - Complete architecture ready for library integration
• URI Detection - Automatic protocol detection (smb://, file://, local paths)
• Local Backend - Fully functional local filesystem operations
• 100% Backward Compatible - All existing features work unchanged

📦 Status

• ✅ Architecture complete and tested (32 tests passing)
• ✅ Documentation comprehensive
• ⚠️ SMB operations are mock implementation (v0.4.1 will add real SMB library)

🚀 Usage

# Local operations work as before
orbit -s file.txt -d backup.txt

# SMB URIs parse and validate (operations pending v0.4.1)
orbit -s file.txt -d smb://server/share/file.txt --dry-run

📚 Documentation

See SMB_IMPLEMENTATION.md for complete guide
See examples/smb_examples.sh for 21 usage examples

🗺️ Next: v0.4.1
Real SMB library integration coming in v0.4.1 (1-2 weeks).

v0.3.1 - Statistics Command

🌌 Orbit v0.3.1 - Statistics Command

Patch release adding audit log analytics capabilities.

✨ What's New

New Command: orbit stats

Analyze your transfer history with detailed statistics!

# Show statistics from default audit log
orbit stats

# Use custom log file  
orbit stats --log /path/to/audit.log

# Analyze CSV format logs
orbit stats --format csv

What it shows:

📊 Total operations (successful/failed/skipped)
📦 Data volume transferred with averages
⚡ Transfer speeds (minimum/maximum/average)
🗜️ Compression ratios and space saved
📅 Most recent transfer details

Example Output

📊 Orbit Transfer Statistics
============================

Total Operations: 4
✅ Successful: 4
❌ Failed: 0

📦 Data Transferred:
   Total: 85 B
   Average per operation: 21 B

⏱️  Performance:
   Average speed: 8.30 KB/s
   Fastest transfer: 19.53 KB/s
   Slowest transfer: 4.07 KB/s

🗜️  Compression:
   Operations with compression: 1 (25.0%)
   Average compression ratio: 136.0%

📅 Most Recent Transfer:
   2025-10-12T06:15:46
   "test_stats.txt" -> "test_stats_backup.txt"
   15 B in 1ms

📦 Installation

git clone https://github.com/saworbit/orbit.git
cd orbit
cargo build --release

🔄 Upgrading from v0.3.0
No breaking changes! Just rebuild and you're ready to go.
📚 Documentation

[Full README](https://github.com/saworbit/orbit/blob/main/README.md)
[Quick Start Guide](https://github.com/saworbit/orbit/blob/main/quickstart_guide.md)
[Example Scripts](https://github.com/saworbit/orbit/tree/main/examples)


Full changelog: [v0.3.0...v0.3.1](https://github.com/saworbit/orbit/compare/v0.3.0...v0.3.1)
Thank you for using Orbit! 🚀

v0.3.0 - The Refactor

🌌 Orbit v0.3.0 - The Refactor

Major Release - Complete modular rewrite with breaking changes

🎯 What's New

This is a significant refactor of Orbit with a modular architecture and many new features. If upgrading from v0.2.0, please read the Migration Guide.

✨ Highlights

• 🗜️ Zstd Compression - 22 configurable levels (1=fast, 22=max compression)
• ⚡ Parallel Copying - Multi-threaded for directories (up to 73% faster!)
• 📊 JSON Audit Logs - Machine-parseable logging (one JSON per line)
• ⚙️ Configuration Files - TOML-based with project/user hierarchy
• 🔄 Multiple Copy Modes - Copy, Sync, Update, Mirror
• 🚦 Bandwidth Limiting - Rate-limit transfers (MB/s)
• 🎭 Exclude Patterns - Glob-based file filtering
• 🧪 Dry Run Mode - Preview before executing
• 📚 Library API - Use Orbit in your own Rust projects

🚀 Performance

Operation	v0.2.0	v0.3.0	Improvement
1000 small files	45s	12s	73% faster
10GB compressed	180s	145s	19% faster
Directory tree (100k files)	N/A	8m	New!

📦 Installation

# Clone and build
git clone https://github.com/saworbit/orbit.git
cd orbit
cargo build --release

# Or install directly
cargo install --path .

🎓 Quick Start
# Simple copy
orbit -s file.txt -d backup.txt

# Directory with compression
orbit -s ./project -d /backup/project -R --compress zstd:9

# Network transfer with resume and retry
orbit -s bigfile.iso -d /mnt/server/bigfile.iso \
  --compress zstd:3 \
  --resume \
  --retry-attempts 10 \
  --max-bandwidth 50

📚 Documentation

[📖 README](https://github.com/saworbit/orbit/blob/main/README.md) - Full documentation
[🚀 Quick Start Guide](https://github.com/saworbit/orbit/blob/main/quickstart_guide.md) - Get started in 5 minutes
[🔄 Migration Guide](https://github.com/saworbit/orbit/blob/main/migration_guide.md) - Upgrade from v0.2.0
[⚙️ Sample Config](https://github.com/saworbit/orbit/blob/main/sample_config_toml.txt) - Configuration examples

⚠️ Breaking Changes

CLI syntax changed (e.g., --compress zstd:3 instead of just --compress)
Audit log format is now JSON Lines by default
Configuration structure redesigned

See [migration_guide.md](https://github.com/saworbit/orbit/blob/main/migration_guide.md) for detailed upgrade instructions.
🧪 Testing

32 total tests (18 unit + 14 integration)
~60% code coverage
Tested on Windows (other platforms coming soon)

📊 Stats

2,500+ lines of code
11 modules
Supports: Windows, Linux, macOS


🐛 Known Issues

Disk space check shows warning on some Windows systems (non-fatal, does not affect operation)

🔮 What's Next (v0.4.0)
Planned for Q1 2026:

SMB/network share support
S3 and cloud storage protocols
Watch mode (auto-sync on file changes)
REST API for remote control
Chunk-level parallelism


📞 Support & Feedback

Issues: [Report bugs](https://github.com/saworbit/orbit/issues)
Discussions: [Ask questions](https://github.com/saworbit/orbit/discussions)
Email: [shaneawall@gmail.com](mailto:shaneawall@gmail.com)

📜 License
Dual-license model:

Non-commercial use: Free under CC BY-NC-SA 4.0
Commercial use: Contact [shaneawall@gmail.com](mailto:shaneawall@gmail.com)


Thank you for using Orbit! 🚀
If you find it useful, please ⭐ star the repository!