Skip to content

Releases: redchupa/floor3d-toolkit

v0.0.1 — Initial release

12 May 17:01

Choose a tag to compare

First public release of floor3d-toolkit.

What it does

Packages Sweet Home 3D output into a single texture-embedded .glb that
drops straight into Home Assistant's floor3d-card — no manual asset
juggling, no 14-file /config/www/floor3d/ directory.

CLI commands

  • pack (recommended) — takes Sweet Home 3D Export to Home Assistant
    output (home.obj + home.mtl + jpeg textures) and emits one
    texture-embedded GLB with emissive baseline. --show-light-fixtures
    reveals fixture boxes while you wire up entity-mapping.yaml.
  • convert — direct .sh3d → GLB + entity-mapping.yaml +
    card-config.yaml. Useful when ExportToHASS isn't available.
  • inspect — print walls/furniture/lights counts for a .sh3d.

Highlights

  • Bounding-box-aware isometric camera presets (iso / iso-far /
    iso-close / top / side).
  • Light presets (warm / warm-bright / cool / daylight / subtle).
  • Domain-aware type3d emission for media_player, fan, cover,
    switch, etc — colorcondition rows are pre-populated with the right
    states so the card no longer crashes on non on/off entities.
  • min_confidence filter so unconfirmed heuristic suggestions stay out of
    the final card config, killing the "Entity not found" crash class.
  • Token-based keyword matching (fixes the 'ac' ⊂ 'machine' false positive
    that misclassified washing machines as climate).
  • Explicit null opt-out support in entity-mapping.yaml.
  • Secret scanner script blocks family names / private IPs / API keys at
    commit time.

Install

```bash
pip install floor3d-toolkit
```

See the README for
the 5-minute walkthrough.

Stats

  • 20 pytest tests passing
  • ruff clean, secret scan clean