diff --git a/docs/integrations/bluetooth.md b/docs/integrations/bluetooth.md index e2f1d9b1..91d60563 100644 --- a/docs/integrations/bluetooth.md +++ b/docs/integrations/bluetooth.md @@ -4,47 +4,43 @@ title: Manage presence with Bluetooth detection sidebar_label: Bluetooth --- -Bluetooth integration is useful for presence detection. +# Manage presence with Bluetooth detection -There are bluetooth key chains like the [NUT keychain](https://www.amazon.com/gp/product/B08K3124JR/ref=as_li_qf_asin_il_tl?ie=UTF8&tag=gladproj-20&creative=9325&linkCode=as2&creativeASIN=B08K3124JR&linkId=5688d18164e92becabd17c6d49fdd778) which permanently broadcast their presence via Bluetooth. +**Bluetooth** integration is useful for presence management. -With this kind of key fob, Gladys can detect when you are (or are not) at home, simply by scanning for nearby bluetooth devices. - -:::note -This trick does not work with all Bluetooh devices. This only works with bluetooth devices that (1) transmit their signal continuously, and (2) which do not obfuscate their bluetooth address. **Most phones do not broadcast their bluetooth signal continuously**. +There are Bluetooth key rings like the [NUT key ring](https://www.amazon.fr/NUT-%C3%89crou-Mini-Bluetooth-Tracker/dp/B01M664D98/ref=sr_1_1?tag=gladproj-21) that constantly signal their presence via Bluetooth. -In general, the "dumber" the device, the better it works! For example, I had a Fitbit Force 2 bracelet, and it worked. However, it does not work with an Apple Watch. -::: +With this kind of key fob, Gladys can detect when you are (or are not) at home, simply by scanning for nearby bluetooth devices. -## Configure your bluetooth device +**Note:** This trick doesn't work with all Bluetooth devices. It only works with Bluetooth devices that transmit continuously, and that don't obfuscate their Bluetooth address, as most phones do, for example. Generally speaking, the "dumber" the device, the better it works! For example, I had a Fitbit Force 2 bracelet, and it worked. However, it doesn't work with an Apple Watch. -Go to the "Bluetooth" integration, "Discovery" tab. Scan the surrounding bluetooth devices, and find the device you want to add. +## Configure your Bluetooth device -Click on "Connect to Gladys": +Go to `Integration -> Bluetooth`, `Discover` tab. Scan the surrounding Bluetooth devices, and look for the device you want to add. ![Configure bluetooth device](../../static/img/docs/en/configuration/bluetooth/configure-device.png) -Then activate the option "Use this device as a presence sensor". +Then activate the `Use this device as a presence detector` option. Give this device a unique name, and add it to Gladys. -You should land on this screen: +This screen should appear: ![Configure bluetooth device](../../static/img/docs/en/configuration/bluetooth/device-list.png) -Now, go to the "Presence scanner" screen, and check that your configuration looks like this: +Now go to the `Presence scanner` screen, and check that your configuration looks like this: ![Configure bluetooth device](../../static/img/docs/en/configuration/bluetooth/presence-scanner.png) -It's good, everything is configured on the Bluetooth side! +All set on the Bluetooth side! ## Manage presence in scenes ### A "homecoming" scene -We are now going to create a `scene` that will mark a user as "present at home" when this Nut keychain (or any other compatible bluetooth device) is detected. +Now we're going to create a scene that will mark you as "present at home" when this Nut keyring is detected. -Go to the "Scenes" tab, and create a scene like this: +Go to the `Scenes` tab, and create a scene like this one: ![Return home scene](../../static/img/docs/en/configuration/bluetooth/back-at-home-scene.png) @@ -54,9 +50,9 @@ WHEN "the key fob is detected" THEN "put user 'Tony' as present at home". ### A "leaving home" scene -To manage the departure of the user from the house, we recommend you make a scene executed periodically, which will check if your NUT keychain has been detected recently at home. +To manage leaving the house, I recommend making a periodically executed scene that will check whether your NUT keyring has recently been detected at home, or not. -If Gladys detects the device's presence, it won't do anything. If not, Gladys will mark the user as absent. +If yes, Gladys will do nothing. If not, Gladys will mark the user as absent. The scene should look like this: @@ -66,6 +62,18 @@ You can play around with the settings to suit your home. If you feel that 10 min ## Display presence on the dashboard -You can display the presence of selected users on the dashboard. To do so, you can use the "Users present" widget: +You can now add a **Users present** widget to your dashboard to display the presence of different users at home. + +Go to Gladys' dashboard and click on the `edit` button to modify the dashboard. + +![edit_dashbord](<../../static/img/docs/en/configuration/bluetooth/edit dashboard.png>) + +Click on `add +` then select the `Users present` widget, which you can move to a column. + +Select the user(s) you wish to display, and click on `Save`. + +That's it! Your widget is now visible on the dashboard. ![Presence dashboard](../../static/img/docs/en/configuration/bluetooth/user-presence-dashboard.png) + +Please post a message on [the forum](https://en-community.gladysassistant.com), if you need any help. \ No newline at end of file diff --git a/docusaurus.config.js b/docusaurus.config.js index 56cbe139..afab0215 100644 --- a/docusaurus.config.js +++ b/docusaurus.config.js @@ -203,4 +203,4 @@ module.exports = { src: "https://abcdef.gladysassistant.com/latest.js", }, ], -}; +} \ No newline at end of file diff --git a/i18n/fr/docusaurus-plugin-content-docs/current/integrations/bluetooth.md b/i18n/fr/docusaurus-plugin-content-docs/current/integrations/bluetooth.md index 699b82c9..3b7e71df 100644 --- a/i18n/fr/docusaurus-plugin-content-docs/current/integrations/bluetooth.md +++ b/i18n/fr/docusaurus-plugin-content-docs/current/integrations/bluetooth.md @@ -4,23 +4,25 @@ title: Gérer la présence avec la détection Bluetooth sidebar_label: Bluetooth --- -L'intégration Bluetooth est utile pour la gestion de la présence. +# Gérer la présence avec la détection Bluetooth. + +**L'intégration Bluetooth** est utile pour la gestion de la présence. Il existe des portes-clés Bluetooth comme le [porte clé NUT](https://www.amazon.fr/NUT-%C3%89crou-Mini-Bluetooth-Tracker/dp/B01M664D98/ref=sr_1_1?tag=gladproj-21) qui signalent leur présence en Bluetooth en permanence. -Avec ce genre de porte-clé, Gladys peut détecter quand vous êtes/n'êtes pas à la maison en scannant tout simplement les appareils bluetooth à proximité. +Avec ce genre de porte-clé, **Gladys** peut détecter quand vous êtes/n'êtes pas à la maison en scannant tout simplement les appareils bluetooth à proximité. **Note :** Cette astuce ne fonctionne pas avec tous les appareils Bluetooh. Cela fonctionne uniquement avec les appareils bluetooth qui émettent en permanence, et qui ne font pas des techniques d'obfuscation de leur adresse bluetooth, comme le font la plupart des téléphone par exemple. De manière générale, plus l'appareil est "bête", plus cela marches mieux ! J'avais par exemple un bracelet Fitbit Force 2, et cela fonctionnait. En revanche, ça ne fonctionne pas avec une Apple Watch. -## Configurer votre appareil bluetooth +## Configurer votre appareil Bluetooth[](https://gladysassistant.com/fr/docs/integrations/bluetooth/#configurer-votre-appareil-bluetooth) -Rendez-vous dans l'intégration "Bluetooth", onglet "Découverte". Scannez les appareils bluetooth environnant, et cherchez l'appareil que vous voulez ajouter. +Rendez-vous dans ****`Intégration **-**> Bluetooth`, onglet `Découverte`. Scannez les appareils Bluetooth environnant, et cherchez l'appareil que vous voulez ajouter. -Cliquez sur "Connecter à Gladys": +Cliquez sur `Connecter à Gladys`: ![Configurer appareil bluetooth](../../../../../static/img/docs/fr/configuration/bluetooth/configurer-appareil-bluetooth.png) -Puis activez bien l'option "Utiliser cet appareil comme un détecteur de présence". +Puis activez bien l'option `Utiliser cet appareil comme un détecteur de présence`. Donnez un nom unique à cet appareil, et ajoutez le à Gladys. @@ -28,19 +30,19 @@ Vous devriez arriver sur cet écran: ![Configurer appareil bluetooth](../../../../../static/img/docs/fr/configuration/bluetooth/liste-bluetooth.png) -Maintenant, rendez-vous dans l'écran "Scanner de présence", et vérifiez que votre configuration ressemble bien à ça: +Maintenant, rendez-vous dans l'écran `Scanner de présence`, et vérifiez que votre configuration ressemble bien à ça: ![Configurer appareil bluetooth](../../../../../static/img/docs/fr/configuration/bluetooth/parametres-bluetooth.png) C'est bon, tout est configuré côté Bluetooth ! -## Gérer la présence dans les scènes +## Gérer la présence dans les scènes[](https://gladysassistant.com/fr/docs/integrations/bluetooth/#g%C3%A9rer-la-pr%C3%A9sence-dans-les-sc%C3%A8nes) -### Une scène "retour à la maison" +### Une scène "retour à la maison"[](https://gladysassistant.com/fr/docs/integrations/bluetooth/#une-sc%C3%A8ne-retour-%C3%A0-la-maison) Maintenant, nous allons créer une scène qui va vous marquer comme "présent à la maison" quand ce porte clé Nut est détecté. -Rendez-vous dans l'onglet "Scènes", et créez une scène comme celle-ci: +Rendez-vous dans l'onglet `Scènes`, et créez une scène comme celle-ci: ![Scène retour à la maison](../../../../../static/img/docs/fr/configuration/bluetooth/retour-maison-scene.png) @@ -48,7 +50,7 @@ La scène est très simple. QUAND "le porte clé est détecté" ALORS "mettre l'utilisateur Tony comme présent à la maison". -### Une scène "départ de la maison" +### Une scène "départ de la maison"[](https://gladysassistant.com/fr/docs/integrations/bluetooth/#une-sc%C3%A8ne-d%C3%A9part-de-la-maison) Pour gérer le départ de la maison, je vous recommande de faire une scène exécutée périodiquement qui va vérifier si votre porte clé NUT a été détecté récemment à la maison, ou pas. @@ -60,8 +62,22 @@ La scène doit ressembler à ça : Vous pouvez jouer avec les réglages en fonction de votre maison. Si vous estimez que 10 minutes c'est trop court pour être mis comme absent, vous pouvez rallonger à 20 minutes pour éviter les "faux-départs" :) -## Afficher la présence sur le tableau de bord +## Afficher la présence sur le tableau de bord[](https://gladysassistant.com/fr/docs/integrations/bluetooth/#afficher-la-pr%C3%A9sence-sur-le-tableau-de-bord) + +Vous pouvez maintenant rajouter un **widget Utilisateurs présents** sur votre tableau de bord pour afficher la présence des différents utilisateurs à la maison. + +Rendez-vous sur le dashboard de Gladys et cliquez sur le bouton `éditer` pour modifier le dashboard. + +[](https://gladysassistant.com/fr/docs/integrations/camera/#ajoutez-la-cam%C3%A9ra-au-dashboard-de-gladys-assistant) -Maintenant, si vous voulez afficher la présence des différents utilisateurs à la maison, vous pouvez utiliser la box "Utilisateurs présents": +![editer_dashbord](../../../../../static/img/docs/fr/configuration/bluetooth/editer_dashboard.png) + +Cliquez sur `ajouter +` puis sélectionnez le widget `Utilisateurs présents`, vous pouvez déplacer ce widget dans une colonne. + +Sélectionnez le ou les utilisateur(s) que vous voulez afficher, et cliquez sur `Enregistrer` + +Voilà ! Votre widget est visible sur le dashboard. ![Présence dashboard](../../../../../static/img/docs/fr/configuration/bluetooth/presence-dashboard.png) + +Je vous invite à poster un message sur [le forum](https://community.gladysassistant.com/), si jamais vous avez besoin d’aide. diff --git a/static/img/docs/en/configuration/bluetooth/edit dashboard.png b/static/img/docs/en/configuration/bluetooth/edit dashboard.png new file mode 100644 index 00000000..60d654c7 Binary files /dev/null and b/static/img/docs/en/configuration/bluetooth/edit dashboard.png differ diff --git a/static/img/docs/en/configuration/sonos/add_sonos_device.png b/static/img/docs/en/configuration/sonos/add_sonos_device.png index b7d2ccdf..bc987a46 100644 Binary files a/static/img/docs/en/configuration/sonos/add_sonos_device.png and b/static/img/docs/en/configuration/sonos/add_sonos_device.png differ diff --git a/static/img/docs/en/configuration/sonos/edit_music_widget.png b/static/img/docs/en/configuration/sonos/edit_music_widget.png index f46d2935..176bbafe 100644 Binary files a/static/img/docs/en/configuration/sonos/edit_music_widget.png and b/static/img/docs/en/configuration/sonos/edit_music_widget.png differ diff --git a/static/img/docs/en/configuration/sonos/music_widget.png b/static/img/docs/en/configuration/sonos/music_widget.png index 7e90eaea..2bc3b4ed 100644 Binary files a/static/img/docs/en/configuration/sonos/music_widget.png and b/static/img/docs/en/configuration/sonos/music_widget.png differ diff --git a/static/img/docs/fr/configuration/bluetooth/editer_dashboard.png b/static/img/docs/fr/configuration/bluetooth/editer_dashboard.png new file mode 100644 index 00000000..6e3d771f Binary files /dev/null and b/static/img/docs/fr/configuration/bluetooth/editer_dashboard.png differ diff --git a/v4-website b/v4-website new file mode 160000 index 00000000..dfbe06ee --- /dev/null +++ b/v4-website @@ -0,0 +1 @@ +Subproject commit dfbe06ee2770f33e597b9b9b85344a70652e418c