Home
Cindr3D is a browser-based CAD, slicing, and printer-control workspace for makers and self-hosted workshops. It combines design tools, print preparation, multi-printer monitoring, and local AI-assisted workflows in one web app.
Use this wiki as the practical handbook for setting up, running, and extending the project.
| Goal | Start here | Then read |
|---|---|---|
| Run the app locally | Getting Started | Development and Testing, Self Hosting and Updates |
| Learn the workflow | Operator Runbooks | Guided Tutorials, Feature Overview |
| Model a part | Sketching and Dimensions | CAD Features and Timeline, Drawing and Export Workflows |
| Repair/import geometry | Mesh Repair and Imports | CAD and Modeling, Slicing and Print Preview |
| Prepare a print | Prepare Object Walkthrough | Prepare Profiles and Printer Creation, Slicer Settings Reference |
| Inspect G-code | G-code Preview Simulation and Breakpoints | Slicing and Print Preview, Mid-print Object Cancellation |
| Add a printer | Printer Connection Setup | USB Connection (Web Serial), Camera Setup |
| Operate a printer | Printer Workflows | Dashboard Layout Editing, Printer Interface Gallery |
| Run multiple printers | Print Farm Intelligence | Filament Profiles, Camera Setup |
| Tune print quality | Calibration Workflows | Print Tuning and Utilities, Slicer Settings Reference |
- Getting Started - install dependencies, run the app, and build production assets.
- Operator Runbooks - practical checklists for first run, CAD, printer setup, camera, slicing, calibration, dashboards, queues, and backups.
- Guided Tutorials - first-win workflows for CAD, calibration, pressure advance, and object cancellation.
- Feature Overview - understand the Design, Prepare, 3D Printer, and AI workspaces.
- Printer Workflows - connect printers, monitor jobs, use cameras, and manage firmware-specific features.
- Printer Connection Setup - firmware, network, USB, presets, testing, and reconnect setup.
- USB Connection (Web Serial) - browser serial requirements, baud rate, diagnostics, and limitations.
- Camera Setup - network, browser USB, server USB, stream testing, dashboard previews, and troubleshooting.
- AI Assistant and MCP - pair local AI clients with Cindr3D's localhost MCP server.
- Self Hosting and Updates - serve Cindr3D from a static host or Orange Pi and use the optional updater.
- Development and Testing - project layout, useful scripts, checks, and GitNexus guidance.
- Contributing and Security - contribution expectations and security reporting notes.
- CAD and Modeling - sketching, features, configurations, drawings, mesh repair, and exports.
- Design Box Walkthrough - cropped screenshot tour of a sketched and extruded box object in the Design workspace.
- Sketching and Dimensions - sketch planes, draw tools, constraints, dimensions, and palette controls.
- CAD Features and Timeline - create/modify features, construction geometry, components, and editable history.
- Drawing and Export Workflows - generated drawing views, SVG/DXF/PDF output, model imports, and exports.
- Mesh Repair and Imports - mesh diagnostics, duplicate vertices, normals, non-manifold geometry, and repair-before-slicing flow.
- Slicing and Print Preview - plate setup, profiles, G-code preview, object labels, and calibration.
- Slicer Settings Reference - layer height, walls, infill, speed, supports, adhesion, seams, and tuning guidance.
- Calibration Workflows - first layer, temperature, flow, retraction, pressure advance, input shaper, dimensions, and volumetric speed.
- Integrations and Automation - webhooks, chat notifications, MQTT, Home Assistant, enclosure, and safety automation.
- Release and Roadmap - version notes, release assets, shipped phases, and upcoming work.
- Troubleshooting - common setup, build, hosting, printer, and AI/MCP issues.
- In-App Help Reference - wiki mirror of the app's Help topics, using screenshots and notes from the built-in guide.
- Visual Interface Tour - screenshot-led tour of the landing page and main workspaces.
- Printer Interface Gallery - focused screenshots of the connected printer dashboard, status, macros, analytics, and bed height map.
- Print Farm Intelligence - smart queues, all-camera grid, A/B comparison, spool inventory, and layer gallery.
- Filament Profiles - material profile fields, defaults, and printer/profile relationships.
- Mid-print Object Cancellation - supported firmware, object labels, dashboard cancel surfaces, and manual fallbacks.
- Print Tuning and Utilities - input shaper, pressure advance, power, spools, timelapse, and updates.
- Safety Limits - temperature caps, high-temperature warnings, thermal alerts, and emergency-stop guard rails.
- Files and Settings Bundles - design documents, settings bundles, backups, and per-printer/global scope.
- Notifications and Updates - bell alerts, update status, notification preferences, and site update flow.
- Keyboard Shortcuts - Design, Sketch, and universal keyboard bindings.
- Tips and Tricks - modeling, slicing, printer operation, and farm habits.
- Dashboard Layout Editing - screenshot walkthrough of editing dashboard cards, toggling hidden cards, and customizing the layout.
- Prepare Object Walkthrough - object-loaded Prepare workflow with cropped screenshots, printability checks, slicing preview, and G-code inspection.
- Prepare Profiles and Printer Creation - cropped screenshot walkthrough for profile buttons, adding a printer, and editing created printer settings.
- G-code Preview Simulation and Breakpoints - focused walkthrough of G-code panel lines, breakpoints, simulation playback, scrubbing, and section view.
| Topic | Detail |
|---|---|
| App type | Static React + TypeScript single-page app |
| Runtime | Browser, local dev server, or static self-hosted deployment |
| Main workflows | CAD design, slicing/preview, printer control, fleet operations |
| Supported printer ecosystems | Klipper, Duet/RRF, Marlin, Smoothie, grbl, Repetier, and generic HTTP/MQTT integrations |
| AI integration | Local MCP server plus BYOK chat panel |
| License | MIT |
- Repository: https://github.com/exzile/Cindr3D
- README: https://github.com/exzile/Cindr3D#readme
- Issues: https://github.com/exzile/Cindr3D/issues
- Releases: https://github.com/exzile/Cindr3D/releases