jimmyeao / TEAMS2HA

23 stars 1 forks source link

CodeQLGitHub tag License issues - Teams2HA

Teams2HA

IMPORTANT!!

Please review Breaking changes ahead of the next version (723) which will be released this weekend (28th Mar 2024) https://github.com/jimmyeao/TEAMS2HA/blob/master/breaking.md

This is an agent that runs on windows and uses the Local teams API (https://support.microsoft.com/en-gb/office/connect-to-third-party-devices-in-microsoft-teams-aabca9f2-47bb-407f-9f9b-81a104a883d6?wt.mc_id=SEC-MVP-5004985) to retrieve the status of the user (In a meeting, Video On, Mute, blur etc) and push these into homeassistant sensors using MQTT.

Download the latest version from https://github.com/jimmyeao/TEAMS2HA/releases (app will auto update once installed)

image

Pairing

to pair, have the app running, launch a teams meeting (using meetnow?) and click Pair wtih teams. This will initiate a pairing request in teams, accept this, and then the app will store the key, in an encrypted format.

The application will minimize to the system tray.

MQTT

Provide your MQTT instance details (IP, username and password) The password is encrypted before being saved to the settings file and is not stored in clear text. We support plain MQTT, MQTT over TLS, MQTT over Websockets and MQTT over Websockets with TLS and the ability to ignore certificate errors if you are using self-signed certs (I would strongly advise you to use Lets Encrypt as a minimum)

Entities

Click the Entities button to see a list of entities this program will create:

image

You can either right click and copy or double click to copy the entity name to the clipboard.

System Tray

You can right click the system tray icon for a selection of functions:

image

This is how it should look in MQTT in Homeassistant

image