Documentation
Operational reference for installing, licensing, and safely using ReSync.
Use this page as a practical checklist before running any write operation against your Rekordbox data.
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"What ReSync does
ReSync keeps your folders and Rekordbox library in sync by applying changes only after comparison and approval.
The app is intentionally conservative: it emphasizes visibility, explicit review, and deliberate execution over hidden automation.
Requirements
- A macOS version supported by the current ReSync release.
- A valid Rekordbox library and accessible music folders.
- 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.
Quick Start
- Install and launch ReSync.
- Open or import your Rekordbox library.
- Run Compare to detect differences against your folders.
- Review all proposed changes in Preview.
- Apply Sync only after explicit confirmation.
For first-time setup, prefer a small test subset before running broader sync operations.
Safe Workflow
- Keep backups before applying write operations.
- Always review Preview before running Apply Sync.
- Avoid manual edits in Rekordbox while sync changes are being prepared or applied.
- If output is unexpected, stop and re-run Compare before continuing.
Always keep a backup of the current state before running any sync operation.
License Basics
- 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.
Troubleshooting
- 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.
Help
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