Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

screen sonos EN #235

Closed
wants to merge 47 commits into from
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
47 commits
Select commit Hold shift + click to select a range
a8c4223
test mise en page
tlse-vins Dec 11, 2023
1568099
test mise en page
tlse-vins Dec 11, 2023
ef413d7
test
tlse-vins Dec 11, 2023
69ca215
test
tlse-vins Dec 11, 2023
1242056
test
tlse-vins Dec 11, 2023
a08fecd
test
tlse-vins Dec 11, 2023
72e267a
test
tlse-vins Dec 11, 2023
7a39a61
test modif
tlse-vins Dec 11, 2023
b154f7f
modif sonos.md
tlse-vins Dec 11, 2023
b3d9dbd
modif sonos.md 2
tlse-vins Dec 11, 2023
4036b1a
modif center image
tlse-vins Dec 11, 2023
739f627
modif sonos.md 3
tlse-vins Dec 11, 2023
0ce6935
modif sonos.md 4
tlse-vins Dec 11, 2023
e1fe0dd
modif sonos.md 5
tlse-vins Dec 11, 2023
9cc0df7
modif sonos.md image
tlse-vins Dec 11, 2023
90b1ef6
sonos.md image
tlse-vins Dec 11, 2023
f01a8b2
test centrage image
tlse-vins Dec 12, 2023
6f60bb7
test centrage image 2
tlse-vins Dec 12, 2023
e3e087b
test marge
tlse-vins Dec 12, 2023
219de83
test marge 2
tlse-vins Dec 12, 2023
7d6e259
test marge 5 px
tlse-vins Dec 12, 2023
84d6dc5
marge 0
tlse-vins Dec 12, 2023
c9b7e19
marge 0 px 2
tlse-vins Dec 12, 2023
88202b6
test desactiver linter
tlse-vins Dec 12, 2023
10e65bc
sup alignitems
tlse-vins Dec 12, 2023
5e154d8
sup alignitem 2
tlse-vins Dec 12, 2023
845eb95
sup marge et alignitems
tlse-vins Dec 12, 2023
8903758
cover 600 px
tlse-vins Dec 12, 2023
91503e3
sup justifyContent
tlse-vins Dec 12, 2023
36b4653
sup textalign
tlse-vins Dec 12, 2023
a21fd8d
sup contener
tlse-vins Dec 12, 2023
d32f012
sup minHeight: '100vh'
tlse-vins Dec 12, 2023
f1c25be
sup minHeight: '100vh
tlse-vins Dec 12, 2023
c5c507b
ajout catégorie doc
tlse-vins Dec 12, 2023
1cf020e
rajout page intégration
tlse-vins Dec 12, 2023
badc933
ajout page integration 2
tlse-vins Dec 12, 2023
f979cb5
sup page integration
tlse-vins Dec 12, 2023
9d58265
redimension cover
tlse-vins Dec 15, 2023
594570b
ajout cover EN
tlse-vins Dec 15, 2023
56334b9
cover EN
tlse-vins Dec 15, 2023
af38278
screen sonos EN
tlse-vins Dec 15, 2023
d35c56e
screen sonos EN
tlse-vins Dec 15, 2023
37fac29
sup cover
tlse-vins Dec 15, 2023
213bca5
mise en page
tlse-vins Dec 15, 2023
92417e2
Merge pull request #2 from tlse-vins/test
tlse-vins Dec 15, 2023
905e04f
Merge branch 'GladysAssistant:master' into master
tlse-vins Dec 15, 2023
19d9526
doc bluetooth
tlse-vins Jan 8, 2024
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
48 changes: 28 additions & 20 deletions docs/integrations/bluetooth.md
Original file line number Diff line number Diff line change
Expand Up @@ -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)

Expand All @@ -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:

Expand All @@ -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.
2 changes: 1 addition & 1 deletion docusaurus.config.js
Original file line number Diff line number Diff line change
Expand Up @@ -203,4 +203,4 @@ module.exports = {
src: "https://abcdef.gladysassistant.com/latest.js",
},
],
};
}
Original file line number Diff line number Diff line change
Expand Up @@ -4,51 +4,53 @@ 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.

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)

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.

Expand All @@ -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.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/img/docs/en/configuration/sonos/add_sonos_device.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/img/docs/en/configuration/sonos/edit_music_widget.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Binary file modified static/img/docs/en/configuration/sonos/music_widget.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
1 change: 1 addition & 0 deletions v4-website
Submodule v4-website added at dfbe06
Loading