Add Walkthrough (CLI)

2026-02-14 17:29:13 -05:00
parent 44fd3ce754
commit 6e240c5e4c

52
Walkthrough-%28CLI%29.md Normal file

@@ -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!