orca-backup

A cross-platform command-line tool for backing up and restoring OrcaSlicer and Orca-FlashForge configurations.

Features

Feature	Description
Automatic Detection	Identifies installed slicers (OrcaSlicer, Orca-FlashForge)
Full Configuration Backup	User profiles, config files, scripts, and custom settings
ZIP Compression	Integrity-checked compressed backups
Cross-Platform	Works on Windows, macOS, and Linux
Safe Restore	Includes pre-restore safety checks and optional dry-run
Backup Verification	Ensures backup integrity and displays backup details
No Junk Files	Excludes system files, presets, logs, and temporary data

Installation

pip install orca-backup git clone https://github.com/GhostTypes/orca-backup-tool.git cd orca-backup-tool pip install -e .

Usage

List detected slicers

orca-backup list

Create a Backup

# General Usage orca-backup backup --slicer orcaslicer orca-backup backup --slicer orca-flashforge orca-backup backup --slicer all # Specify custom output directory orca-backup backup --slicer orcaslicer --output /path/to/backups # Create uncompressed backup orca-backup backup --slicer orcaslicer --no-compress # Skip verification orca-backup backup --slicer orcaslicer --no-verify

Restore a Backup

orca-backup restore /path/to/backup.zip # Dry run (show actions without applying changes) orca-backup restore /path/to/backup.zip --dry-run # Restore without automatically backing up existing files orca-backup restore /path/to/backup.zip --no-backup

Verify or Inspect Backups

# Verify backup integrity orca-backup verify /path/to/backup.zip # Display detailed backup information orca-backup info /path/to/backup.zip

What Gets Backed Up

Category	Included
Main Configuration	OrcaSlicer.conf / Orca-FlashForge.conf
User Profiles	Filament profiles Machine configurations Process settings
Custom Scripts	Orca-FlashForge user scripts (if present)
Excluded	System files, vendor presets, logs, temporary files

Default Backup Location

Backups are stored inside a folder named OrcaBackups located in your user’s home directory.
This directory is automatically created if it does not exist.

Operating System	Default Backup Path
Windows	C:\Users\\OrcaBackups
macOS	/Users//OrcaBackups
Linux	/home//OrcaBackups

Use the --output option if you want to store backups in a different directory.