Gladys Assistant 4.30 Release (#187)

blog/2023-10-30-gladys-4-30-alarm-mode.md

@@ -0,0 +1,119 @@
+---
+title: Gladys gets a full alarm!
+description: Security is the basis of home automation. Today, Gladys includes a complete alarm to help you manage your home's security.
+author: Pierre-Gilles Leymarie
+author_title: Founder of Gladys Assistant
+author_url: https://twitter.com/pierregillesl
+author_image_url: /img/pierre-gilles.jpg
+image: /img/presentation/gladys-assistant-4-30-en.jpg
+slug: gladys-4-30-alarm-mode
+---
+
+Hi everyone!
+
+Gladys Assistant 4.30 has just been released, and it's a hell of a version!!! 🥳
+
+The main feature is the complete management of an Alarm mode that allows you to set up a complete home security system.
+
+![Gladys iPad Alarm Mockup](../static/img/articles/en/gladys-4-30/alarm_ipad_mockup_en.png)
+
+You've got to admit, it does make you want to 😎
+
+## An alarm in Gladys
+
+Gladys can now replace a complete alarm system by managing the various states of any good alarm system:
+
+<!--truncate-->
+
+![Gladys dashboard alarm](../static/img/articles/en/gladys-4-30/alarm-dashboard.jpg)
+
+If you'd like to set up an alarm with Gladys, I've written [a complete tutorial](/docs/dashboard/alarm/) on the subject!
+
+## Node-RED integration
+
+It was already possible to interface Node-RED with Gladys (with the [MQTT integration](/docs/integrations/mqtt)), but this required some knowledge as you had to launch Node-RED yourself.
+
+Lokkye has worked on a native integration so that anyone can launch a Node-RED instance alongside Gladys with a single click!
+
+From now on, just go to the "Node-RED" integration and click on "Activate" to launch a Node-RED container:
+
+![Node-RED Gladys integration](../static/img/articles/en/gladys-4-30/node-red-integration.png)
+
+## Tuya: Power consumption management
+
+Tuya integration now supports connected sockets that report electricity consumption data.
+
+Thanks to Lokkye for the development 🙏
+
+## Launch a scene from chat
+
+This was already possible with the ChatGPT integration, but this command has just been added to the Gladys "local" chat model. You can now ask Gladys to launch a scene in the chat:
+
+![Launch chat scene](../static/img/articles/en/gladys-4-30/cinema-scene.png)
+
+Thanks to Lokkye for the development 🙏
+
+## Launch a scene with MQTT
+
+You can now launch a scene using MQTT by posting a message on the topic:
+
+```
+gladys/master/scene/SCENE_SELECTOR/start
+```
+
+By replacing `SCENE_SELECTOR` with the scene selector, which can be found in the scene edition URL.
+
+For example, for the scene `http://192.168.1.10/dashboard/scene/cinema`, you'll need to send a message to the topic:
+
+```
+gladys/master/scene/cinema/start
+```
+
+Thanks Lokkye for the development 🙏
+
+## Launch a scene when Gladys starts up
+
+Want to receive a message when Gladys restarts? Perform an operation every time Gladys starts up?
+
+You can now launch a scene when Gladys starts up:
+
+![Scene when Gladys starts](../static/img/articles/en/gladys-4-30/gladys-start-trigger.png)
+
+Thanks Lokkye for the development 🙏
+
+## Zigbee2mqtt: Interface enhancement
+
+Devices already added will no longer be displayed by default in the "Zigbee network discovery" page:
+
+![Zigbee2mqtt hide devices already added](../static/img/articles/en/gladys-4-30/zigbee2mqtt-hide-already-added-devices.png)
+
+And the Zigbee2mqtt URL is now displayed on the configuration page!
+
+**Bug correction**: When changing the USB key port, Gladys restarts the Zigbee2mqtt container with the correct volume.
+
+Thanks to AlexTrovato and Cicoub13 for these improvements 🙏
+
+## Homekit: Humidity and leak sensors management
+
+From now on, your leak and humidity sensors will be put back into Homekit!
+
+Thanks bertrandda for the development 🙏
+
+The complete CHANGELOG is available [here](https://github.com/GladysAssistant/Gladys/releases/tag/v4.30.0).
+
+## How to upgrade?
+
+If you installed Gladys with the official Raspberry Pi OS image, your instance will update **automatically** in the coming hours. It can take up to 24 hours, don't panic.
+
+If you installed Gladys with Docker, make sure you are using Watchtower. See the [documentation](/docs/installation/docker#auto-upgrade-gladys-with-watchtower).
+
+With Watchtower, Gladys will update automatically.
+
+## Support us
+
+If you want to support us, there are many ways:
+
+- Answer posts on the forum, give your feedback.
+- Help us improve the documentation.
+- Develop new features/integrations on Gladys, we are 100% open-source.
+- Subscribe to [Gladys Plus](/plus), at -40% right now!!

docs/api/3_mqtt_api.md

@@ -8,7 +8,7 @@ If you have configured a MQTT Broker with your Gladys installation, you will hav
 
 Here are all the MQTT topics available, each one with an example message to send:
 
-#### Push a decimal device state
+### Push a decimal device state
 
 Say you have a temperature sensor sending data to Gladys, you'll have to send it's temperature values to:
 
@@ -17,7 +17,7 @@ Topic: gladys/master/device/:device_external_id/feature/:device_feature_external
 Body: 22.2
 ```
 
-#### Push a text device state
+### Push a text device state
 
 If you want, you can send text to Gladys to display it on the dashboard!
 
@@ -30,7 +30,7 @@ Topic: gladys/master/device/:device_external_id/feature/:device_feature_external
 Body: Hello Gladys!
 ```
 
-#### Push a state to a device
+### Push a state to a device
 
 Say you have a MQTT light, and you want it to be controlled in Gladys.
 
@@ -55,3 +55,19 @@ Or
 ```
 
 Meaning "The light needs to be turned off".
+
+### Launch a scene with MQTT
+
+You can now launch a scene using MQTT by posting a message on the topic:
+
+```
+gladys/master/scene/SCENE_SELECTOR/start
+```
+
+By replacing `SCENE_SELECTOR` with the scene selector, which can be found in the scene edition URL.
+
+For example, for the scene `http://192.168.1.10/dashboard/scene/cinema`, you'll need to send a message to the topic:
+
+```
+gladys/master/scene/cinema/start
+```

docs/dashboard/alarm.md

@@ -0,0 +1,91 @@
+---
+id: alarm
+title: How to set up your own alarm system with Gladys?
+sidebar_label: Alarm
+---
+
+In Gladys, you can configure a real alarm system.
+
+## Configure dashboard
+
+On the dashboard, you can add an "Alarm" widget:
+
+![Dashboard alarm](../../static/img/docs/en/dashboard/alarm/alarm-dashboard.jpg)
+
+The alarm in Gladys has 4 modes:
+
+- **Armed**: The house is armed. Useful when you're away from home.
+- **Disarmed**: The house is disarmed, the alarm is not active.
+- **Partial arming**: This mode is useful for "night mode" or "nap mode". You're at home and want to monitor only the outside of the house, but not the inside, so you can continue moving around.
+- **Panic mode**: An intruder is in the house and you want to trigger the alarm, perhaps sending an automatic message to a loved one?
+
+Now that you've understood the different modes, it's time to set up scenes to implement your alarm strategy.
+
+## Set arming delay and alarm code
+
+There are 2 parameters to set in the house parameters ("Parameters" -> "Houses")
+
+![Alarm house settings](../../static/img/docs/en/dashboard/alarm/alarm-house-settings.jpg)
+
+- **Alarm code**: If you use "tablet mode", Gladys will display a numeric keypad on these tablets when the alarm is armed. The code defined here will be used to deactivate the alarm. We'll talk about this tablet mode later in this tutorial.
+- **Delay before arming**: If you want to leave a delay before the alarm is armed (between 5 seconds and 1 minute), you can set it here. This allows you to leave the house before the alarm is activated.
+
+## Setting up scenes
+
+Now we need to tell Gladys what the alarm mode will do.
+
+The first scene to create is one that will be triggered when the alarm is armed.
+
+For example, you can send yourself a Telegram message when the alarm is arming, or make a sound signal in the house, make the lights flash - anything is possible!
+
+![Alarm arming...](../../static/img/docs/en/dashboard/alarm/alarm-arming.jpg)
+
+Next, the most important scenario: what to do in the event of an intrusion?
+
+You can create a scene with several triggers:
+
+- "When motion is detected in the living room"
+- "When motion is detected in the kitchen".
+- "When the front door is opened".
+
+![Scene motion alarm](../../static/img/docs/en/dashboard/alarm/alarm-scene-motion.jpg)
+
+Then add a condition "AND that the alarm is in armed mode" :
+
+![Alarm scene condition](../../static/img/docs/en/dashboard/alarm/alarm-condition.jpg)
+
+If this condition is met, the scene will continue and you can then send yourself a Telegram message, send yourself a camera image via Telegram, trigger an audible alarm in the house, etc...
+
+If someone breaks into your home, they may try to unlock Gladys via your wall-mounted tablets.
+
+They will be able to test 3 codes before the keypad locks for 5 minutes, and after 3 failed codes, this scene trigger will be called:
+
+![Alarm bad scene code](../../static/img/docs/en/dashboard/alarm/wrong-alarm-code.jpg)
+
+You can create a scene on this trigger that will warn you by message.
+
+## Tablet mode
+
+If you have a tablet on the wall at home, you can declare it to Gladys via the "Tablet mode" button:
+
+![Tablet mode](../../static/img/docs/en/dashboard/alarm/alarm-tablet-mode-button.jpg)
+
+When you click on this button, you'll see a form prompting you to enter the house in which this tablet is located.
+
+Gladys needs this information to know when to "lock" the tablet:
+
+![Tablet mode configuration](../../static/img/docs/en/dashboard/alarm/alarm-tablet-mode-config.jpg)
+
+If you want your tablet to be full-screen (and the rest), you can add a parameter to the URL: `?fullscreen=force`.
+
+This "forced fullscreen" has nothing to do with the tablet mode; both are entirely independent.
+
+When the alarm is armed, Gladys will automatically fetch all the tablets in the house, and lock them.
+
+These tablets will display a numeric keypad that will enable you to unlock the alarm:
+
+![Tablet mode numeric code](../../static/img/docs/en/dashboard/alarm/alarm-tablet-mode-locked.jpg)
+
+This keyboard is an alternative to physical keyboards, but you can also use a real physical Zigbee keyboard and create a scene that disarms the alarm when this keyboard is used.
+
+You can also dispense with these keypads altogether and disarm the alarm via your phone's "Alarm" widget.

i18n/fr/code.json

@@ -547,7 +547,7 @@
     "description": "Gladys Plus suscribe button discount"
   },
   "gladysPlusPage.subscribe": {
-    "message": "A l'occasion du lancement de l'intégration Tuya, -40% sur le premier paiement ( annuel ou mensuel ) avec le code TUYA2023 !",
+    "message": "A l'occasion du lancement de la fonctionnalité alarme, -40% sur le premier paiement annuel avec le code ALARM2023 !",
     "description": "Gladys Plus suscribe button discount"
   },
   "gladysPlusPage.unsuscribeAtAnytime": {

i18n/fr/docusaurus-plugin-content-blog/2023-10-09-gladys-4-29.md

@@ -23,6 +23,8 @@ Merci à @Lokkye pour le développement 🙌
 
 ### Mode plein écran pour les tablettes Gladys
 
+<!--truncate-->
+
 Si vous utilisez Gladys sur une tablette tactile quelque part dans votre maison, il est probable que vous vouliez afficher en plein écran le tableau de bord de Gladys, sans avoir la possibilité de naviguer hors de cet écran.
 
 C'est désormais possible grâce à un paramètre à rajouter dans L'URL :