Maintained by PATCoder97, based on the original MIT project by Mastershort – draw your home right inside Home Assistant and control it in a neon 3D view: lights glow in their colours, blinds move, doors and windows open, cameras watch, and the TV shows what is playing. No external tools, no cloud, made for wall tablets.
 |
Plan editor in Home Assistant – floors, rooms as rectangles or free shapes, automatic walls and free-standing partitions, doors, windows, garage doors, stairs and floor openings, outdoor areas and a roof. The 3D view runs next to the plan while you draw. |
 |
Live 3D view – tap a lamp to switch it, swipe to dim, long press for colours; blinds follow their position, windows tilt and open, doors swing. A room panel lists everything of the room's area. |
 |
Furniture and lamps – 40 built-in models plus furniture packs. Lamps light their room in their own colour, TVs, washing machines and radiators glow while they run. |
 |
Cameras – mounted on walls or ceilings with their field of view on the floor, red while they see motion; a tap shows the snapshot. |
 |
Wall tablet ready – warnings for smoke, gas, water, alarm and windows open in the rain, a kiosk mode with idle return and night dimming, scene buttons, and a Tablet quality level for Fire tablets. |
 |
Dashboard card – custom:neonplan3d-card with a visual editor, loaded automatically. |
Also included: parking spots with vehicles that appear while a car is home, a heatmap for temperature, humidity and CO₂, sunlight through the windows from sun.sun, three looks (Neon, Blueprint, Day), a search, restore points, and a full backup of plan, pictures and packs.
The integration and everything above are free and open source (MIT). In this fork, the six add-ons whose implementation is bundled with the frontend — Camera cockpit, Weather outside, Live screens, Energy Pro, Sound & Cinema and Car Pro — are enabled by default. They do not require a feature pack.
Optional third-party content from the original author is sold at mastershort.de and installs from the Extensions tab:
- Furniture packs – rooms (living, kitchen, bedroom, bath), areas (kids, office, garden, garage, fitness, smart home), vehicles, stairs & railings.
Bought packs are signed for your installation and update by themselves once a day. Everything installed keeps working without the shop.
-
Click the button above, or in HACS: ⋮ → Custom repositories → add
https://github.com/PATCoder97/neonplan3das Integration. -
Install NeonPlan 3D and restart Home Assistant.
-
Add the integration:
or Settings → Devices & services → Add integration → NeonPlan 3D.
-
Open NeonPlan 3D in the sidebar, switch to Editor and draw your first floor.
Copy custom_components/neonplan3d into config/custom_components/ and restart Home Assistant.
Requires Home Assistant 2025.1 or newer.
All options can be set in the card's visual editor; in YAML:
type: custom:neonplan3d-card
floor: floor_ab12cd34 # optional: show a single floor (id from the editor)
height: 420 # optional: height in pixels
fill: false # optional: fill the screen below the dashboard header instead of a height
walls: auto # optional: auto | cut
explode: true # optional: pull floors apart in the house view
floor_stack: dim # optional: floors below an opened floor: dim | stacked | single
quality: auto # optional: auto | low | high
theme: neon # optional: neon | blueprint | day
markers: important # optional: none | important | all
heatmap: none # optional: none | temperature | humidity | co2
room_panel: true # optional: tapping a room opens its details
room_names: true # optional: room names in 3D
controls: true # optional: switches in the card, or a list of walls, floors, temperature, humidity, co2
floor_thumbs: true # optional: floor pictures to switch floors
fullscreen_button: false
stats: false # optional: performance display
alerts: true # optional: smoke, gas, CO, water, alarm and windows open in the rain pulse
alert_jump: false # optional: jump to the room of a new warning
scenes: true # optional: scene and script buttons of the selected room
motion_trail: false # optional: motion of the last 30 minutes (Pro: camera cockpit)
weather: true # optional: weather outside (Pro: weather)
weather_entity: weather.home # optional: which weather entity (default: as set in the plan)
idle_return: 0 # optional: kiosk – seconds without a touch until the start view returns
night: "off" # optional: kiosk – dim at night: off | sun | "22:00-06:00"
idle_orbit: false # optional: kiosk – slow camera turn after the idle returnNeonPlan 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).
cd frontend
npm install
npm test # pure logic
npm run typecheck
npm run build # writes the bundles to custom_components/neonplan3d/frontend (committed)
npm run screenshot # renders preview/index.html (invented demo data) with a local Chrome or Edge- Preview without Home Assistant: open
preview/index.htmlthrough any local web server. - Deploy to a test instance: create
deploy.local.jsonwith{"target": "<config>/custom_components/neonplan3d"}and runnpm run deployinfrontend/. - Python tests run in CI with
pytest-homeassistant-custom-component. - Furniture pack format: docs/packs.md (German).
- Ideas and voting: Discussions → Ideas – vote with 👍 on what you want most.
- Questions: Discussions → Q&A.
- Bugs: open an issue.
- What changed: CHANGELOG.
MIT – see LICENSE. The original copyright notice is preserved as required by the licence. Furniture, images and other content distributed separately in paid packs are not part of this repository.
This fork is maintained for PATCoder97's own Home Assistant customisations. The original project and separately distributed paid pack content remain owned and operated by Mastershort. Upstream changes can be followed at Mastershort/neonplan3d.