rbxport Back to rbxport

Restore your library.

Your rbxport backup brings back the database and supporting files that make your library yours. Here’s how to put them back.

Restore in rbxport

This is the simplest way if rbxport opens normally. Leave the backup as a ZIP; the app extracts it for you.

  1. Close rekordbox

    Quit rekordbox before restoring. In rbxport, turn off PRO DJ LINK and wait for any running backup to finish.

  2. Turn off Library Protection

    Open rbxport’s Preferences → Advanced and turn off Library Protection. Restoring needs permission to change your library.

  3. Choose your backup

    Go to Preferences → Backups. Find the backup under Saved backups and select Restore. If the ZIP is elsewhere, choose Restore from ZIP… and select it on your computer or external drive.

  4. Confirm and let it finish

    Check the date and file path in the confirmation, then confirm the restore. Wait for “Backup restored.” before using the library again.

  5. Check your library

    Check a few playlists, hot cues, beatgrids, waveforms, and artwork. Play a track to confirm its music file is available. Turn Library Protection back on if you normally use it, then quit rbxport before reopening rekordbox.

Restore without the app

If rbxport won’t open, recent backup ZIPs include standalone restore scripts. You don’t need rbxport running to use them.

Quit both rbxport and rekordbox. Extract the ZIP completely into a folder. Keep master.db, analysis, artwork, and the restore scripts together; don’t run a script from inside the ZIP.

The script defaults to the database location recorded when the backup was created. These steps are intended for restoring to that same location. Check the destination it prints before confirming, especially if you have changed computers or moved the library.

macOS or Linux
  1. Open Terminal and change to the extracted backup folder. Type cd , drag the folder into the Terminal window, then press Enter. You can also enter its quoted path manually.
  2. Run the included script:
    bash ./restore-rekordbox.sh
  3. Check the database path shown. If it is correct, type y and press Enter. Press Enter without typing anything to cancel.
  4. Wait for “rekordbox was restored successfully.” before opening either app.
Windows
  1. In File Explorer, right-click the backup ZIP and choose Extract All….
  2. Open the extracted folder containing restore-rekordbox.ps1. Right-click an empty area and choose Open in Terminal, using a PowerShell tab.
  3. Run the included script:
    .\restore-rekordbox.ps1
  4. Check the database path shown. If it is correct, type y and press Enter. Press Enter without typing anything to cancel.
  5. Wait for “rekordbox was restored successfully.” before opening either app.

If Windows blocks script execution, use the in-app restore method instead. On a managed computer, ask your administrator for help.

The standalone script saves the files it replaces in a dated .rbxport-before-restore-… folder beside the destination database. It prints that folder’s path when it finishes. Keep it until you’ve checked the restored library.

If something gets in the way

The Restore button is disabled
Quit rekordbox, turn off Library Protection in Preferences → Advanced, and wait for any current backup or restore to finish.
The backup belongs to another library
The app checks the library path saved in the backup. Use a backup for the library currently open in rbxport. Moving to a different computer or library location needs a separate migration plan; don’t overwrite an unfamiliar database path.
The script says rekordbox is still running
Quit rekordbox and its background agent, then try again. Restarting the computer without reopening rekordbox can help if the agent is still active.
The ZIP has no restore scripts
Older backups may not include them. Try restoring the ZIP through Preferences → Backups in rbxport.
A standalone restore fails halfway through
Keep both apps closed. Keep the extracted backup and any dated rollback folder; a failed script may have replaced only some files and does not automatically undo those changes. Save the error message before attempting recovery.
Tracks are missing after the restore
The backup does not contain your audio files. Reconnect the drive that holds your music or relocate the missing files in rekordbox.
Back to the backup feature