This SketchUp Ruby plugin allows users to export speaker positions from SketchUp models into CSV files, formatted for use with HOLOPHONIX spatial audio software.
It provides two export formats:
- AED (Azimuth / Elevation / Distance) using cylindrical coordinates
- XYZ using cartesian coordinates
-
Display the coordinates of selected objects
-
Export selected speaker positions to CSV (AED or XYZ format)
-
Apply custom offsets to position data
-
Support for optional Auto-Orientation flag
-
Compatible with:
- Groups
- Component Instances
- Edges or Faces (bounding box corner used)
Go to Extension → Extension Manager
Click Install Extension
Select the HOLOPHONIX_speaker_export.rbz file.
-
Copy the plugin file into your SketchUp Plugins folder:
~/Library/Application Support/SketchUp 20XX/SketchUp/Plugins/ -
Name the file
HOLOPHONIX_speaker_export.rb. -
Restart SketchUp.
Once installed, the plugin adds a "Plugins" menu with the following tools:
Shows the coordinates of the selected objects in a popup message.
Exports the selected objects using cylindrical coordinates. The exported CSV includes:
| Column | Description |
|---|---|
| IO | Speaker index |
| OSC Address | OSC-compatible speaker path |
| Name | Speaker name |
| Azim | Azimuth angle in degrees |
| Elev | Elevation angle in degrees |
| Dist | Distance in meters |
| Auto Orientation | User-defined flag (true/false) |
| Pan / Tilt | Reserved fields (default: 0) |
Coordinate values are converted from SketchUp's internal units (inches) to meters and adjusted using the user-defined offsets.
Exports the selected objects using cartesian coordinates. The exported CSV includes:
| Column | Description |
|---|---|
| IO | Speaker index |
| OSC Address | OSC-compatible speaker path |
| Name | Speaker name |
| X | Distance in meters |
| Y | Distance in meters |
| Z | Distance in meters |
| Auto Orientation | User-defined flag (true/false) |
| Pan / Tilt | Reserved fields (default: 0) |
On the chosen CSV table software, you can rename and re-index the speaker before importing in HOLOPHONIX. The index and OSC Names can not be changed in HOLOPHONIX. Names and positon can be edited in HOLOPHONIX.
Follow the documentation steps to import your speaker objets on HOLOPHONIX Documentation.
Before each export, the plugin will ask for:
- Offset X (in meters)
- Offset Y (in meters)
- Offset Z (in meters)
- AutoTilt (true/false)
These offsets are applied to reposition the origin of the local coordinate system to match your spatial audio setup.
- AED export is sorted by elevation (descending), azimuth, then distance.
- XYZ export is sorted by Z (descending), then X and Y.
The CSV file is saved to a location of your choice via a file picker dialog.
- Choose type of objects to exports between Speakers and Sources
- Set axis transformation Sketchup --> HOLOPHONIX
- Set global offset
- Set global rotation
- SketchUp 2022 or newer
- No external libraries or Ruby gems needed
HOLOPHONIX S.A.S
Copyright © 2024
Designed to support immersive audio workflows through spatialized loudspeaker export.