diff --git a/Walkthrough-%28CLI%29.md b/Walkthrough-%28CLI%29.md new file mode 100644 index 0000000..6f3ef34 --- /dev/null +++ b/Walkthrough-%28CLI%29.md @@ -0,0 +1,52 @@ +# SVG to Nametag Converter Walkthrough +This guide explains how to use the convert_nametags.py script to generate 3D printable STL files from SVGs. + +## Overview +The script processes +.svg + files and generates three separate STL files for each nametag. This allows you to assign different filaments to each part in Bambu Studio: + +Black: The base/background (3mm thick). +White: The Name text (2mm thick). +Cyan: The Title/Logo (2mm thick). +The script also automatically scales every nametag to a width of 87.80mm. + +### Usage +1. Setup Environment +Ensure you are in the project directory. +`cd /your/path/here/svg2nametagRen` +Create a virtual environment (or venv) and switch to it +`python -m venv` +`source .venv/bin/activate` +Install depedencies +`pip install -r requirements.txt` + + +2. Run the Script +You can run the script on a single file or a whole directory. + +Process the entire drive: + + +`python3 convert_nametags.py "/media/unfunny/FREEDOM" --output-dir "/home/unfunny/Desktop/Nametags_STL" ` + +Output Structure +The script creates a folder for each nametag containing its three STL files: +``` +Output_Directory/ +├── Jordan/ +│ ├── Jordan_Black.stl +│ ├── Jordan_White.stl +│ └── Jordan_Cyan.stl +└── Staff Nametags_Data Set 30-01/ + ├── Staff Nametags_Data Set 30-01_Black.stl + ├── Staff Nametags_Data Set 30-01_White.stl + └── Staff Nametags_Data Set 30-01_Cyan.stl + ``` +Printing Instructions (Bambu Studio) +Open Bambu Studio. +Drag all three .stl files for a single nametag into the plate at the same time. +Bambu Studio will ask: "Load these files as a single object with multiple parts?" -> Select Yes. +Go to the Objects view (left panel). +Select each part and assign the correct filament color. +Slice and print! \ No newline at end of file