AIIM (Am I In [a] Meeting?)

This app will detect if you are in a meeting in Zoom or Microsoft Teams by looking at your tasklist and send a REST call to a Raspberry Pi which will either control a simple LED or NeoPixel LED .This was written to work with Windows for now but I will try to add Mac and Linux support. I welcome pull requests! This does NOT utilize any kind of APIs to determine if you are in a meeting. No APIs means lower risk for data exposure (I understand there has been a lot of concerns around zoom privacy and security).

Demo

(Coming soon)

<a href="https://www.youtube.com/watch?v=Kf6seycN9yY" target="_blank"><img src="img/thumbnail.png" alt="AIIM Demo" width="700px" /></a>

Table of Contents

1. Getting Started
2. Windows Setup
   1. The Code
      1. Configuration
      2. Check Process Script
   2. Scheduled Task
   3. Detecting Meetings
      1. Zoom
      2. Microsoft Teams
3. Raspberry Pi Setup
   1. Installation
   2. Configuration
   3. Simple vs. NeoPixel
   4. Endpoint
4. Future
5. Authors
6. License
7. Questions
8. Contribute

Getting Started

How does this work?

Here's a quick summary of how things work:

1. Python script is run on a schedule using Task Scheduler which checks for the Zoom or Microsoft Teams processes.
2. If you are in a meeting, the script makes a REST call to a Raspberry Pi running a Flask app.
3. Depending on your settings, it'll either turn the GPIO on/off or do some cool things with NeoPixel LEDs.

Zoom meeting detection works really well. However, Microsoft Teams isn't guaranteed. The way this script tells if you are in a Teams meeting is by reading the Window Title. When you first enter a meeting, the window title is "Meeting | Microsoft Teams" - however, if you switch to chat or activity or any other tab within Teams, the window title changes and DOES NOT change back to "Meeting" even after you go back to your meeting. It's very strange.

There are two directories in this repo: Windows and Raspberry Pi;

The Windows directory contains the script that will be run on a scheduled task on your Windows machine. And the Raspberry Pi contains the Flask app that needs to run on your Pi. More info on the Flask app can be found in the Raspberry Pi Setup section below.

Windows

You need Python 3+ installed locally. I recommend at least version 3.6. Check out the official documentation on how to install Python on Windows here: https://docs.python.org/3/using/windows.html

I also recommend making sure Python is available as a path variable so that you can run it on a basic command prompt without issues.

aiim/config.py

The config needs some of your attention. Edit the config.py file:

PI_URL = 'http://{{your_rpi_addr}}'
URL_CONTEXT = 'led'
LED_TYPE = '{{simple/neopixel}}'
ZOOM = True
TEAMS = True
THEME = 'random' # valentines, cool, nature, random (blank = random)

Change the PI_URL to your Pi's IP address or hostname.

The URL_CONTEXT by default is led. If you change the context in the Raspberry Pi Apache Configs, change this value.

The LED_TYPE will take one of two values: simple or neopixel. The simple led type is if you're controlling a basic LED. This can actually be used with relays and transistors as well. Endless possibilities since all this does is turn a GPIO pin on and off. The neopixel led type requires you to use WS2812x LEDs. This is similar to my Dancy Pi set up. neopixel is currently the default.

By default, both ZOOM and TEAMS are set to true because the script will look for both. If you only want to look for one or the other, change the value to False. Changing both to False will mean that they are both True.

The THEME is just something I added for fun. The default is that a random color is set for each LED, but there are 3 built-in "themes": valentines, cool, nature, and random. It's not necessary to pass this parameter, but if you do, you'll get a themed color:

• Valentines: redish colors
• Cool: blueish coloes
• Nature: greenish colors
• Random: the default - randomly generates a color

aiim/check_proc.py

I recommend running things in a virtual environment, but it is not necessary. The only requirement this project has for Windows is requests and I think it's fine to install that globally.

But if you want to install a venv, you can do so by going into the Windows\ directory and running:

python -m venv venv

