Migration Guide

Moving from Zerynth r1.0.* to version r2.0.0 some precautions must be taken to avoid incurring in problems. In particular the following recommendations should facilitate the migration:

Windows Issues

Zerynth r2.0.0 is installed in the same folder of the previous installation (usually C:/Program Files/Zerynth) overwriting the startup file Zerynth.exe. However, all data, packages and configuration files are installed under C:/Users/username/zerynth2 (or similar) leaving the previous installation untouched (under C:/Users/username/zerynth). Therefore to go back to Zerynth r1.0.* is sufficient to reinstall and no data will be lost. It is also possible, but not suggested, to rename C:/Program Files/Zerynth to something else before updating to r2.0.0 in order to keep the old Zerynth.exe.

Mac OS X Issues

In Zerynth r2.0.0 the folder containing configuration files, data and packages has changed from ~/Documents/Zerynth to ~/.zerynth2/. Since folders starting with a dot are hidden, if needed it is possible to browser it by opening the Finder, pressing Cmd+Shift+G and typing the path manually.

Linux Issues

To complete the installation it is necessary for xz utils to be present in the system. Moreover, multilib support is needed to execute the gcc compiler for ARM that comes in a 32 bit fashion only.

Migrating projects

Zerynth r2.0.0 completely changes the way of managing projects. They can be saved anywere as a folder with source files and it is up to the user to keep them in order. Therefore, existing projects can not be opened by the new Zerynth. They can however be easily imported manually. Old projects can be found:

  • Under C:/Users/username/zerynth/projects for Windows
  • Under ~/Documents/Zerynth/projects for Mac
  • Under ~/.zerynth/projects for Linux

Projects are saved under folders with long alphanumeric names (uuids). To manually import such projects:

  • Create a new project in Zerynth Studio r2.0.0
  • Select all the old project files (and folders) in the system File Manage (Explorer, Finder, etc...) and drag them on the current project view in Zerynth Studio. Alternatively, since a Zerynth r2.0.0 project is a folder, files can be dropped in there directly and Zerynth Studio will refresh accordingly

Migrating remote projects

Old Zerynth projects saved on our cloud are still there, however they are not compatible with the new Zerynth release. In order to migrate them, first download them by synching the old Zerynth Studio project list and then follow the instructions for locally saved project.