Skip to content

About

3D floor plan for Home Assistant: draw your home in the built-in editor (rooms, walls, doors, windows, furniture, roof) and see and control lights, covers, windows, climate, media, sensors and cameras live in a neon 3D view – as a sidebar panel and dashboard card.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

 
 

Repository files navigation

NeonPlan 3D

Spenden mit PayPal

by Mastershort – draw your home right inside Home Assistant and live in it as a neon 3D house: lights glow in their colours, blinds and curtains move, doors and windows open, cameras watch, the TV shows what is playing, energy flows through the walls – and you can simply talk to it. No external tools, no cloud, made for wall tablets – old Fire tablets included.

▶️ Try the online demo – in your browser, with invented demo data: turn the house, switch lights, open the editor. Nothing to install.

Open your Home Assistant instance and open the NeonPlan 3D repository inside HACS.

NeonPlan 3D: the house turns with its solar roof and energy cards, voice control opens the living room, the doorbell rings and the live director looks through the front door camera, then back to the whole house

📖 Manual: English · Deutsch (also here: manual.md, anleitung.md) 💬 Community: Discord – show your 3D home, ask, share ideas 🗺️ What comes next: Roadmap · What changed: Changelog


Highlights

  • 🎙️ Talk to your house (new, free) – tap the microphone: "Show the living room", "Where is the washing machine?", "Show the front door camera". Anything else ("turn on the hall light") goes to Home Assistant's Assist, and the answer shows as a bubble. Speech to text runs through your own Assist pipeline.
  • 🎬 Live director – the wall tablet shows by itself what happens: the doorbell rings and the view flies to the front door and looks through its camera; someone at a camera, the washer done, a warning. Every event is opt-in.
  • ⏪ Time travel – replay the last day or week in the house: lights, doors, motion, the robot's run.
  • 🚶 Walk through the house at eye level, with keys or a touch stick.
  • 🔋 Energy in the walls – solar, battery, grid and wallbox as glowing cables, holograms with day curves.
  • 📱 Runs on old wall tablets – a Tablet quality level, nothing is drawn while nothing changes, and the build refuses browser features old Fire WebViews lack.

What it does

Editor Plan editor in Home Assistant – floors, rooms as rectangles or free shapes, automatic walls and free-standing partitions, doors, windows, garage doors, stairs, floor openings, cellars with light wells, roofs with dormers, outdoor areas, pools, balconies and solar fields. The 3D view runs next to the plan while you draw. A wall view shows each wall from the front for exact placing.
Room Live 3D view – tap a lamp to switch it, swipe to dim, long press for colours, blinds and covers; doors swing, windows tilt, curtains and awnings run with their cover. A room panel lists everything of the room's Home Assistant area; gardens and terraces open like rooms too.
Voice control Voice control – tap the microphone and say "Show the living room", "Where is the washing machine?" or "Show the front door camera"; anything else goes to Home Assistant's Assist. New and growing – free for everyone.
Library Furniture and lamps – built-in models plus furniture packs. Lamps light their room in their own colour (and the floor below through a stairwell), TVs, washers and radiators glow while they run, robot vacuums drive their lanes, pets roam the house.
Camera Cameras – on walls or ceilings with their field of view, red while they see motion; snapshots, a camera wall and live streams.
Live director Live director (Camera Cockpit) – the doorbell rings and the wall tablet flies to the front door and looks through its camera; it also shows a camera that sees someone, a finished washer or a new warning, then goes back.
Time travel Time travel (Pro) – replay the last day or week: lights, doors, motion and the robot's run, with a timeline of events.
Walk Walk and wall view – walk through the house at eye level with keys or a touch stick; in the editor, each wall from the front to place furniture to the centimetre.
Warnings Made for the wall – warnings for smoke, gas, CO, water, alarm, a window open in the rain and power outages pulse in their room; kiosk mode with idle return, night dimming and a slow orbit; favourites and scene buttons.
Heatmap Values and heatmap – temperature, humidity and CO₂ per room, sunlight through the windows from sun.sun, the weather around the house.
Card Dashboard card – custom:neonplan3d-card with a visual editor, loaded automatically.

Coming from another program? The import page turns Sweet Home 3D, iPhone LiDAR scans (RoomPlan), CAD (DXF), Blender/SketchUp models (glTF, OBJ, STL), Floorplanner and Valetudo robot maps into a NeonPlan plan – in your browser. Or let an AI write it with this template (format).

Also included: parking spots with vehicles that appear while a car is home, waste bins and mailboxes, three looks (Neon, Blueprint, Day) with an accent colour, search, restore points, a full backup of plan, pictures and packs, and 18 languages.

Free, packs and Pro add-ons

