Home editing
You edit the home right in the app and in the web version: devices, furniture, walls, rooms, doors, floors. The edit goes to the Homer server and reaches all devices by itself.
Who can edit
| Level | What they can do |
|---|---|
| Guest | View the plan and walk around the home |
| Edits home | Edit the plan, arrangement and bindings. Doesn't hand out access |
| Support technician | Edits home for a session of 1 to 24 hours |
| Owner | Everything |
If someone else is already editing the home, the app says ““…” is editing the home now — wait until they finish”.
How to start
App. The button in the plan header “Arrange mode: move devices and items on the plan” or the Arrange mode item in the ⋮ menu. To leave — Finish arrange mode.
Web. The Edit button on the “Plan” tab, to leave — Done. The button is visible to editors and the owner. An editing panel appears under the header: save mode, ↶ Undo / ↷ Redo, Home: name, tariff, step, location…, Item sources and the Devices and items / Walls and rooms switch.
While editing, a tap on the plan doesn't switch lights, and “turn off all lights” is hidden: an accidentally switched-on light is the worst thing an editor can do.
The home was edited in two places
If the home was edited from two devices at once, a window with a choice appears. Take server version erases all local edits. Keep mine keeps them only on this device, and the question comes back at the next sync.
Draft and rollback
On the web, editing has three save modes:
| Mode | What happens |
|---|---|
| Save as a draft | Edits accumulate and go to the owner for review. Available to everyone except the owner |
| Apply now, roll back in 10 min | The edit shows right away. If nobody taps Keep within 10 minutes, the home reverts by itself |
| Apply now | A regular save |
You can add a note for the owner to the draft and send it with Send draft. The owner sees a bar ““Name” suggests an edit” and chooses Apply, Apply for 10 min review or Reject. Discuss sends a question to the home chat. Changes are highlighted only on the flat plan.
A draft can be created only on the web. In the app a draft can be opened and accepted or rejected. While a draft is open, the home itself can't be edited.
If the home was edited after the draft, the draft can only be rejected.
Devices
In arrange mode you drag devices with a finger or the mouse.
- To another room. While your finger drags the marker, the room is determined by the finger. The target room is highlighted until you let go. A light that moved leaves the groups of its old room.
- A whole group. A group tile carries all its lights along.
- Group members are edited by tapping the group tile or via “Group members and model” in the room card — there you can take a light from another room too, see Light groups. A light taken by another group in this room is visible but unavailable.
- An opening sensor — drag it to an opening, and it snaps to its middle and binds to it. Dragged away from openings — the binding is removed.
The selected device bar in the app: move arrows, height ▲▼ in steps of 10, 5 or 1 cm, marker size in 3D, Remove from plan. In 3D you change height by dragging the selected marker up or down. A light can be replaced with a relay or an outlet, and Replace entity changes the HA entity while keeping the place, name and groups.
A new light is placed from the room card: Place device. The full list of bindings is in Settings → Devices → Devices on the plan.
Walls and rooms
On the web — Edit → Walls and rooms. In the app — the Edit walls chip in arrange mode, only on the flat plan: in isometric your finger can't hit a wall.
| Tool | What for |
|---|---|
| Select | Select and drag a wall, room, opening |
| Room | Draw a new room |
| Extension | Add a part to a room; that's how L-shaped rooms are made |
| Door | A 90 cm opening |
| Window | A 120 cm window |
| Mirror | A mirror on a wall |
| Split | Divide a room with a wall top to bottom or left to right |
| Stairs | Stairs to another floor |
There are no separate walls in the home: a wall is the edge of a room. Drag a partition and both neighbouring rooms change size together, and the doors and windows on it follow. Snapping is in 5 cm steps.
On the web:
- Alt — move only this room's section of the wall;
- Shift — no snapping;
- Ctrl/⌘ + click or a selection box — select several walls, Esc — clear the selection;
- the wheel scrolls the plan, Ctrl/⌘ + wheel zooms, space or the middle button pans the view.
Properties
- Room: name, “Open air (terrace, yard)”, “Covered”, part sizes in centimeters, + Add part, Merge with neighbour…, Delete room.
- Opening: door, window or mirror, width, bottom and top in centimeters. An empty field means the default height. A sensor from a removed opening stays on the plan but is unbound.
- Stairs: straight, with a turn (L) or with a U-turn (U), direction of the first flight, railing, which floor it leads to, flight width, number of steps.
- Floor (when nothing is selected): wall height from 2 to 6 m and the roof — gable, hip, shed, flat or pyramid, with pitch, overhang, parapet and color.
An outer wall at the left or top edge can be moved “past zero”: the whole home shifts along with the other floors and the entry point.
What you can't do: a room smaller than 30 cm, an opening narrower than 20 cm, an opening on top of a neighbouring one, stairs narrower than 80 cm. The home model is rectangular — there are no slanted walls.
Yard
A yard and a terrace are rooms with the “Open air” flag. With the “Covered” flag they get a roof. A terrace has a 0.4 m parapet instead of a wall. A lawn and garden are drawn around the home.
Doors
Door leaves and swing arcs are shown if Doors in openings is on in Appearance. A door is ajar by 38° into the larger of the two rooms, an outside door — into the home. An opening wider than 1.45 m gets two leaves, wider than 1.9 m stays an arch.
Furniture and items
App: room card → Place an item. Web: room panel → + Add item. A new item appears in the middle of the room, then you drag it.
The picker has a search (“chair, lamp, vase…”) and categories: Furniture, Seating, Tables, Lighting, Appliances, Electronics, Decor, Plants, Containers, Misc.
| Source | What you need |
|---|---|
| Poly Haven | Nothing. Everything is free, CC0 license |
| Sketchfab | A personal key to download, see Catalog keys. Only CC0 and CC-BY models up to 250 thousand triangles |
| Own .glb | A single .glb file up to 250 thousand triangles. A text .gltf won't do: it refers to files next to it |
The chosen model goes to the home's asset storage and reaches all devices. In the app both catalogs are in one list, on the web you switch the source. A new item shows up in the walk right away, without restarting the app.
Item bar
| App | Web | |
|---|---|---|
| Rotate | ↺ ↻ in steps of 15°, 5° or 1° | ±15°, ±45°, slider |
| Size | In steps of ×1.25, from 0.05 to 4 | Slider from 0.05 to 3, “×1” button |
| Height, move | ▲▼ and arrows | Dragging |
| Front | front ↻ | Model front ±45° |
| Device | Link to a device | Link / Unlink, glow “match the light”, “no glow” or a custom color |
| Remove | Remove from plan | Remove item |
An item linked to a light glows and turns on together with it.
Items can be moved in 3D too: an item moved there is selected at its new place.
Undo won't bring back a removed item
In the app a removed item disappears from the room for good: undo can't bring it back, you can only place it again from the catalog.
Furniture front
Every model has a front — the side it faces the room with. On the plan it's shown with an arrow. For a bed the front is the foot end.
If the arrow points the wrong way, tap front ↻ (on the web — Model front). The arrow turns in 45° steps, and the item itself stays in place. The front is a property of the model file, not the item's rotation. A 1.75 m figure stands next to the item — handy for checking the size.
Finishes
In the room panel on the web — Floor and Walls, in the “Home exterior” block — Facade. Reset returns the default finish. Textures come from free catalogs. All the home's items and textures are collected in Where items come from.
Undo
| Undo | Redo | |
|---|---|---|
| App | “Undo last edit” | “Redo” |
| Web | Ctrl+Z | Ctrl+Shift+Z or Ctrl+Y |
The history is 50 steps, shared by items and walls. A group of items or walls is undone in one step. The history lives while editing is open — these are not home versions.
Enter from here
Walk menu → Enter from here saves the place and view direction as the entry point. From then on, everyone's walk starts here. The item is available only to those who can edit the home. To go back to the entry point — ⌂ To entry point.
Changes the home for everyone
“Enter from here” is a home edit, not a personal setting. Don't tap it just to remember a place: that's what Share location is for.
Files
App
Settings → Files → Home configuration.
| Button | What it does |
|---|---|
| Export | Plan, devices, groups, presets and display settings in one file home-config.json |
| With items | The same plan in a home.homer archive together with models and textures. Such a home comes up on another device without internet |
| Import | Accepts both formats and fully replaces the open home. Writes presets from the file to Home Assistant |
| Copy from storage | An archive with the files from the Homer server, including what a guest editor sent. Owner only |
To create a new home from a file instead of replacing the open one, there's Settings → Home → Homes → Home from file.
The file contains a token
A file from the app carries the home address and an access token, so the home comes up in one step. Such a file is a key to the home: whoever has it can turn on lights and open locks. Don't send it in a messenger or put it in a shared folder.
Web
The “Home” page → Home as file, owner only: Export, With items, Import… (.json, .homer, .homeplan, .zip), Copy from asset storage. A file from the browser has no Home Assistant address or token, and they aren't taken from someone else's file.
Web and app archives read each other. Old .homeplan files open too.
The 3D tab has Download home .glb — the home with furniture and textures for Blender and other 3D apps.
Reset to factory
Settings → Devices → Devices on the plan → Reset to factory. The whole plan — floors, rooms, devices, items and finishes — is replaced with the demo one, and the reset goes to all devices of the home. The old plan can be brought back only from an export or a copy.
Blender
You can edit the home geometry in Blender with the tools/blender/homer_blender.py add-on. Blender 3.6 or newer is needed.
- Edit → Preferences → Add-ons → Install… and pick the add-on file.
- File → Import → Homer: дом (.json, .homer).
- Edit. Rooms are flat rectangles, doors, windows and mirrors are bars on a wall, stairs are boxes, items and devices are empties with a bounding size. Walls are collected in the “Стены (предпросмотр)” (walls preview) collection, for viewing only. Object → Homer: перестроить стены (rebuild walls) updates them.
- File → Export → Homer: дом (.json, .homer).
- Import the file in the app or on the web.
On export, everything Blender doesn't have — bindings, groups, presets, finishes, items — is carried over from the source file. A rotated object lands in the home as its axis-aligned bounding box: there are no slanted walls here either. .homer is written only over the source .homer, otherwise save .json.
The add-on menus are in Russian only.
Home location
Settings → Home → Home location → On the map, on the web — Home: name, tariff, step, location… → Location on the map. A point on the map and the rotation to north. The sun in 3D and in the walk is calculated from the location. On the web you can also enter the location as numbers: latitude, longitude, north in degrees.