Skip to content

Upgrading

Download Latest Version

Download the latest version - The download page will automatically detect your platform and show you the correct version.

Before upgrading, be sure to check the changelog for any breaking changes and news.

Upgrading within 5.x

For users already on 5.0.x, upgrading to a newer 5.x release is straightforward:

  1. Download the new version from the link above
  2. Install it over the existing installation
  3. Launch the application. Settings are preserved and any necessary config changes are applied automatically on first launch.

A timestamped backup of your configuration is saved to Documents/WhatsNowPlaying/configbackup/ before any upgrade runs, so you can recover if anything goes wrong.

Upgrading from 3.x or 4.x to 5.x

Automatic Directory Migration

The application will automatically migrate your Documents directory:

  • Old location: Documents/NowPlaying
  • New location: Documents/WhatsNowPlaying

What happens during migration:

  • A dialog will notify you about the migration process
  • All templates, custom files, and directories will be copied to the new location
  • Log files (.log) and temporary files (.new) are excluded from the copy (new logs will be created in the new location automatically)
  • Configuration paths pointing to the old directory are automatically updated
  • Your old Documents/NowPlaying directory remains as a backup
  • The migration only runs once - subsequent launches will use the new directory

After upgrading:

  • If you need to downgrade, your old directory is still available
  • Once you've confirmed your DJ software is detected, tracks display correctly, and your outputs (OBS, Twitch, etc.) are working, you can safely delete the old Documents/NowPlaying directory

Configuration Backup

The system will automatically put an importable copy of your config in the Documents/WhatsNowPlaying/configbackup folder for recovery. After the upgrade is successful, you should delete this copy as necessary.

Configuration Recovery

If an upgrade fails or settings are lost, you can restore from a configuration backup:

  1. Export before upgrading (recommended):
  2. Open Core Settings → General → Export Configuration
  3. Save the JSON file to a secure location
  4. Import if needed (only if settings are lost):
  5. Open Core Settings → General → Import Configuration
  6. Select your exported JSON file
  7. Save and restart the application

[!WARNING] Only import configurations when necessary. Normal upgrades preserve settings automatically. Configuration files contain sensitive data - store securely and delete when no longer needed.

Upgrading from 2.x to 5.x

Important: You must upgrade to version 3.1.2 first, then upgrade to the current version.

  1. Install version 3.1.2 from the releases page
  2. Launch the application. Settings will be migrated automatically.
  3. Then upgrade to the current version

Upgrading from 1.x to 5.x

Unfortunately, 1.x.x wasn't built to support upgrades. You will need to treat this as a fresh install. None of your settings will be preserved.