fernandotonon/QtMeshEditor

Validate, convert, and optimize 3D assets in CI. Scan for issues, convert 40+ formats, and more.

View on GitHub

Trust Signals

Scorecard Score
not yet scored
Maintenance Recency
Activelast commit Jul 11, 2026
License
MIT

Pinned Snippet

workflow.ymlSHA-pinned
uses: fernandotonon/qtmesheditor@fe0deff9275e3d7f2a6f23249dc94ff0a9528e89 # 3.20.0

tags can be moved; commit SHAs can't. why a SHA?

namedescriptionrequireddefault
commandSubcommand: scan, info, validate, convert, fix, anim, lod, pose, turntable, isometric, generate3d, mocapyes
input-fileDirectory or file to scan (relative to workspace). Defaults to . (workspace root).no.
output-fileOutput file path (for convert/fix/anim/pose)no
optionsAdditional CLI flags (e.g. --json, --fail-on warning, --resample 30)no
image-tagghcr.io/fernandotonon/qtmesh image tag. Pin to the same release as uses: ...@x.y.z so CLI matches the action (latest may lag or differ).nolatest
generate-badgesWhen command=scan, generate Shields endpoint badge JSON files from scan summary.nofalse
badge-output-dirDirectory to write generated badge JSON files (workspace-relative or absolute).no.qtmesh-badges
badge-label-prefixBadge label/prefix (default: qtmesh).noqtmesh
badge-base-urlPublic base URL hosting badge JSON files (used to expose ready-to-use badge URLs in outputs).no
qtmesh-tokenOptional. Sets QTMESH_TOKEN in the container for QtMesh Cloud (same effect as CLI --token). Combine with qtmesh-no-upload / qtmesh-strict-upload or pass extra flags via options.no
qtmesh-api-baseOptional. Sets QTMESH_API_BASE (override API host, e.g. for self-hosted).no
qtmesh-no-uploadWhen true and command=scan, append --no-upload (skip cloud POST even if QTMESH_TOKEN is set).nofalse
qtmesh-strict-uploadWhen true and command=scan, append --strict-upload (fail the job if cloud upload fails).nofalse
namedescription
resultCommand stdout (text or JSON depending on --json flag)
exit-codeExit code (0 = success, 1 = issues found for scan/validate)
badge-statusComputed scan status for generated badges: pass, warn, fail, or no-data.
badge-directoryDirectory where badge JSON files were generated.
badge-status-urlShields endpoint URL for status badge (requires badge-base-url).
badge-errors-urlShields endpoint URL for errors badge (requires badge-base-url).
badge-warnings-urlShields endpoint URL for warnings badge (requires badge-base-url).
badge-passed-urlShields endpoint URL for passed badge (requires badge-base-url).
badge-scanned-urlShields endpoint URL for scanned badge (requires badge-base-url).
badge-skipped-urlShields endpoint URL for skipped badge (requires badge-base-url).