Generate standardized ISO metric thread profiles optimized for 3D printing in XML format.

The browser generator is in web/index.html and is deployed through GitHub Pages.

• Live URL: https://eckphi.github.io/CustomThreads/

• Local preview:

cd web
python3 -m http.server 8080

• Open http://localhost:8080
• Generate and download 3DPrintedMetricThreads.xml
• Use Copy Share Link to share a prefilled generator configuration via URL

The latest XML thread profiles are automatically generated and available as GitHub Releases:

👉 Download Latest Release

Simply download the 3DPrintedMetricThreads.xml file and follow the installation instructions below.

1. Download 3DPrintedMetricThreads.xml from the latest release
2. Save it to your Fusion 360 thread data directory:
   • Windows: %localappdata%\Autodesk\webdeploy\Production\<version>\Fusion\Server\Fusion\Configuration\ThreadData
   • macOS: ~/Library/Application Support/Autodesk/Webdeploy/production/<version>/Autodesk Fusion 360/Contents/Libraries/Applications/Fusion/Fusion/Server/Fusion/Configuration/ThreadData
3. Restart Fusion 360
4. When creating threads, select "3D-Printed Metric Threads V3" from the thread type dropdown

Note: You can automate this installation with the ThreadKeeper plugin, which reinstalls profiles automatically after each Fusion 360 update.

.
├── .github/workflows/          # CI/CD pipeline
│   ├── generate-xml-release.yml
│   └── deploy-pages.yml
├── src/customthreads/          # Python package (core logic)
│   ├── __init__.py
│   ├── models.py               # Thread model classes
│   ├── generator.py            # XML generation utilities
│   └── cli.py                  # Command-line interface
├── tests/                      # Test suite
│   └── test_main.py
├── web/                        # GitHub Pages generator app
├── pyproject.toml              # Poetry configuration
├── README.md
└── .gitignore

Install dependencies with Poetry:

poetry install

Run the thread generator:

poetry run python -m customthreads.cli

This creates 3DPrintedMetricThreads.xml with:

• Diameters: 8-50mm
• Pitches: 1.0mm to 6.0mm (0.5mm steps)
• Tolerance Classes: O.0, O.1, O.2, O.4, O.8

Edit src/customthreads/cli.py to customize parameters:

• Pitch range (pitch_start, pitch_end, pitch_step)
• Thread sizes (thread_sizes)
• Tolerance offsets (tolerance_offsets)
• Output filename (output_filename)
• Thread metadata (thread_name, unit, thread_angle, thread_form)

poetry run pytest -v

All 12 tests should pass ✓

from customthreads import generate_xml

# Generate custom thread profiles
generate_xml(
		output_filename="custom_threads.xml",
		thread_name="My Custom Threads",
		unit="mm",
		thread_angle=60.0,
		thread_form=8,
		pitch_start=1.0,
		pitch_end=6.0,
		pitch_step=0.5,
		thread_sizes=list(range(8, 51)),
		tolerance_offsets=[0.0, 0.1, 0.2, 0.4, 0.8],
)

This project uses GitHub Actions to automatically generate and publish thread profiles as releases.

Workflow File: .github/workflows/generate-xml-release.yml

Trigger Events:

• ✅ Every push to master branch
• ✅ Manual trigger via GitHub Actions UI (workflow_dispatch)

Pipeline Steps:

1. Set up Ubuntu environment with Python 3.11
2. Install dependencies using Poetry
3. Run test suite to verify code quality
4. Generate XML thread profiles
5. Create a GitHub Release with datetime-based version
6. Upload XML file as release artifact

• Format: v{YYYY}.{MM}.{DD}-{HHMMSS}-r{RUN_NUMBER} (UTC time + workflow run number)
• Examples:
  • v2026.03.29-100000-r5 = March 29, 2026 at 10:00:00 UTC, run 5
  • v2026.03.29-124530-r9 = March 29, 2026 at 12:45:30 UTC, run 9

• ✅ No committed XML files — generated automatically on every push
• ✅ Version history — easy to compare profiles across releases
• ✅ Quality assured — tests run before each release
• ✅ One-click downloads — users get latest profiles from Releases page

To switch to manual-only releases:

1. Edit .github/workflows/generate-xml-release.yml
2. Change the trigger to:

   on:
       workflow_dispatch:  # Manual trigger only

3. Commit and push
4. Releases can now be triggered manually from the Actions tab

These offset values from nominal dimensions allow fine-tuning for different printing conditions:

The web app is deployed by .github/workflows/deploy-pages.yml.

• Trigger: push to master when files under web change
• Source artifact: web
• Publish target: GitHub Pages environment

If Pages is not enabled yet in repository settings, enable it once and keep source as GitHub Actions.

See LICENSE file for details

• Fusion 360 Custom Threads Documentation
• ISO Metric Screw Thread (Wikipedia)
• ThreadKeeper - Fusion 360 Plugin