Workflows and Tuning Guide
This guide focuses on repeatable workflows for configuring, printing, and validating the parametric cable box.
1) Quick Start Workflow
Section titled “1) Quick Start Workflow”Install BOSL2 first, or use the standalone bundle. The README has the install commands. Without BOSL2 the model stops with a message that says so.
- Open
cable-box-parametric.scadin OpenSCAD. - Open the Customizer from the
Windowmenu. - Configure dimensions in sections:
Overall,Box,Post,Lid, andOpenings. - Press
F6(full render). - Export STL for the current
Part_To_Rendervalue. The default isBox Only, so a first export gives you the box and no lid. - Set
Part_To_RendertoLid Onlyand export again, so you have both parts.
Starting from a preset instead of the defaults
Section titled “Starting from a preset instead of the defaults”cable-box-parametric.json sits beside the model and carries all nine presets,
so the Customizer’s preset dropdown lists them as soon as the model is open.
Pick the closest one and adjust from there rather than starting from scratch.
From the command line:
openscad -o out.stl cable-box-parametric.scad \ -p cable-box-parametric.json -P desk-compactThis is OpenSCAD’s native parameter-set format, so a set saved from the Customizer can be loaded straight back in, or sent to someone else, or attached to a bug report.
2) Dimensional Planning Workflow
Section titled “2) Dimensional Planning Workflow”Before changing parameters, measure:
- Largest cable connector width and height.
- Cable bend radius requirement near wall openings.
- Power brick footprint (if stored inside).
- Mounting/placement envelope on desk, shelf, or wall.
Translate measurements:
Box_WidthandBox_Depthfrom footprint plus clearance.Box_Heightfrom tallest interior object plus routing margin.All_Opening_Widthfrom thickest cable/connector dimension plus slack.All_Opening_Heightfrom number of cables per wall and routing spread.
3) Lid Fit Calibration Workflow
Section titled “3) Lid Fit Calibration Workflow”Objective
Section titled “Objective”Achieve a consistent, repeatable friction fit across your printer/material profile.
- Start with the default
Lid_Lip_Gap=0.15, a clearance on each side, and chooseLid_Style(SkirtorPlug) before you tune it. - Print a fit test box, or a draft pair, at final layer height and wall count.
- Test fit after cooling to room temperature.
- If too tight, increase by
0.05. - If too loose, decrease by
0.05. - Re-test until desired fit is reached.
- Record your final value per filament type.
Typical ranges
Section titled “Typical ranges”- PLA:
0.10to0.20 - PETG:
0.15to0.30 - ABS/ASA:
0.20to0.35
Use these as starting points only. They are not measured, and since 2.0.0 the value is per side rather than a total.
4) Side Opening Workflow
Section titled “4) Side Opening Workflow”Baseline pattern
Section titled “Baseline pattern”- Set global values:
All_Opening_Width,All_Opening_Height. - Enable walls using
Opening_On_*toggles. - Use
All_Openings_RightandAll_Openings_Upfor global shifts.
Per-side refinement
Section titled “Per-side refinement”- Set side override width/height (
Override_Opening_*) only when needed. - Use side-local offsets (
Move_Opening_*) for asymmetry. - Keep overrides at
0when global values are sufficient.
Validation checklist
Section titled “Validation checklist”- Confirm openings do not intersect rounded corners too aggressively.
- Verify
All_Opening_Heightis above0and at mostBox_Height, which the model asserts while any side opening is on. Width may be larger or smaller than height. - Verify opening placement does not conflict with stabilizer zones unless intended.
5) Stabilizer Workflow
Section titled “5) Stabilizer Workflow”When to enable
Section titled “When to enable”Use stabilizers when:
- Box walls are tall/thin.
- Internal loads are non-trivial.
- Opening cutouts remove too much wall stiffness.
Configuration sequence
Section titled “Configuration sequence”- Enable
Enable_Stabilizers=true. - Set geometry:
Stabilizer_Width,Stabilizer_Depth,Stabilizer_Height. - Configure front/back count and alignment.
- Configure left/right count and alignment.
- Enable opening avoidance toggles for affected walls.
Practical tuning
Section titled “Practical tuning”- Increase count before increasing depth for less interior intrusion.
- Keep depth moderate if routing many cables internally.
- Use
Distributedwith margins to avoid corner crowding.
6) Bottom Openings Workflow
Section titled “6) Bottom Openings Workflow”Strategy
Section titled “Strategy”Define geometry first, then placement.
- Set
Enable_Bottom_Openings=true. - Set geometry: width, depth, orientation, corner radius.
- Choose arrangement axis (
Bottom_Opening_Axis). - Choose primary/secondary alignments.
- Set spacing (
0for auto, or explicit value). - Apply margins for
Start,End, orCustommodes.
Post interaction
Section titled “Post interaction”If center post is enabled and Bottom_Opening_Avoid_Post=true, openings are split around the post clearance region. This overrides centered behavior for post-safe placement.
7) Slicing Workflow (Small Print Beds)
Section titled “7) Slicing Workflow (Small Print Beds)”Use case
Section titled “Use case”Enable slicing when full box/lid dimensions exceed your print bed width.
- Set
Enable_Slicing=true. - Set
Slice_Countto fit your bed dimensions. - Keep
Slice_Piece_To_Render=0to preview all slices. - Switch
Slice_Piece_To_Renderto each index and export STLs one at a time. - Print and test one mating seam before full production.
Clip tuning
Section titled “Clip tuning”- Tight assembly: increase
Clip_Toleranceby0.05. - Loose assembly: decrease
Clip_Toleranceby0.05. - Weak seam: increase
Clips_Per_EdgeorClip_Tab_Width. - Pieces slide vertically: keep
Seam_Tooth_Depthabove0, so the wall teeth lock them level.Clip_Tolerancealso sets the teeth’s clearance.
8) Printing Baseline
Section titled “8) Printing Baseline”Suggested starting profile (FDM)
Section titled “Suggested starting profile (FDM)”- Nozzle:
0.4 - Layer height:
0.2 - Perimeters/Walls:
3+ - Infill:
15%to25% - Top/Bottom layers:
4+
Orientation
Section titled “Orientation”- Box: open side up, as exported.
- Lid: print it as exported. The Printing guide explains which face lands on the bed.
- Sliced parts: print each piece as exported, so the seam faces stay vertical and the clips keep their designed dimensions.
9) CI Smoke Workflow
Section titled “9) CI Smoke Workflow”GitHub Actions
Section titled “GitHub Actions”- Workflow file:
.github/workflows/scad-smoke.yml - Trigger: push affecting
.scadfiles or manual dispatch - Runs OpenSCAD smoke renders on Ubuntu
- Windows: run
scripts/scad-smoke.ps1 - Linux/macOS: run
bash scripts/scad-smoke.sh - If needed on Bash environments, set
OPENSCAD_BINto your OpenSCAD executable path.
Smoke checks include:
- Baseline render
- Lid-only render
- Slicing preview render
- Expected fail case (
Slice_Piece_To_Renderout of range while slicing is enabled)
10) Troubleshooting Matrix
Section titled “10) Troubleshooting Matrix”| Symptom | Likely cause | Action |
|---|---|---|
| Lid too tight | Lid_Lip_Gap too low |
Increase by 0.05 and re-test. |
| Lid too loose | Lid_Lip_Gap too high |
Decrease by 0.05 and re-test. |
| Side openings misaligned | Global + local offsets stacking | Reset one offset layer, then reapply intentionally. |
| Stabilizers intersect opening area | Avoid toggles disabled or margins too small | Enable avoid toggles and/or increase margins. |
| Floor openings collide with post | Post avoid disabled | Set Bottom_Opening_Avoid_Post=true. |
| Slice clips too hard to join | Clip_Tolerance too low |
Increase tolerance incrementally. |
| Slice clips sloppy | Clip_Tolerance too high |
Reduce tolerance and reprint seam test. |
11) Documentation and Contribution Workflow
Section titled “11) Documentation and Contribution Workflow”When you add or change parameters:
- Update
cable-box-parametric.scadcomments. - Update
docs/PARAMETER_REFERENCE.md. - Update
docs/FAQ.mdfor new troubleshooting cases. - Update
README.mdif user workflow changes. - If sharing user-generated builds or forks, place them in
community/.
Do not hand-add files to library/. Everything there is generated: add an entry
to PRESETS in scripts/build_library.py and rerun it, which regenerates that
preset’s config.json, STLs, GLB previews, renders and notes, plus
library/README.md, the machine-readable library/index.json, and the merged
cable-box-parametric.json. Hand-edited files there are overwritten on the next
build, and the point of generating them is that a preset cannot drift from the
model.
library/index.json is what the docs site’s preset browser reads. It records
each preset’s overrides and printed envelope, and the model’s full parameter
defaults once at the top, so the effective parameter set is the defaults with
the overrides applied. It carries a schema number; bump INDEX_SCHEMA in
scripts/build_library.py when its shape changes incompatibly, and the site
refuses a version it does not know rather than rendering it wrong.
The GLB previews need trimesh (pip install trimesh).
It is optional: without it the conversion is skipped with a note and everything
else builds normally. Skip it with --no-glb.
The conversion canonicalises each mesh before writing it. OpenSCAD emits the same geometry in a different facet order on every run, so a straight conversion produced a different GLB each rebuild and dirtied 27 tracked binaries that had not changed. Sorting vertices and faces into one defined order removes that exactly, which is why an unchanged model reconverts to byte-identical files.
It then rotates the mesh from Z-up into glTF’s Y-up convention. OpenSCAD models the printed object Z-up, sitting on the bed at z=0, and trimesh writes vertices through unchanged, so without the rotation every preview lies on its back in a viewer. The STLs are unaffected and stay Z-up, which is what a slicer wants; the rotation exists only in the GLB.