{"id":21449536,"url":"https://github.com/jsconan/things","last_synced_at":"2026-02-03T03:37:41.198Z","repository":{"id":44416982,"uuid":"100498739","full_name":"jsconan/things","owner":"jsconan","description":"Some 3D printing purpose things","archived":false,"fork":false,"pushed_at":"2025-02-22T21:17:10.000Z","size":437,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-13T09:06:35.080Z","etag":null,"topics":["3d-printing","camelscad","matscad","openscad","things"],"latest_commit_sha":null,"homepage":null,"language":"OpenSCAD","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jsconan.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2017-08-16T14:32:51.000Z","updated_at":"2022-08-06T14:32:29.000Z","dependencies_parsed_at":"2025-06-13T09:04:48.333Z","dependency_job_id":"d9ba8bb8-a5d3-4fe1-b801-063cba62f7f6","html_url":"https://github.com/jsconan/things","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/jsconan/things","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsconan%2Fthings","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsconan%2Fthings/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsconan%2Fthings/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsconan%2Fthings/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jsconan","download_url":"https://codeload.github.com/jsconan/things/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jsconan%2Fthings/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":263478690,"owners_count":23473046,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["3d-printing","camelscad","matscad","openscad","things"],"created_at":"2024-11-23T03:21:21.494Z","updated_at":"2026-02-03T03:37:41.142Z","avatar_url":"https://github.com/jsconan.png","language":"OpenSCAD","funding_links":[],"categories":[],"sub_categories":[],"readme":"# things\n\nSome 3D printing purpose things\n\n\u003c!-- vscode-markdown-toc --\u003e\n\n-   [At a glance](#Ataglance)\n-   [Install and requirements](#Installandrequirements)\n    -   [OpenSCAD](#OpenSCAD)\n    -   [Source code](#Sourcecode)\n        -   [Download the zip file](#Downloadthezipfile)\n        -   [Get the code from the repository](#Getthecodefromtherepository)\n-   [Render the parts](#Rendertheparts)\n\n\u003c!-- vscode-markdown-toc-config\n\tnumbering=false\n\tautoSave=true\n\t/vscode-markdown-toc-config --\u003e\n\u003c!-- /vscode-markdown-toc --\u003e\n\n## \u003ca name='Ataglance'\u003e\u003c/a\u003eAt a glance\n\nThe project contains designs for various purposes. The parts are designed using a scripting language, processed by [OpenSCAD](https://openscad.org/about.html). There is no ready to use 3D model files in the source code. If you are interested in such files, please look at the [released versions](https://github.com/jsconan/things/releases) which contains 3D model files built with default parameters. However, if you want to customize these parts, tailoring them with your measures, you should rather download the source code and then tweak the configuration files before generating your own 3D model files.\n\n## \u003ca name='Installandrequirements'\u003e\u003c/a\u003eInstall and requirements\n\nTo properly use the project you first need to do some installations steps.\n\n### \u003ca name='OpenSCAD'\u003e\u003c/a\u003eOpenSCAD\n\nFirst of all you need [OpenSCAD](https://openscad.org/) to be installed. To do so, please go to the [OpenSCAD download page](https://openscad.org/downloads.html), an get the version suitable for your operating system.\n\n### \u003ca name='Sourcecode'\u003e\u003c/a\u003eSource code\n\nThe source code is hosted on a [Git](https://git-scm.com/) repository. To get it you can either download a [zip file](https://github.com/jsconan/things/archive/refs/heads/main.zip), or clone the repository locally.\n\nNote: the easiest way is to call the `init.sh` script, that will take care of this for you.\n\n#### \u003ca name='Downloadthezipfile'\u003e\u003c/a\u003eDownload the zip file\n\nThe source code can be downloaded from the [GitHub repository](https://github.com/jsconan/things).\n\nYou can download it as zip file from this [link](https://github.com/jsconan/things/archive/refs/heads/main.zip).\n\nAs the project is using a shared library, that is not supplied with the package, you will need to also download it.\n\nDownload the zip file from this [link](https://github.com/jsconan/camelSCAD/archive/refs/heads/main.zip).\n\nThen extract its content inside the folder `lib/camelSCAD`. Please make sure the folder directly contains the library and not an intermediate folder like `lib/camelSCAD/camelSCAD-master`. If this is the case, please move the content one folder up and delete the extra folder.\n\n#### \u003ca name='Getthecodefromtherepository'\u003e\u003c/a\u003eGet the code from the repository\n\nA git tool is needed if you intend to get the source code from the git repository. You can download one either from the [main git website](https://git-scm.com/downloads), or from [GitHub](https://docs.github.com/en/github-cli).\n\nOnce you have your git tool installed, open a console window, select a project folder (create it if needed), then run the following commands:\n\n```\ngit clone https://github.com/jsconan/things.git\ncd things\ngit submodule init\ngit submodule update\n```\n\nThe source code should have been downloaded, as well as the libraries.\n\nNote: you can also use a graphical interface tool. In this case, please make it can also install the submodules.\n\n## \u003ca name='Rendertheparts'\u003e\u003c/a\u003eRender the parts\n\nThe parts are all located into the `parts` folder. They can all be opened separately in [OpenSCAD](https://openscad.org/) and rendered.\n\nHowever, it is possible to render all parts in batch. The script `render.sh` takes care of this.\n\nThis is a command-line tool, which accept several parameters. By default, it will render the preset selected in the config.\n\nIt is possible to select another preset, as well as set a different number of cells for the containers.\n\nThe parameter `-h` make it show the help.\n\nRunning the command `render.sh -h` will show this message:\n\n```\nRenders OpenSCAD files\n  Usage:\n\t./render.sh [command] [-h|--help] [-o|--option value] files\n\n  -h,  --help         Show this help\n  -d   --dir          Select a particular parts directory to render\n  -f   --format       Set the output format\n  -p   --parallel     Set the number of parallel processes\n  -c   --clean        Clean up the output folder before rendering\n```\n\nThe STL files are rendered to the `dist` folder.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjsconan%2Fthings","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjsconan%2Fthings","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjsconan%2Fthings/lists"}