Migrating from CSI v3 to v7

CSI has undergone a major version jump from v3 to v7 to synchronize with the latest version of Reaper. This version brings significant improvements, including a revamped folder structure, enhanced FX Learn functionality, and various performance upgrades. However, due to these changes, users upgrading from CSI v3 will need to manually migrate their configurations.

This guide outlines the necessary steps to transition from CSI v3 to v7.

Backup Your Prior CSI Folder and .dll/.dylib

Before you attempt to migrate to CSI v7, it's recommended you back-up your current-state CSI setup so you can always return to it. To go about that:

1. Backup/archive your current CSI folder in the Reaper Resource Path.
2. Go to Reaper's Resource Path, the UserPlugins folder and backup a copy of the reaper_csurf_integrator.dll/.dylib so you can revert back if needed.
3. You may as well start fresh with a new CSI folder and startup anew as you'll need to rebuild your CSI settings (csi.ini) and update your support files.

Migrating to the Latest CSI

Migrating to the latest version of CSI from the prior stable version will require a few changes:

1. Your older .mst or .ost files in surfaces are now surface.txt files. They are all named surface.txt and will live inside a surface folder for your device.

2. The folder structure is different in the new version - instead of some files being split out between Surfaces and Zones, everything lives in the Surfaces[DeviceName]\ folder. There's an FXZones folder, HomeZones folder, and a GoZones folder. Stick your .zon files in there. See the Installation and Folder Structure page for more details.

3. The old GoAssociatedZone action is replaced with just GoZone. Update your zone files. See Activating Zones for more details.

4. AssociatedZones/AssociatedZonesEnd syntax in the Home zone is gone. There's a new GoZones.zon file where you list all of those. Put the zone files in the GoZones folder. See the Home Zones and GoZones pages for more details.

5. FX Learn is much improved. Learn about it on the Learn Mode page.

6. Automap has been deprecated. The new FX Learn system is meant to act as a replacement.

7. FocusedFXParam has been renamed LastTouchedFXParam. Update your zone files. See LastLastTouchedFXParam.

8. It is now recommended that "Buttons" just be added directly to the Home zone, rather than being an IncludedZone. This change is entirely optional. It still works the old way as an included zone.

9. New csi.ini format and modified broadcast/listen options. You are advised to setup your CSI devices anew for the new version.

10. Various under-the-hood and performance changes. This is a complete rewrite of CSI.