Your HousePanel screen should look something like this by default:
Before getting into how to customize things, lets first explore how to use HP to get the most out of it. Most of it will be obvious and intuitive, but a few hidden gems require explanation. For starters, you can browse different rooms by clicking on any tab at the top of the page. Notice that the room display changes INSTANTLY! This is because HP renders all pages in advance and organizes them into tabs. When you select a different tab you are just telling HP to show that tab that was previously created.
Turning Things On and Off
While on any page, you can click or tap on any thing tile to change its state. For example, clicking on “Laundry Room” will turn the light off if it is on, and will turn it on if it is off. If you click on a closed garage door, it will open. On dimmer tiles you change the intensity of the light by moving the slider. When you do this the light will turn on if it is off. Bulb type lights have a little round circle showing the current color setting. Clicking on this circle will open a color palette where you can select the color. To close the palette, click anywhere other than inside the palette.
Not all things support state changes from HP. Contacts, motion sensors, clocks, and blanks are examples of display only tiles so clicking on them will cause no action. However, some read only tiles report details when they are clicked. For example, clicking on the Dog Food Drawer tile will display a small window telling the user the last several times it was opened or closed. It also shows the battery status.
Other tiles that invoke actions include switch, bulbs, lights, dimmers, garage doors, mode, routines, valves, shm (SmartThings), hsm (Hubitat), thermostats, and music tiles. If you are using a computer, the cursor will change to a pointer when you hover over things that can be clicked to change state.
Some tiles such as thermostat and music tiles have multiple controls that can be individually controlled by clicking on them. For example, each thermostat has a heater and an AC control and each one has up and down arrows that can be clicked on to adjust the temperature setting. On music tiles, play, pause, skip, and stop can also be clicked on.
Music tiles have a special feature that uses the name of the song playing to find a suitable album art image. It does this by searching the Internet and retrieving the first image found matches album art styling. I have found this algorithm to be very accurate and reliable, but it is not foolproof, so sometimes the album art may not match. The tile to the right shows what this looks like for a song played by 3 Doors Down. In this example it returned the exact image shown on the cover of the Album / CD.
If you have the browser control panel open (F12 on Chrome), clicking on things will return status information to that screen. This is a great way to see if your panel is working properly.
Moving Tiles Around
One of the most exciting features of HousePanel is the ability to highly customize its look and feel. The first level of customization involves simply moving existing tiles around on a page. To do this, you need to enter edit mode using the Edit radio button on the bottom right corner of the screen. When you are in this mode, tiles can be moved around freely on the page by clicking and dragging them with your mouse or finger. Once a tile is moved, it changes from “fixed” mode to “absolute” mode. When in absolute mode it will be excluded from tile reordering explained later. All tiles in fixed mode will be shown next to each other in their defined order. Tiles in absolute mode will be shown wherever they are dragged to. If you want to return a tile in absolute mode back to fixed mode, drag it to the top of the page with the top border slight overlapping the title bar and release it. It will snap back into the order that it had previously.
While edit mode is fully supported on a tablet, I strongly recommend that you do edits on a PC and then deploy your edited configuration to your tablet by simply doing a Reload.
When in edit mode you can also rename pages, add pages, delete pages, add tiles using drag and drop from the library, delete tiles, and edit individual tiles in detail. When editing page names, please be advised that page names cannot contain spaces. You should also avoid the use of symbols in page names. Tile names can contain spaces and symbols but I recommend keeping things simple. Edit mode will look something like this:
The green dots on the page tabs are used to edit the page in the Tile Editor. The red dots are clicked on to delete a page. Similar green and red dots are shown on each tile for entering edit mode or to delete that tile. If you select a red dot to delete a tile or page, you will be prompted to confirm. Upon confirmation the tile will be removed from the room being displayed. If you select a green dot on a tile, the Tile Editor will launch. The blue dot will launch the Tile Customizer. Tile Editor and Tile Customizer are documented in later sections.
Changing Order of Rooms and Tiles
You can select Reorder mode to enable the reordering of tiles and rooms. The main difference of this mode is things are automatically snapped into place in this mode based on the order. Reorder mode only applies to tiles that are in “fixed” mode – that is, if a tile has been moved randomly in edit mode it will be in “absolute” mode and will not be impacted by the reorder command.
Reorder mode also allows room tabs to be moved to a different order. To do this, simply click and hold a tab and move it left or right to reorder your rooms. The new room location will be permanent on this server.
IMPORTANT!! You can mix edit and reorder mode, but reorder only applies to tiles that have not been moved to a random edit location.
Adding or Removing Things from Rooms
Deeper customization involves adding or removing things to your rooms. One way to do this is to use Edit mode described above. While in Edit mode a catalog will display on the right hand side. You can drag things from this catalog and drop them on the page. A confirmation box will appear – click on Yes to confirm addition of the dropped tile.
An easy way to make multiple changes to multiple rooms at the same time is to use the Options page. This page is launched using the Options button found at the bottom left of the page. Clicking this button will load a page with a two-dimensional matrix of all your things and all your rooms that looks like this:
Everywhere you see a check mark means the thing of that “row” will be shown in the room of that “column”. If you have a large number of things you can filter showing things by type by clicking on the check boxes on the top of this page. You can add or remove a check mark in any room for any thing. Duplicates are allowed. For example, at one extreme, if you want all things to show in all rooms, you would just check all of the boxes. This wouldn’t make any sense but hopefully this extreme example indicates the tool’s extreme flexibility. A more realistic example might be to check a thing with a name that didn’t match one of the default keywords, or to uncheck a thing that matched that you don’t want shown in the default room. For example, in my installation I added a check to “Back Yard Rock” to the Outside room, and removed the “Garage Entry Door” from the Outside room. I also checked the clock row for every room so I have a clock on all pages. You should also notice that the hub number and type of each thing is shown in this table.