The integration and everything above are free and open source (MIT). Safety (smoke, water, alarm, rain warning, power outage) is always free. Optional extras are sold once – no subscription – at mastershort.de and install from the Extensions tab:

  • Furniture packs – living room, kitchen, bedroom, bath, kids, office & gaming, garden & terrace, garage & workshop, fitness, smart home & tech, cinema & hi-fi, utility, architecture, stairs & railings, vehicles; free fun packs (pets, Halloween) with a customer account.

  • Pro add-ons

    Add-on What it brings
    Camera Cockpit Look through a camera, camera wall, motion trail, detection pins, the live director
    Weather outside Rain, snow, fog, clouds, lightning, sun and moon around the house
    Live screens App colours and artwork on TVs, pictures by rules, camera pictures on screens
    Energy Pro Energy flow in cables, device holograms, solar fields with their own yield
    Sound & Cinema Speakers that pulse with the music, now-playing cards, stations and playlists
    Car Pro Your car on its parking spot with charge, range, lock and climate
    Time travel Replay the last 24 hours or 7 days
    Household Pro (beta) Bins with pickup tags, post in the mailbox, thirsty plants, appliance time left

Bought packs are signed for your installation and update by themselves once a day. Everything installed keeps working without the shop.

Installation

HACS

Open your Home Assistant instance and open the NeonPlan 3D repository inside HACS.

  1. Click the button above, or in HACS: ⋮ → Custom repositories → add https://github.com/Mastershort/neonplan3d as Integration.

  2. Install NeonPlan 3D and restart Home Assistant.

  3. Add the integration:

    Open your Home Assistant instance and start setting up NeonPlan 3D.

    or Settings → Devices & services → Add integration → NeonPlan 3D.

  4. Open NeonPlan 3D in the sidebar, switch to Editor and draw your first floor – or import a plan.

Manual

Copy custom_components/neonplan3d into config/custom_components/ and restart Home Assistant.

Requires Home Assistant 2025.1 or newer.

Dashboard card

All options can be set in the card's visual editor. The most used ones in YAML:

type: custom:neonplan3d-card
floor: floor_ab12cd34   # show a single floor (id from the editor); room: opens a room
height: 420             # height in pixels, or fill: true for the whole screen
quality: auto           # auto | low | high – "auto" picks the tablet level on weak devices
theme: neon             # neon | blueprint | day, with accent: "#00e5ff"
walls: auto             # auto | cut
markers: important      # device symbols: none | important | all
heatmap: none           # none | temperature | humidity | co2
room_panel: true        # a tap on a room opens its panel
alerts: true            # smoke, gas, CO, water, alarm, windows in the rain, power outage
voice: false            # 🎙️ microphone button (voice control)
director: false         # 🎬 live director (Camera Cockpit)
roof: true              # false: show the house without its roof
idle_return: 0          # kiosk: seconds without a touch until the start view returns
night: "off"            # kiosk: dim at night – off | sun | "22:00-06:00"
idle_orbit: false       # kiosk: slow camera turn after the idle return

More: start_view, explode, floor_stack, controls, controls_hidden, floor_thumbs, buttons, energy, flows, holograms, weather, time_travel, household_card, scenes, walk, pets … – all described in the manual, chapter 8 The dashboard card.

Privacy

NeonPlan 3D stores the plan, its pictures and the packs in Home Assistant's .storage. It talks to the internet only when you enter a licence key in Extensions: then it asks mastershort.de once a day for updates of your packs, sending the key and an anonymous installation fingerprint (a hash). Voice control sends your speech only to your own Home Assistant's Assist pipeline, and the microphone is open only while you speak.

Ideas, questions and bugs

Development

cd frontend
npm install
npm test            # pure logic
npm run typecheck
npm run build       # writes the bundles to custom_components/neonplan3d/frontend (committed) and checks the size budgets
npm run screenshot  # renders preview/index.html (invented demo data) with a local Chrome or Edge
  • Preview without Home Assistant: open preview/index.html through any local web server.
  • Deploy to a test instance: create deploy.local.json with {"target": "<config>/custom_components/neonplan3d"} and run npm run deploy in frontend/.
  • Python tests run in CI with pytest-homeassistant-custom-component.
  • Furniture pack format: docs/packs.md (German).

Licence

MIT – see LICENSE. "NeonPlan 3D" is the name of the original project by Mastershort; furniture packs and Pro add-ons sold in the shop are not part of this repository.

Unterstützen / Support

NeonPlan 3D ist kostenlos. Wenn es dir gefällt, freue ich mich über einen Kaffee ☕ – oder schau dir die Möbel-Packs im Shop an: https://mastershort.de/neonplan3d/ NeonPlan 3D is free. If you like it, you can buy me a coffee or check out the furniture packs.

PayPal

About

3D floor plan for Home Assistant: draw your home in the built-in editor (rooms, walls, doors, windows, furniture, roof) and see and control lights, covers, windows, climate, media, sensors and cameras live in a neon 3D view – as a sidebar panel and dashboard card.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages