Skip to content

Getting Started

Prerequisites

  • Node.js 22 LTS — nodejs.org (the version used by CI; Node 24 currently leaves Playwright's local Vite server running after E2E tests on Windows)
  • ~30 MB free disk space for WASM artifacts

Installation

1. Clone

git clone https://github.com/Hiosdra/OrcaWeb.git
cd OrcaWeb

2. Install dependencies

npm install

3. Download WASM artifacts

The OrcaSlicer WASM files are not stored in the repository (served from a tagged GitHub Release to keep clone size small). Download them once with:

node scripts/download-wasm.mjs

This fetches two files into public/wasm/:

File Size Description
slicer.js ~210 KB Emscripten glue code
slicer.wasm ~29 MB Compiled OrcaSlicer v2.4.2 + OCCT (STEP engine)

Source: OrcaWeb GitHub Release wasm-v2.4.2 (self-built via orca-wasm/ pipeline).

4. Start dev server

npm run dev

Open http://localhost:5173.

First slice

  1. Model tab — drag & drop an STL file or click to browse
  2. Settings tab — choose printer, filament, quality preset; optionally import an OrcaSlicer .json profile
  3. Slice tab — click Slice model; wait ~50–500 ms depending on model complexity
  4. When complete, a Download G-code button appears next to a live G-code preview

Importing OrcaSlicer profiles

In the Settings tab, click Import OrcaSlicer profile (.json) and select any profile JSON from your desktop OrcaSlicer installation.

Profile files are typically found at:

%APPDATA%\OrcaSlicer\user\default\

~/Library/Application Support/OrcaSlicer/user/default/

~/.config/OrcaSlicer/user/default/

The folder contains three subdirectories: machine/, filament/, and process/. Any .json file from these directories can be imported.

→ Profile format reference