feat(#394): add studio one project scanning support

Author: rogerb831

.gitignore

@@ -11,6 +11,7 @@
 # Owlplug specific
 build/input/
 build/output/
+temp/
 src/main/resources/credentials.properties
 
 # OwlPlug Host binaries 

owlplug-client/src/main/java/com/owlplug/core/components/ApplicationDefaults.java

@@ -169,6 +169,7 @@ public Image getDAWApplicationIcon(DawApplication application) {
     return switch (application) {
       case ABLETON -> abletonLogoImage;
       case REAPER -> reaperLogoImage;
+      case STUDIO_ONE -> pluginComponentImage; // Using generic plugin icon as placeholder
     };
   }
 

owlplug-client/src/main/java/com/owlplug/core/utils/ArchiveUtils.java

@@ -25,6 +25,7 @@
 import java.io.InputStream;
 import java.io.OutputStream;
 import java.nio.file.Files;
+import java.util.Collection;
 import org.apache.commons.compress.archivers.ArchiveEntry;
 import org.apache.commons.compress.archivers.ArchiveException;
 import org.apache.commons.compress.archivers.ArchiveInputStream;
@@ -126,4 +127,39 @@ private static void uncompress(ArchiveInputStream o, File destinationDirectory)
     }
   }
 
+  /**
+   * Extract only specific files from an archive.
+   * This is useful when you only need a subset of files and want to avoid
+   * creating directories with reserved names (e.g., Windows "Strings" directory).
+   *
+   * @param archive the archive file to extract from
+   * @param dest the destination directory
+   * @param targetPaths collection of file paths within the archive to extract (e.g., "metainfo.xml", "Devices/audiomixer.xml")
+   * @throws IOException if extraction fails
+   */
+  public static void extractFiles(File archive, File dest, Collection<String> targetPaths) throws IOException {
+    try (InputStream fi = new BufferedInputStream(new FileInputStream(archive));
+         ArchiveInputStream ais = new ArchiveStreamFactory().createArchiveInputStream(fi)) {
+
+      ArchiveEntry entry;
+      while ((entry = ais.getNextEntry()) != null) {
+        String entryName = entry.getName().replace('\\', '/');
+        if (!targetPaths.contains(entryName) || entry.isDirectory()) {
+          continue;
+        }
+
+        File outFile = new File(dest, entryName);
+        if (!outFile.getParentFile().isDirectory() && !outFile.getParentFile().mkdirs()) {
+          throw new IOException("Failed to create directories for file " + outFile.getAbsolutePath());
+        }
+
+        try (OutputStream out = Files.newOutputStream(outFile.toPath())) {
+          IOUtils.copy(ais, out);
+        }
+      }
+    } catch (ArchiveException e) {
+      throw new IOException("Failed to read archive: " + archive, e);
+    }
+  }
+
 }

owlplug-client/src/main/java/com/owlplug/project/model/DawApplication.java

