Manually Migrating Projects and Settings

You can move projects and settings

• from Livegrade v4 to Livegrade v5 and Livegrade Studio v5, and
• from Livegrade v5 to Livegrade Studio v5.

When starting a v5 application for the first time, the software asks if projects should be migrated, or if you want to start with an empty library.

If you have already been working with an application of version v5 and haven’t migrated your projects yet, you can also migrate projects and settings later manually. The necessary steps are described below.

Migrating Projects Manually from v4 to v5

As the project format is different between v4 and v5, you need to trigger the migration in the software.

Please note: Livegrade v4 has one database file that holds all projects, while Livegrade v5 and Livegrade Studio v5 have a project folder and database for each project. The migration between v4 and v5 takes care about this change.

This can be done by temporarily moving the existing v5 projects away, letting the software migrate all old projects and move any data created with the v5 application back:

• Quit all versions of Livegrade.
• Navigate to ~/Library/Application Support/Pomfort/ in your home directory (To navigate there in Finder, choose “Library” in the “Go” menu of Finder – this option is only visible with the “Alt” key pressed).
• Rename the folder for the software of version 5: Depending on which application you are using, rename the Livegrade5 or LivegradeStudio5 folder, e.g. by adding “_original” to the folder name.
• Start Livegrade v5 or Livegrade Studio v5
• The migration dialog is shown, choose “Copy existing projects”.
• A new folder (Livegrade5 or LivegradeStudio5) is created and the projects from Livegrade v4 are migrate there.
• Quit all versions of Livegrade again.
• If you need to restore projects already created with the v5 application, navigate to the renamed folder (see above), and move all project folders (with the name “Project-xxx...“, e.g. Project-E266CBFCA731), the License folder, the MIDI Mappings folder and the Scripts folder in the new v5 folder with the migrated projects.
• Open your v5 application again. You should now see all  projects.

Migrating Projects from Livegrade to Livegrade Studio (both v5)

Each of the applications manages it’s  projects in a separate folder. You can easily move project folders from one application to another:

• Quit all versions of Livegrade.
• Navigate to ~/Library/Application Support/Pomfort/ in your home directory (To navigate there in Finder, choose “Library” in the “Go” menu of Finder – this option is only visible with the “Alt” key pressed).
• Move project folders (with the name “Project-xxx...“, e.g. Project-E266CBFCA731) from the Livegrade5 folder to the LivegradeStudio5 folder.
• Open Livegrade Studio  again. You should now see all moved  projects.

In order to identify a project folder for the current project, you can use “Show Library in Finder” in the application menu. The folder will open in Finder.

Migrating Keyboard Shortcuts and Video Routing Configurations Manually

Settings for keyboard shortcuts, video routing configurations, and automations are stored in the user preferences. We created a script that let’s you extract such settings and move them from the Livegrade v4 preferences to Livegrade v5 or Livegrade Studio v5. The necessary steps are described below.

• Download the script migrate-to-lg5.py.
• Open the Terminal application
• Navigate to the folder with the downloaded script, e.g. cd PATH/TO/DOWNLOADS
• Make the script executable: chmod +x migrate-to-lg5.py
• Quit all versions of Livegrade.
• Run the script migrate-to-lg5.py (see below).
• Open your v5 application. You should now see all migrated settings.

Usage of the migrate-to-lg5.py Script

The script has two options to choose which settings to migrate:

• --keyboard-shortcuts : Migrate keyboard shortcuts
• --video-routings : Migrate video routings

The script migrates from Livegrade v4 to Livegrade v5 by default, if you want to migrate your settings to Livegrade Studio v5, please use the additional --studio option.

If you want to migrate your settings from Livegrade v5 to Livegrade Studio v5, please use the --from-pro5-to-studio option.

Examples:

./migrate-to-lg5.py --video-routings
… migrates video routings from Livegrade v4 to Livegrade v5

./migrate-to-lg5.py --keyboard-shortcuts --video-routings --studio
… migrates keyboard shortcuts and video routings from Livegrade v4 to Livegrade Studio v5

./migrate-to-lg5.py --keyboard-shortcuts --from-pro5-to-studio
… migrates keyboard shortcuts from Livegrade v5 to Livegrade Studio v5