theterg / google-meet-BLE-NUS-remote

An experimental / sample extension controlling google meet from a BLE remote based on the OHSummit 2020 Badge

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

google-meet-BLE-NUS-remote

** This extension is a very loose fork from google-meet-push-to-talk by BashVideo. The previous README at the point of fork can be found below **

This is a simple extension that allows you to mute and unmute yourself using a remote device that connects over Bluetooth Low Energy. It supports BLE devices that use the Nordic Uart Service (NUS). The commands received/sent are hard-coded to support sample firmware featuring the Open Hardware Summit 2020 Badge, a circuitPython project. However this project was designed to act as an example for other simple BLE protocols.

BashVideo/google-meet-push-to-talk was chosen as an arbitrary starting point for an extension targetting google meet. This project diverges significantly from the original project: we add hardware support for a BLE remote.

To use:

  • First deploy the sample script to a OHSummit 2020 Badge PCB, or a compatible CircuitPython board.
  • Then install this extension to your browser
  • Join a Google Meet
  • Upon opening the meet link, a popup should appear requesting connection to a BLE device
    • If a popup does not appear, refresh the page and be careful to keep your cursor within the Meet window
  • Select the correct entry, that probably starts with CIRCUITPY
  • Once connected the screen should change to display a logo
  • Press buttonD (upper right hand corner) to unmute
  • Press buttonC (upper left hand corner) to mute
  • Mute status should be displayed as icons on the screen

If you run into issues, inspect the javascript console on the meet window, and debug further from there.

google-meet-push-to-talk

Simple extension that allows you to mute and unmute yourself with a key press instead of fumbling around trying to click the icon.

๐Ÿ“š DOCUMENTATION

๐ŸŽ‰ Install the Chrome extension (reload your Meet tab if you have one open)
๐Ÿ”• Mute/unmute: Quick push space
๐Ÿ”ˆ Hold space (default) to talk, release to go back to mute
โŒจ๏ธ Configure your own hotkey if you don't like space
๐Ÿ“ฃ Mute will be on by default, but you can disable that feature in settings
โš ๏ธ This extensions only works on Google Meet, it will not work on Google Hangouts โš ๏ธ

๐Ÿค” PURPOSE

This extension was made to help all the teachers and students figuring out distance learning together due to COVID-19.

๐Ÿ•ต๏ธโ€โ™€๏ธ PRIVACY POLICY

We don't store your data, period.

๐Ÿ™ ACKNOWLEDGEMENTS

๐Ÿ‘ฉโ€๐Ÿซ๐Ÿ‘จโ€๐ŸซTeachers! School administrators! IT Staff!
๐Ÿ™ŒCasey Watts and all the contributors at the original gist for finding a clean and simple solution
๐ŸคTim Oxley and the keycode library
๐Ÿ‘‰Joshua Wilson for element-ready.js
๐Ÿ’ชGoogle Meet Grid View for being another great Chrome extension for group meetings and inspiring this
๐Ÿ™ŠIcons created by Freepik from https://www.flaticon.com

๐Ÿ“ฆ CHANGELOG

v1.1.1 - 2020-04-21

Fixed

  • Fix canceling hotkey entry

v1.1.0 - 2020-04-20

Added

  • "Mute on Join" setting, on by default

v1.0.2 - 2020-04-19

Added

  • Configurable hotkeys

Fixed

  • Default hotkey wasn't loading after upgrading
  • Transpiling for older version of Chrome
  • Only disable toggling when textarea or input is targeted
  • Non-stop toggling on camera control

v0.0.3 - 2020-04-08

Fixed

  • Non-stop toggling after clicking microphone control

v0.0.2 - 2020-04-07

Fixed

  • Disable toggling when chat window is open

About

An experimental / sample extension controlling google meet from a BLE remote based on the OHSummit 2020 Badge

License:MIT License


Languages

Language:JavaScript 88.4%Language:CSS 8.3%Language:HTML 3.4%