Shining Mask Hacks

This repository contains code and instructions for creating a custom Bluetooth Low Energy (BLE) controller for the Shining LED Mask that automatically changes the face image of any masks within BLE range. This repository is a companion to Invasion of the Facechangers: Halloween Hijinks with Bluetooth LED Masks.

Features

• Automatically connects and uploads a fox face to any Shining LED Mask within BLE range
• No user interaction required once the script is running

Bill of Materials

• Adafruit Feather nRF52840 Express
  • Technically, any BLE-capable Feather board that supports CircuitPython should work, but this is the one we used.
• Any connecting battery for the Feather board
  • Again, see the "Also Include" section in the Adafruit guide for any batteries compatible with the Feather board.

Setup

1. Connect the Feather board to your computer via USB, and install the UF2 bootloader if necessary. Once install, reinsert the Feather board.
2. Copy all code files to the Feather board's CIRCUITPY drive. Particularly, you want code.py, bfox.py, and the lib folder with the CircuitPython Bluetooth LE libraries.
3. Safely eject the CIRCUITPY drive from your computer.
4. Connect the battery to the Feather board. The script should start running automatically.

Usage

Just connect the battery, and it will automatically start scanning for Shining LED Masks and upload this fox face to any it finds:

You can modify the code.py file uploaded to the board if you want to add your own mask ID to the ignore list.