This will download an install a virtual environment called venv. Your directory should now have a venv\ directory along with your aiim\ package. This app is not complex so it doesn't really matter where your venv gets installed.

Activate venv with this command:

venv\Scripts\activate.bat

This should add the (venv) prefix to your command prompt line, indicating that you are in your virtual environment. You need to then install the requests module so that you can make a REST call:

pip install requests

If you already have your Pi running, you can test the script with:

python check_proc.py

It'll either error out or give you nothing.

The main part about this script is the command to generate the task list:

os.popen('tasklist /fo table /v /fi "imagename eq CptHost.exe" && tasklist /fo table /v /fi "imagename eq Teams.exe" /fi "windowtitle eq Meet*" /nh')

This invokes the tasklist command twice. The first time it looks for CptHost.exe which is the process for a Zoom meeting. Zoom is simple so as long as that's running, you're in a Zoom meeting.

The second is it looks for Teams.exe which is the Microsoft Teams process. But we need to filter it further to look for a window title to equal to Meet* because we are searching for a window titled "Meeting | Microsoft Teams".

As mentioned above, Microsoft Teams is a little weird. If you start/join a meeting, your window title will be "Meeting | Microsoft Teams" - however, if you switch to enter component within teams (e.g. activity, chat, etc.), the title will change and the app will think you are no longer in a meeting (once the scheduled task runs). Even if you go back to your meeting in Teams, the window will NOT change back to "Meetings | Microsoft Teams" - why? I don't know.

The app is more accurate for Zoom meetings than it is with Microsoft Teams.

The /v flag is for verbose so the call can take a long time. However, adding the /fi flag for filtering makes it significantly faster!

Scheduled Task

We are trilling the check_proc.py script using a Scheduled Task in Windows. You can set this to any schedule you'd like, but I recommend running it during work hours (plus/minus an hour or two depending on how long you actually work) starting at minute 01 (meaning start it at 8:01 AM instead of 8:00 AM) because it could take you a minute to join a meeting. And then run this every 5 minutes (so it'll run at 8:01, 8:06, 8:11, etc.). At best, the script will know you're in a meeting within a few seconds and at worse, you'll have to wait 5 minutes.

Here's an example of the Scheduled Task trigger:

The task runs from 8:01 AM to 6 PM (10 hours duration) every 5 minutes Monday thur Friday.

Here's an example of the the action:

The "Program/Script" should use your pythonw.exe - if you are using a virtual environment like I am, put that path in. If you are using your global, find where your global pythonw.exe is located and put the path in there.

NOTE: We are using pythonW and not just python - this is necessary in order to run this script in the background. If you don't use the W, it'll open a command prompt every time it runs and you'll see it in your taskbar.

One downside of using pythonw is that if the app fails, it'll fail silently and will not warn you. pythonw simply starts the script then exists. I do want to set up some kind of logging in the future to output errors so that you are aware.

The "add arguments" should be the path to your check_proc.py - where ever it's stored. It should be the full path because your Task Scheduler won't know where to look and the script won't run.

I am running it every 5 minutes, feel free to run it every 1 minute if you desire. Windows Task Scheduler doesn't let you set an interval of less than one minute.

Detecting Meetings

Some of this is repeat from above but more organized in its own sections. The script uses your tasklist to see what processes are running. The main command is:

os.popen('tasklist /fo table /v /fi "imagename eq CptHost.exe" && tasklist /fo table /v /fi "imagename eq Teams.exe" /fi "windowtitle eq Meet*" /nh')

Zoom

The Zoom meeting process is CptHost.exe - it is the image name and is pretty simple. If it's detected, your are in a meeting!

Microsoft Teams

Microsoft Teams meeting is run within the Teams.exe process, so we filter our tasklist for this process first. Then we filter it further and look at the Window Title of Meet* because we are searching for a window titled "Meeting | Microsoft Teams".

If you start/join a meeting, your window title will be "Meeting | Microsoft Teams" - however, if you switch to enter component within teams (e.g. activity, chat, etc.), the title will change and the app will think you are no longer in a meeting (once the scheduled task runs). Even if you go back to your meeting in Teams, the