OpenSCAD-Generators/README.md

56 lines
5.1 KiB
Markdown

# OpenSCAD Generators
A curated public collection of editable parametric OpenSCAD generators, ready-to-slice STL examples, and matching digital renders.
> The images in this repository are digital OpenSCAD renders. They are not photographs of physical prints. Each project README states its validation and physical-test status.
## Generator gallery
<table>
<tr>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/cr80-card-holder/README.md"><img src="cr80-card-holder/images/default-flex-tabs.png" width="300" alt="CR80 / ID-1 Card Holder render"><br><strong>CR80 / ID-1 Card Holder</strong></a></td>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/cable-clips/README.md"><img src="cable-clips/images/small.png" width="300" alt="Adjustable Cable Clips render"><br><strong>Adjustable Cable Clips</strong></a></td>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/decorative-insects/README.md"><img src="decorative-insects/images/butterfly-relief.png" width="300" alt="Decorative Insects render"><br><strong>Decorative Insects</strong></a></td>
</tr>
<tr>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/parametric-box/README.md"><img src="parametric-box/images/inner-lip.png" width="300" alt="Parametric Box render"><br><strong>Parametric Box</strong></a></td>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/parametric-keyring/README.md"><img src="parametric-keyring/images/raised-text.png" width="300" alt="Parametric Keyring render"><br><strong>Parametric Keyring</strong></a></td>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/s-hook/README.md"><img src="s-hook/images/round.png" width="300" alt="Parametric S-Hook render"><br><strong>Parametric S-Hook</strong></a></td>
</tr>
<tr>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/storage-system/README.md"><img src="storage-system/images/standard-box.png" width="300" alt="Parametric Storage System render"><br><strong>Parametric Storage System</strong></a></td>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/tea-bag-dispenser/README.md"><img src="tea-bag-dispenser/images/front-pull.png" width="300" alt="Tea-Bag Dispenser render"><br><strong>Tea-Bag Dispenser</strong></a></td>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/text-generator/README.md"><img src="text-generator/images/standing-text.png" width="300" alt="3D Text Generator render"><br><strong>3D Text Generator</strong></a></td>
</tr>
<tr>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/universal-clock-dial/README.md"><img src="universal-clock-dial/images/round.png" width="300" alt="Universal Clock Dial render"><br><strong>Universal Clock Dial</strong></a></td>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/universal-sign/README.md"><img src="universal-sign/images/flat-plate.png" width="300" alt="Universal Sign Generator render"><br><strong>Universal Sign Generator</strong></a></td>
<td align="center"><a href="https://git.p20.dev/christian/OpenSCAD-Generators/src/branch/main/usb-stick-holder/README.md"><img src="usb-stick-holder/images/rectangular.png" width="300" alt="USB Stick Holder render"><br><strong>USB Stick Holder</strong></a></td>
</tr>
</table>
## Install OpenSCAD Nightly
These generators target a recent **OpenSCAD development snapshot / Nightly**. Download the appropriate snapshot from the official [OpenSCAD downloads page](https://openscad.org/downloads.html#snapshots).
Some text-based generators use the experimental `textmetrics` feature. Enable it in **Edit → Preferences → Features → textmetrics**, then restart or reopen the model if required.
## Use a generator
1. Clone or download this repository.
2. Open the generator `.scad` file in OpenSCAD Nightly.
3. Open **Window → Customizer**, change the parameters, and preview with **F5**.
4. Press **F6** for the final render and export STL from the **File** menu.
5. Slice the STL with a profile for your printer and material. Calibrate fit-sensitive parts before a full print.
Each project folder also contains curated STL examples under `stl-files/` and matching digital renders under `images/`.
## Validation and provenance
The public tree is generated from an explicit whitelist in the private canonical source repository. Every published SCAD file is rendered in isolation; every STL is checked for closed topology and bed bounds and is smoke-sliced with PrusaSlicer.
Generated from canonical source commit `ebd1af8362cf0ddeac0a0ebc117687832d43df27` using OpenSCAD Nightly. Public assets are updated in place rather than manually edited here.
## License
All SCAD sources, STL models, renders, and documentation in this repository are licensed under [Creative Commons Attribution-NonCommercial 4.0 International](LICENSE.md).