Skip to content

Minimal fork of OrcaSlicer focused on slicing only. Removes GUI and unused features. Supports STL/OBJ/3MF import, slicing, and layer data export for custom workflows and CLI usage. Ideal for lightweight integration and research.

Notifications You must be signed in to change notification settings

Vitalii81/OrcaSlicerMini

 
 

Repository files navigation

OrcaSlicer CLI

This is a command-line interface (CLI) project based on the OrcaSlicer slicing engine. It performs slicing of 3D models (STL, OBJ, STEP, 3MF) into layers and exports the result in binary and visual formats (OBJ/MTL, optional PNG).

Features

  • Supports STL, OBJ, STEP, 3MF input formats

  • Slices models using OrcaSlicer engine

  • Exports slicing layers to:

    • Binary .bin files (one per layer)
    • .obj + .mtl files with color-coded layers (for testing; disable in production)
    • Optional: preview PNG (for testing; currently commented out)
  • Parses and re-reads sliced binary data for verification

  • Automatically aligns model to Z=0

  • Simplified slicing configuration (no extrusion, no infill)

Requirements

Ensure all required dependencies are built first:

./BuildLinux.sh -dbc   # Build deps in Debug mode
./BuildLinux.sh -dc    # Build deps in Release mode

On a fresh Linux installation, you may also need to install minimal system packages: ./install_min_sys_deps.sh

Then build the application:

./BuildLinux.sh -s     # Build the orca-slicer CLI

Usage

Run with a model file and optional layer height:

./run.sh model.stl 0.2

Run built binary directly:

./bin/orca-slicer path/to/model.stl 0.2

Run built-in test with default cube:

./run.sh test

Show help:

./run.sh -h

Output

  • Creates a folder <model_name>/ next to input file

  • Stores:

    • Layer binary files: layer_0.bin, layer_1.bin, ...
    • Colorized OBJ + MTL: layers.obj, layers.mtl (test feature; disable in release)
    • (Optional) PNG preview image: layers.png (test feature; commented in code)

Notes

  • Build type (Debug/Release) must match between the IDE and the prebuilt dependencies:

    • If deps are built in Debug (./BuildLinux.sh -dbc), the IDE build must also use Debug
    • If deps are built in Release (./BuildLinux.sh -dc), the IDE build must also use Release
    • Mismatched build types will result in linker errors (e.g., missing debug symbols or duplicated symbols)
  • Uses stb_image_write for PNG export (currently commented out)

  • All output directories are created or cleaned automatically

  • Model is recentred vertically to rest on the build plate

Main Entry Point

See OrcaSlicer_cli.cpp for full implementation.

About

Minimal fork of OrcaSlicer focused on slicing only. Removes GUI and unused features. Supports STL/OBJ/3MF import, slicing, and layer data export for custom workflows and CLI usage. Ideal for lightweight integration and research.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • C++ 79.3%
  • C 16.8%
  • HTML 3.4%
  • CMake 0.2%
  • Roff 0.2%
  • QMake 0.1%