Updates

Once by hand (up to 3.0.2)#Link to “Once by hand (up to 3.0.2)”

Versions up to 3.0.2 (1.x, 2.x and 3.0.x) do not update themselves: 2.2.1 to 3.0.2 still look for their updates at an old address that no longer exists. Install the current version once via the download page; it always provides the latest version. Your library is kept.

1. Download the installer from the download page.
2. Run the installer. If Windows SmartScreen shows a warning, choose “More info” and then “Run anyway” – the installer is not yet signed.
3. Start Sonodex. From now on it checks for new versions itself.

From 1.x to 2.x#Link to “From 1.x to 2.x”

On the first start of a 2.x version, a 1.x library switches once to the Rust storage via a verified copy. The original is kept, and the settings offer a way back.

How automatic updates work#Link to “How automatic updates work”

1. Sonodex checks for a new version right at start-up and then every six hours.
2. An update is downloaded silently in the background. It is only installed if Sonodex’s own signature is valid for exactly this file.
3. If a verified update is ready within the first two minutes after start-up and nothing is running, Sonodex briefly quits and restarts in the new version.
4. If downloads, sync, backups or imports are running, or the update arrives later, it is installed the next time you quit normally. The new version then runs at the next start.

“New in Sonodex”#Link to ““New in Sonodex””

After switching to a new version, Sonodex shows the “New in Sonodex …” dialogue once with the changes since the last confirmed version. “OK” closes it; it only appears again at the next update. You can reach it at any time via Help → “What’s new”. All versions are also listed in the changelog.

Stable and Beta#Link to “Stable and Beta”

Under Settings → General → Updates you choose the “Update channel”: “Stable (recommended)” only gets released versions, “Beta” additionally gets pre-release versions for testing; every stable version arrives there too. If you switch back from Beta to Stable, an installed beta stays until a newer stable version appears. “Check now” searches immediately.

Database conversions#Link to “Database conversions”

If an update changes the format of the library database, Sonodex converts it step by step, each step in a transaction. If a step fails, the last complete state is kept. Since 2.2.1 Sonodex no longer creates a copy of the database beforehand (previously crateflow.sqlite.before-v<N>.bak); it does not delete existing files of this kind.