https://github.com/benbalter/meeting-matrix
Visually counts down the time remaining in a meeting on an RGB LED Matrix using a Raspberry Pi.
https://github.com/benbalter/meeting-matrix
meetings raspberry-pi rgb-led rgb-matrix
Last synced: 6 months ago
JSON representation
Visually counts down the time remaining in a meeting on an RGB LED Matrix using a Raspberry Pi.
- Host: GitHub
- URL: https://github.com/benbalter/meeting-matrix
- Owner: benbalter
- License: gpl-3.0
- Created: 2022-03-12T21:59:39.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2023-06-23T17:43:53.000Z (over 2 years ago)
- Last Synced: 2024-10-09T12:21:07.629Z (about 1 year ago)
- Topics: meetings, raspberry-pi, rgb-led, rgb-matrix
- Language: Python
- Homepage:
- Size: 104 KB
- Stars: 6
- Watchers: 2
- Forks: 0
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Meeting Matrix
*Visually counts down the time remaining in a meeting on an RGB LED Matrix using a Raspberry Pi.*
## What it does
A Raspberry Pi powered RGB LED Matrix to sit over your shoulder during virtual meetings and subtly count down the time remaining in a meeting to keep things on track.
Have you ever been in a meeting that just "ran out of time"? Perhaps there's that one person that asks a questions or starts a new topic with less than a minute remaining. There has to be a better way!
Introducing *Meeting Matrix*. Meeting Matrix politely counts down the time remaining in a meeting on an RGB LED Matrix, which you can subtly place over your shoulder. Specifically, it connects to your calendar and displays the number of minutes remaining in a meeting (e.g., `5 minutes`) when:
* Half of the meeting has elapsed (for example, 30 minutes for an hour meeting, 15 minutes for a 30 minute meeting)
* Every 10 minutes when 50% of the meeting to 20 minutes are remaining
* Every 5 minutes when 20 minutes to 5 minutes are remaining
* Every minute for the last 5 minutes
Here's what it looks like in action:
## How it works
The Raspberry Pi connects to your Google Calendar to know when you're in a meeting and how much time is remaining. After that, the hardware/software interface consists of:
* Raspberry Pi (any 32 pin model would work)
* [Adafruit RGB Matrix Bonnet for Raspberry Pi](https://www.adafruit.com/product/3211)
* [RGB Matrix](https://www.adafruit.com/category/327) (any size)
* [Controlling RGB LED display with Raspberry Pi GPIO](https://github.com/hzeller/rpi-rgb-led-matrix)
This is my first Python project, so please be kind!
## Setup
This repository contains an [Ansible Playbook](playbook.yml) which will build/install the necessary dependencies configure the Raspberry Pi with a single command:
1. Flash the 64 bit Raspian lite image to the Micro SD card, configuring wifi and your SSH key
2. Customize [`playbook.yml`](playbook.yml) and [`hosts.example.yml`](hosts.example.yml) (as `hosts.yml`)
3. Run `ansible-playbook playbook.yml --inventory hosts.yml`
## Authentication
You'll need to add a `credentials.json` file to the project directory, which contains your Google OAuth credentials as downloaded from the Cloud Console.
You'll also need to authorize the app on device with a browser, and then copy the resulting `token.json` file to the project directory on your Raspberry Pi.
## Running
The script should run automatically via Docker Compose as a service once the Raspberri Pi boots up. To authenticate or test locally run `python meeting_matrix.py`.
## Status
Proof of concept. Works on my machine, but your results may vary. Contributions welcome!
## License
The project is licensed under the GPLv2 license based on its dependency on [`hzeller/rpi-rgb-led-matrix`](https://github.com/hzeller/rpi-rgb-led-matrix).
## Roadmap
See the [open issues](https://github.com/benbalter/meeting-matrix/issues).