Skip to main content

Backup File Specification

This page documents FolderRewind backup naming and storage conventions, and how they relate to the Rebuild History feature.

Filename format​

In source code, backup filenames are generated by GenerateFileName(...) in this format:

[Full/Smart/Overwrite][timestamp]folder-name [comment].extension

Examples:

  • [Full][2026-03-01_09-30-15]WorldA.7z
  • [Smart][2026-03-01_10-00-10]WorldA [Auto].7z
  • [Overwrite][2026-03-01_11-22-08]WorldA [Manual].zip

Field definition​

  • Type prefix: [Full], [Smart], [Overwrite]
  • Timestamp: yyyy-MM-dd_HH-mm-ss
  • Folder name: display name of the managed folder
  • Comment: optional, written as [comment]
  • Extension: archive format, typically 7z or zip

Naming notes​

  • Comments are sanitized before writing to file names.
  • [ and ] are removed from comments to avoid parsing conflicts.
  • Avoid manually renaming generated backup files if you want stable history rebuilding.

Backup storage structure​

Each config uses its DestinationPath as the backup root and stores archives by managed folder name.

DestinationPath/
├─ <FolderDisplayName>/
│  ├─ [Full][...].7z
│  ├─ [Smart][...].7z
│  └─ [Overwrite][...].zip
└─ _metadata/
   └─ <FolderDisplayName>/
      └─ metadata.json

Notes:

  • DestinationPath/<FolderDisplayName>/: actual backup archive directory.
  • DestinationPath/_metadata/<FolderDisplayName>/metadata.json: smart-incremental chain metadata.

Default destination path​

If you do not customize destination path, the recommended default root is:

Documents/FolderRewind-Backup

Per config, default destination is usually:

Documents/FolderRewind-Backup/<config-name>

Relationship to Rebuild History​

Rebuild History depends on existing backup files. For more accurate rebuild results:

  1. Keep the naming format (especially type prefix and timestamp).
  2. Keep directory layout as DestinationPath/<FolderDisplayName>/.
  3. Do not arbitrarily delete/rename key files in an incremental chain (especially Full baseline files).

Important flag and auto-pruning​

  • History items can be marked as Important.
  • Auto-pruning skips backup files marked as important.

So for long-term retention, mark milestone backups as important.

v1.4.2 adds MARK_IMPORTANT for marking/unmarking important backups:

MARK_IMPORTANT <config_id> <folder_index|folder_name> <backup_file> [true|false]

  • If the last argument is omitted, default is true.
  • It is recommended to pass full backup filename (with prefix and extension).