What can I do if BrainSoup fails to start?

If BrainSoup fails to start, especially after an update, it might be due to a corrupted database.

Fortunately, BrainSoup automatically creates a backup of your database after each successful start, and keeps the 10 most recent backups. These backups are stored in the %AppData%\BrainSoup\Backup\ directory.

To restore a backup of your database, follow these steps:

  1. Go to the %AppData%\BrainSoup\ directory. The database files are named BrainSoup.<user_id>.db and BrainSoup.<user_id>.db.lock .
  2. Before deleting the current database files, make a copy of them in a safe location, in case the database was not the issue.
  3. Delete the current BrainSoup database files.
  4. Copy the most recent backup file from the %AppData%\BrainSoup\Backup\ directory to the %AppData%\BrainSoup\ directory.
  5. Rename it by removing the timestamp at the end of the filename (e.g., BrainSoup.8c8d532d44a9b4aba4e3fc8a.db.20240723110435 becomes BrainSoup.8c8d532d44a9b4aba4e3fc8a.db ).
  6. Start BrainSoup again.