Auto Versioning

Auto Versioning is MixRestore's core feature. Once enabled, it watches your project folder for changes and automatically creates a version snapshot every time you save.

How it works

When auto versioning is active, MixRestore uses filesystem watchers to detect changes to your project files. When a change is detected:

1. MixRestore waits for the file write to complete (debounced to avoid partial saves)
2. All changed files in the project folder are staged
3. A new commit is created with an auto-generated message and timestamp
4. Project metadata (BPM, key, tracks, etc.) is extracted and stored

Enabling auto versioning

In the project detail view, toggle the Auto Versioning switch. The switch turns green when active. Auto versioning persists across app restarts — when you reopen MixRestore, any previously-enabled projects will resume watching automatically.

What gets tracked

MixRestore tracks all files in your Ableton project folder, including:

• The .als Live Set file
• Samples in the project's Samples/ directory
• Presets and Racks
• Any other files in the project folder

Ignored files

MixRestore automatically ignores certain files that don't need versioning:

• Backup/ directory (Ableton's own backups)
• Undo history files
• Temporary and cache files

Manual versioning

You can also create versions manually by clicking the Save Version button. This is useful when you want to add a custom message describing what changed, or when auto versioning is disabled.