-
-
Notifications
You must be signed in to change notification settings - Fork 8
Home
These settings are used in WindFront to alter the behavior of the frontend in your browser. For e.g. changing the displayed columns for a table. Some settings are abstracted away in various pages (e.g. searches), and others are on the dedicated "Frontend settings" page.
They are stored in your browser's local storage. They will remain in effect as long as you don't clear the cache (exception: private windows, since they keep no cache).
In order to join a device to a network, you have to open the network via "Permit join". You can do this on the entire network (default), or on a specific router using the arrow next to the "Permit join" button.
The search field atop most page provides a quick way to filter out items based on whatever data is available on said page.
The advanced search drawer provides a way to target a specific field to search.
You can combine searched fields to refine a search.
Search fields placeholders will also show ranges (e.g. LQI), or "all values" (e.g. all feature types) for current dataset. This can give a quick overview of the dataset (e.g. using LQI and last seen ranges to gauge the state of the network).
Searches are saved per page in your browser's local storage. You can navigate away and back, and your searches will return. This also allows you to keep some searches "indefinitely", in case that's the way you prefer seeing a page (e.g. hiding offline devices).
Successive clicks on a column header allows to sort the column in ascending or descending order, or reset sorting back to default.
You can hold Shift while clicking on a column header to sort multiple columns of the same table.
The notifications drawer provides a curated list of recently received messages (subset of the Logs page) for quick review. It can also be cleared independently.
Whenever an error-level message is present in the drawer, the icon in the top bar will show a bouncing red dot next to it.
Whenever a previous configuration change requires a restart of Zigbee2MQTT, the icon in the top bar will show a bouncing dot next to it. A button to restart Zigbee2MQTT will also be present in the drawer.
The "server" icon in the drawer also shows the color-coded status of the WebSocket (the connection from the frontend to Zigbee2MQTT).
Toasts are messages that appear at the bottom of the screen when you receive feedback from Zigbee2MQTT after you executed an action.
A language marked AI means its translations were AI-generated. Contribute
Use dev branch of Zigbee2MQTT: https://www.zigbee2mqtt.io/advanced/more/switch-to-dev-branch.html
Caution
Some updates will require a minimum version (commit) of Zigbee2MQTT to work properly. This is usually the case when a new feature is introduced and changes are needed in the frontend. See the Zigbee2MQTT dev branch changelog.
Tip
You can install a specific WindFront version using the format pnpm i [email protected], example: pnpm i [email protected]
Stop Zigbee2MQTT.
Inside your Zigbee2MQTT installation folder:
pnpm update zigbee2mqtt-windfront --no-optionalStart Zigbee2MQTT again.
Example with Docker:
docker exec -it CONTAINER_ID sh
apk add npm
npm install -g [email protected]
/usr/local/bin/pnpm update zigbee2mqtt-windfront --no-optional
exit
docker restart CONTAINER_IDNote: the pnpm version should be the same as used by Zigbee2MQTT:
- current release: https://github.com/Koenkk/zigbee2mqtt/blob/master/package.json#L7
- current dev branch: https://github.com/Koenkk/zigbee2mqtt/blob/dev/package.json#L7