This repository provides a tool to automate the export of STL models from OpenSCAD using CSV or JSON files of parameters. It offers a simple and user-friendly solution for batch exporting models with different parameter sets and includes a graphical user interface (GUI) for ease of use. Inspired by:

18107/OpenSCAD-batch-export-stl
OutwardBuckle/OpenSCAD-Bulk-Export

• Batch export STL files with parameters defined in CSV or JSON files.
• Convert between CSV and JSON parameter files.
• Easy-to-use command-line interface and GUI.
• Handles boolean, numeric, and string parameter types correctly.
• Supports advanced selection options for parameter sets.
• Includes multiple example projects to get started.
• Tested and validated on a number of test cases.

For easy usage, simply click on the Releases section on the right-hand side of the GitHub page and download the appropriate binary for your operating system (e.g., .exe for Windows, or equivalent for macOS and Linux). Install and start using the tool right away!

• Python 3.6 or later.
• OpenSCAD installed and added to your system PATH.

1. Clone the repository:

   git clone https://github.com/CameronBrooks11/OpenSCAD-Batch-Exporter.git
   

   cd OpenSCAD-Batch-Exporter
   

2. Install the Python library:

   pip install .
   

3. Ensure OpenSCAD is installed and accessible from the command line. Add it to your PATH if necessary.

4. If you encounter the following warning:

   WARNING: The script openscad-export.exe is installed in 'C:\Users\<YourUserName>\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_<somenumbers>\LocalCache\local-packages\Python311\Scripts' which is not on PATH.
   Consider adding this directory to PATH or, if you prefer to suppress this warning, use --no-warn-script-location.
   

   You can resolve it by adding the directory returned by:

   python -m site --user-base
   

   Append the Scripts subdirectory of the output path to your system's PATH. For example:

   C:\Users\<YourUserName>\AppData\Local\Packages\PythonSoftwareFoundation.Python.3.11_<somenumbers>\LocalCache\local-packages\Python311\Scripts
   

5. To modify the tool, reinstall it after making changes:

   pip install --upgrade .
   

Once installed, the tool can be called from anywhere using the openscad-export command. The tool provides three primary modes:

1. Export STL Files
2. Convert CSV to JSON
3. Convert JSON to CSV

Launch the graphical interface for an intuitive way to configure and perform batch exports. Run the following command:

openscad-export gui

From the GUI, you can:

• Select your .scad file, parameter file (CSV or JSON), and output folder.
• Configure export settings like format, selection range, and sequential processing.
• Monitor progress and view logs of the operation.
• Convert between CSV and JSON parameter files.

Export STL files using either a CSV or JSON parameter file.

Command Structure:

openscad-export export <scad_file> <parameter_file> <output_folder> [--openscad_path PATH] [--export_format asciistl|binstl] [--select SELECTION]

Parameters:

• <scad_file>: Path to the OpenSCAD .scad file.
• <parameter_file>: Path to the CSV or JSON file containing parameters.
• <output_folder>: Directory where STL files will be saved.

Options:

• --openscad_path: Path to the OpenSCAD executable. Defaults to "openscad" assuming it is in PATH.
• --export_format: Export format, either asciistl or binstl. Defaults to binstl.
• --select SELECTION: Select specific parameter sets to export using indices and ranges. Format examples: '0-5', '1-3,7,10-12', '2,4'. Indices are zero-based.

Examples:

• Export with CSV:

  openscad-export export examples/simpleCube/simpleCube.scad examples/simpleCube/simpleCube.csv output
  

• Selective Export:

  Export parameter sets from index 0 to 5:

  openscad-export export examples/candleStand/candleStand.scad examples/candleStand/candleStand.csv output --select "0-5"
  

• Export from JSON:

  Convert CSV to JSON first:

  openscad-export csv2json examples/simpleCube/simpleCube.csv examples/simpleCube/simpleCube.json
  

  Then, export using the JSON file:

  openscad-export export examples/simpleCube/simpleCube.scad examples/simpleCube/simpleCube.json output
  

Convert a CSV parameter file to JSON format compatible with OpenSCAD's customizer.

Command Structure:

openscad-export csv2json <csv_file> <json_file>

Example:

openscad-export csv2json examples/candleStand/candleStand.csv examples/candleStand/candleStand.json

Convert a JSON parameter file back to CSV format.

Command Structure:

openscad-export json2csv <json_file> <csv_file>

Example:

openscad-export json2csv examples/sign/sign.json examples/sign/sign_converted.csv

• The CSV file should have a header row with parameter names.
• Each subsequent row defines a set of parameters for the OpenSCAD model.
• A column named exported_filename is required to specify the output filenames.

Example CSV file (simpleCube.csv):

The JSON file should follow the structure used by OpenSCAD's customizer profiles. It should contain a parameterSets object, where each key is the exported_filename and its value is a dictionary of parameters.

Example JSON file (simpleCube.json):

{
    "parameterSets": {
        "cube_small": {
            "width": "10",
            "height": "10",
            "depth": "10"
        },
        "cube_medium": {
            "width": "20",
            "height": "20",
            "depth": "20"
        },
        "cube_large": {
            "width": "30",
            "height": "30",
            "depth": "30"
        }
    },
    "fileFormatVersion": "1"
}

The OpenSCAD file must define a model that uses parameters from the parameter file. For example:

Example OpenSCAD file (simpleCube.scad):

module model() { cube([width, height, depth]); }

The examples/ directory contains multiple projects demonstrating how to use the exporter with different OpenSCAD models.

A basic example of a customizable cube with varying dimensions.

Files:

• examples/simpleCube/simpleCube.scad
• examples/simpleCube/simpleCube.csv
• examples/simpleCube/simpleCube.json

A more complex model featuring a candle stand with options for customization from the OpenSCAD Parametric Examples.

Files:

• examples/candleStand/candleStand.scad
• examples/candleStand/candleStand.csv
• examples/candleStand/candleStand.json

A customizable sign with adjustable message, size, and resolution parameters from the OpenSCAD Parametric Examples.

Files:

• examples/sign/sign.scad
• examples/sign/sign.csv
• examples/sign/sign.json

Contributions are welcome! Please open an issue or submit a pull request with improvements or suggestions.

This project is licensed under the AGPL v3 License. See the LICENSE file for details.