Documentation

Back to site

Operational reference for installing, licensing, and safely using ReSync.

Use this page as a practical checklist before changing a Rekordbox library or a Folder Sync destination.

Important Notice (Current Build Status)

Before first use, review these requirements:

This build is currently not notarized, so macOS Gatekeeper may block the first launch.
If blocked, allow ReSync manually in System Settings > Privacy & Security with Open Anyway.
ReSync requires Keychain access to store and read license data required for activation and validation.
Without Gatekeeper approval and Keychain permission, licensing cannot work and the app is not usable as intended.
ReSync does not run in-app analytics or tracking.
License material is stored locally in macOS Keychain. See the Privacy page for workflow-level data handling.

If macOS blocks first launch, run this command in Terminal:

sudo xattr -dr com.apple.quarantine "/Applications/ReSync.app"

ReSync provides separate workflows for updating a Rekordbox library and mirroring a selected folder to another folder or drive.

The app is intentionally conservative: it emphasizes visibility, explicit review, and deliberate execution over hidden automation.

A macOS version supported by the current ReSync release.
An accessible Rekordbox library for library sync, or accessible source and destination folders for Folder Sync.
A valid license key for activation and normal operation.
An active internet connection is required for proper operation.
Permissions for local file access and Keychain usage.

If one requirement is missing, behavior can be limited or blocked by design to protect data integrity.

For first-time setup, prefer a small test subset before running broader sync operations.

Create a connection and choose its source and destination folders.
Set the direction. The selected source remains read-only.
Run Preview if you want to review the planned changes first.
Run Sync to copy new or changed files and remove obsolete connection-managed files from the destination.
Unrelated files outside the connection-managed content remain untouched.

Keep recoverable backups of your Rekordbox library and Folder Sync destinations before write operations.
Preview is required before Rekordbox Apply Sync and optional for Folder Sync.
Avoid editing affected data while a sync is being prepared or applied.
If output is unexpected, stop and re-run Compare before continuing.

Always keep a backup of the current Rekordbox state and selected Folder Sync destination before running a write operation.

Activation requires a valid key and successful license server response.
License status is determined by license policy.
If the license server is unavailable, activation/request actions are disabled until a successful check.
Open License details in Settings to review status and timing-related fields.

Check and grace windows are policy-driven and may differ by plan.

License server unavailable: verify your network, then use Retry in the License tab after connection is restored.
Activation failed: confirm key format and that the key is active for your plan.
No changes detected: verify selected library and watched folders, then run Compare again.
Unexpected result in Preview: stop, review filters/input paths, then compare again before apply.
Gatekeeper block: allow Open Anyway in Privacy & Security and relaunch.

If an issue persists, include exact timing, visible error text, and the last actions taken before the problem.

For setup and technical questions, include app version, a short issue summary, and reproduction steps when you ask for help.

Need help with setup or a technical issue? Open help page