DuRT 3.0.0 Migration Guide: Database Overhaul & Clean Upgrade

WARNING

Important Notice for Upgrading Users:
DuRT 3.0.0 introduces a major architectural overhaul to its persistent storage layer (powered by GRDB SQLite) and workflow execution engine. The database schema in v3.0.0 is incompatible with v2.x and earlier versions.
If you have installed or run a previous version of DuRT, DO NOT install over your existing installation without cleaning up first. Direct overwrites can lead to launch crashes, unreadable session histories, or unexpected UI errors. Please follow the steps below to safeguard your data and perform a clean installation.

---

1. Migration Assessment: Do You Need to Migrate Data?

DuRT’s Workspace structure determines where your historical audio, subtitles, and exported transcripts are stored:

Workspace Mode	Storage Characteristics	Manual Migration Required?	Recommendation
Custom Workspace	External user-selected folder (e.g., Documents, external drive)	No ✅	Your files reside safely in your own folder. Uninstalling or upgrading the app will not affect them. Simply rebind the directory in v3.0.0 settings.
Default Workspace	System sandbox folder (~/Library/...)	Yes ⚠️	Files in the sandbox may be wiped when removing the legacy application or clearing cache. You must export or copy out important documents, subtitles, and audio before upgrading!

---

2. Backing Up the Default Workspace

If you have been using the Default Workspace, complete these steps before removing the legacy version:

1. Launch your current DuRT version.
2. Export Key Subtitles & Documents:
   • In session history or the editor, export important transcripts to .srt, .vtt, .json, or .txt into your Mac’s Downloads or Documents folder.
3. Locate & Copy Default Workspace Files:
   • In Finder, press Command ⌘ + Shift ⇧ + G.
   • Enter the sandbox path:

     ~/Library/Containers/com.dudufuture.durt/Data/Library/workspace

   • Copy the entire workspace folder to your Desktop or an external drive as a backup.

---

3. Performing a Clean Uninstall of the Legacy Version

Before installing DuRT 3.0.0 from the App Store, remove legacy binary and database remnants:

Step A: Quit and Remove Old App

1. Quit DuRT completely (ensure it is closed from the menu bar and Dock).
2. Open Finder → Applications.
3. Drag the old DuRT.app to the Trash and select Empty Trash.

Step B: Remove Conflicting Legacy SQLite Database

Open Terminal and run the following command to remove the outdated schema:

# Remove legacy database files (does not affect files exported to your Documents)
rm -rf ~/Library/Containers/com.dudufuture.durt/Data/Library/database

Alternatively, for a complete fresh start (after verifying your backups):

rm -rf ~/Library/Containers/com.dudufuture.durt

---

4. Install and Enjoy DuRT 3.0.0

With the clean environment prepared:

1. Open the Mac App Store, search for DuRT, and download version 3.0.0.
2. Launch DuRT. It will automatically initialize the newly designed high-performance SQLite pool and workflow engine.
3. Go to Settings → Workspace:
   • If you used a custom workspace, click “+ Add” to re-link your previous folder.
   • For Pro users, click “Restore Purchase” in Settings → Membership to sync your App Store entitlements.

If you encounter any issues during migration, feel free to reach out to developer support at dufuture@outlook.com.