| Crates.io | symor |
| lib.rs | symor |
| version | 1.1.1 |
| created_at | 2025-09-07 00:48:03.310018+00 |
| updated_at | 2025-09-07 00:48:03.310018+00 |
| description | Fileβmirroring utility (symβmirror). |
| homepage | |
| repository | https://github.com/cyber-boost/symor |
| max_upload_size | |
| id | 1827732 |
| size | 16,258,264 |
Real-time file mirroring and version control for the modern developer
Symor is a powerful command-line tool that provides real-time file mirroring with built-in version control, performance monitoring, and an intuitive terminal interface. Keep your important files synchronized across multiple locations while maintaining complete version history.
# Install symor binary to your system PATH
sym install
# Mirror a file to multiple locations
sym mirror source.txt /backup/source.txt /sync/source.txt
# Start watching a file for version control
sym watch important-config.json
# Check status of all operations
sym status
# View interactive dashboard
sym tui
# Create mirrors for a configuration file
sym mirror ~/.bashrc ~/backups/bashrc ~/cloud/bashrc
# Add another mirror target later
sym add-target ~/.bashrc ~/external-drive/bashrc
# Check sync status
sym status ~/.bashrc --verbose
# Force synchronization
sym sync ~/.bashrc --force
# Remove a mirror relationship
sym unmirror ~/.bashrc ~/cloud/bashrc
# Start tracking a file
sym watch project/config.yaml
# View file history
sym history <file_id>
# Restore from a previous version
sym restore <file_id> <version_id> ./restored-config.yaml
# Check for conflicts
sym conflicts
# View system statistics
sym stats --detailed
# Clean up old versions (dry run first)
sym clean --dry-run
sym clean --keep 5
# Verify system integrity
sym check
# View all tracked files
sym list --detailed
| Command | Description |
|---|---|
sym mirror <source> <target...> |
Mirror a file to multiple targets |
sym watch <path> [--recursive] |
Add file/directory to version control |
sym status [path] [--verbose] |
Show synchronization status |
sym list [--detailed] |
List all watched files and history |
sym sync [path] [--force] |
Manually trigger synchronization |
| Command | Description |
|---|---|
sym history <file_id> [--limit <n>] |
Display version history |
sym restore <file_id> <version_id> <target> |
Restore from version history |
sym conflicts |
List current conflicts |
| Command | Description |
|---|---|
sym unmirror <source> [target] |
Remove mirror relationships |
sym unwatch <path> |
Stop watching a file/directory |
sym add-target <source> <target> |
Add new mirror target |
sym clean [--dry-run] [--keep <n>] |
Clean up old versions |
| Command | Description |
|---|---|
sym tui [--refresh-rate <seconds>] |
Interactive terminal interface |
sym stats [--detailed] [--period <seconds>] |
Performance statistics |
sym check [path] |
Verify integrity |
sym info <path> |
Detailed file information |
# View current settings
sym settings show
# Configure versioning
sym settings versioning --enabled true --max-versions 50 --compression 6
# Configure linking behavior
sym settings linking --link-type hard --preserve-permissions true
# Set custom home directory
sym settings home /custom/symor/path
Launch the terminal user interface for real-time monitoring:
sym tui --refresh-rate 1
Features include:
Track system performance and file operations:
# Current statistics
sym stats
# Detailed system information
sym stats --detailed
# Metrics for specific time period
sym stats --period 300 # Last 5 minutes
Handle synchronization conflicts:
# List current conflicts
sym conflicts
# Check system integrity
sym check
# Manual sync with force flag
sym sync --force
Symor is designed for efficiency:
# Uninstall symor (keep data)
sym rip
# Uninstall and remove all data
sym rip --keep-data false
# General help
sym --help
# Command-specific help
sym mirror --help
sym settings --help
# Version information
sym --version
# Verbose output for debugging
sym status -v
sym sync -vv # Extra verbose
Symor - Keeping your files in sync, one mirror at a time. πͺ