@@ -20,7 +20,8 @@
 
 public enum DawApplication {
   ABLETON("Ableton"),
-  REAPER("Reaper");
+  REAPER("Reaper"),
+  STUDIO_ONE("Studio One");
   private final String name;
 
   DawApplication(String name) {

owlplug-client/src/main/java/com/owlplug/project/tasks/ProjectSyncTask.java

@@ -25,6 +25,7 @@
 import com.owlplug.project.repositories.DawProjectRepository;
 import com.owlplug.project.tasks.discovery.ableton.AbletonProjectExplorer;
 import com.owlplug.project.tasks.discovery.reaper.ReaperProjectExplorer;
+import com.owlplug.project.tasks.discovery.studioone.StudioOneProjectExplorer;
 import java.io.File;
 import java.util.ArrayList;
 import java.util.List;
@@ -72,19 +73,32 @@ protected TaskResult start() throws Exception {
 
     this.setMaxProgress(filteredFiles.size());
 
+    // Create explorer instances once, outside the loop (they are stateless)
+    AbletonProjectExplorer abletonExplorer = new AbletonProjectExplorer();
+    ReaperProjectExplorer reaperExplorer = new ReaperProjectExplorer();
+    StudioOneProjectExplorer studioOneExplorer = new StudioOneProjectExplorer();
+
     for (File file : filteredFiles) {
       this.commitProgress(1);
-      AbletonProjectExplorer abletonExplorer = new AbletonProjectExplorer();
-      ReaperProjectExplorer reaperExplorer = new ReaperProjectExplorer();
 
       if (abletonExplorer.canExploreFile(file)) {
         this.updateMessage("Analyzing Ableton file: " + file.getAbsolutePath());
         DawProject project = abletonExplorer.explore(file);
-        projectRepository.save(project);
+        if (project != null) {
+          projectRepository.save(project);
+        }
       } else if (reaperExplorer.canExploreFile(file)) {
         this.updateMessage("Analyzing Reaper file: " + file.getAbsolutePath());
         DawProject project = reaperExplorer.explore(file);
-        projectRepository.save(project);
+        if (project != null) {
+          projectRepository.save(project);
+        }
+      } else if (studioOneExplorer.canExploreFile(file)) {
+        this.updateMessage("Analyzing Studio One file: " + file.getAbsolutePath());
+        DawProject project = studioOneExplorer.explore(file);
+        if (project != null) {
+          projectRepository.save(project);
+        }
       }
     }
 

owlplug-client/src/main/java/com/owlplug/project/tasks/discovery/studioone/StudioOneAudioMixerPluginCollector.java

@@ -0,0 +1,103 @@
+/* OwlPlug
+ * Copyright (C) 2021 Arthur <dropsnorz@gmail.com>
+ *
+ * This file is part of OwlPlug.
+ *
+ * OwlPlug is free software: you can redistribute it and/or modify
+ * it under the terms of the GNU General Public License version 3
+ * as published by the Free Software Foundation.
+ *
+ * OwlPlug is distributed in the hope that it will be useful,
+ * but WITHOUT ANY WARRANTY; without even the implied warranty of
+ * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ * GNU General Public License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with OwlPlug.  If not, see <https://www.gnu.org/licenses/>.
+ */
+
+package com.owlplug.project.tasks.discovery.studioone;
+
+import com.owlplug.core.utils.PluginUtils;
+import com.owlplug.plugin.model.PluginFormat;
+import com.owlplug.project.model.DawPlugin;
+import java.util.ArrayList;
+import java.util.List;
+import javax.xml.xpath.XPath;
+import javax.xml.xpath.XPathConstants;
+import javax.xml.xpath.XPathExpressionException;
+import javax.xml.xpath.XPathFactory;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
+import org.w3c.dom.Document;
+import org.w3c.dom.Element;
+import org.w3c.dom.Node;
+import org.w3c.dom.NodeList;
+
+public class StudioOneAudioMixerPluginCollector {
+
+  private final Logger log = LoggerFactory.getLogger(this.getClass());
+
+  private Document document;
+
+  public StudioOneAudioMixerPluginCollector(Document document) {
+    this.document = document;
+  }
+
+  public List<DawPlugin> collectPlugins() {
+
+    ArrayList<DawPlugin> plugins = new ArrayList<>();
+
+    XPath xpath = XPathFactory.newInstance().newXPath();
+    try {
+      // Find all FX nodes in the document (all Inserts / channel groups)
+      NodeList fxNodes = (NodeList) xpath
+          .compile("//Attributes[starts-with(@name, 'FX')]")
+          .evaluate(document, XPathConstants.NODESET);
+
+      for (int i = 0; i < fxNodes.getLength(); i++) {
+        Node node = fxNodes.item(i);
+        if (node instanceof Element element) {
+          // Filter out empty FX slots by checking for deviceData or ghostData children
+          StudioOneDomUtils.DeviceDataAndGhostData data = StudioOneDomUtils.findDeviceDataAndGhostData(element);
+          if (data.getDeviceData() == null && data.getGhostData() == null) {
+            continue; // Skip empty FX slots
+          }
+          
+          DawPlugin plugin = readPluginElement(element);
+          if (plugin != null) {
+            plugins.add(plugin);
+          }
+        }
+      }
+
+    } catch (XPathExpressionException e) {
+      log.error("Error extracting plugins from audio mixer", e);
+    }
+
+    return plugins;
+  }
+
+  private DawPlugin readPluginElement(Element pluginElement) {
+    String pluginName = StudioOneDomUtils.extractPluginName(pluginElement);
+    if (pluginName == null || pluginName.isEmpty()) {
+      return null;
+    }
+
+    PluginFormat format = StudioOneDomUtils.extractPluginFormat(pluginElement);
+    if (format == null) {
+      return null;
+    }
+
+    // Normalize the plugin name (remove platform suffixes like x64, x32, etc.)
+    // This ensures cleaner data in the database and simplifies later queries
+    String normalizedName = PluginUtils.absoluteName(pluginName);
+
+    DawPlugin plugin = new DawPlugin();
+    plugin.setName(normalizedName);
+    plugin.setFormat(format);
+    return plugin;
+  }
+
+}
+