{"id":24875854,"url":"https://github.com/stef1949/lumifur_controller_max7219","last_synced_at":"2026-02-17T07:09:31.242Z","repository":{"id":260856629,"uuid":"882543261","full_name":"stef1949/LumiFur_Controller_MAX7219","owner":"stef1949","description":"ESP32 controller code for an LED matrix display designed for a Protogen mask. It features various facial expressions and animations, which can be controlled via Bluetooth Low Energy (BLE) using an ESP32 development board. The project includes a boot-up animation with scrolling text and supports multiple facial expressions such as idle, happy","archived":false,"fork":false,"pushed_at":"2025-01-26T10:42:59.000Z","size":64,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-01-26T11:25:23.281Z","etag":null,"topics":["cpp","esp32","led-controller","ledmatrix","microcontroller","protogen","richies3d"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/stef1949.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":"docs/CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-03T03:57:46.000Z","updated_at":"2025-01-26T10:44:50.000Z","dependencies_parsed_at":"2024-11-03T05:16:49.011Z","dependency_job_id":"a3090aec-d83f-4d23-8dc8-7c198fe7e440","html_url":"https://github.com/stef1949/LumiFur_Controller_MAX7219","commit_stats":null,"previous_names":["stef1949/lumifur_controller"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stef1949%2FLumiFur_Controller_MAX7219","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stef1949%2FLumiFur_Controller_MAX7219/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stef1949%2FLumiFur_Controller_MAX7219/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/stef1949%2FLumiFur_Controller_MAX7219/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/stef1949","download_url":"https://codeload.github.com/stef1949/LumiFur_Controller_MAX7219/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":236635001,"owners_count":19180819,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cpp","esp32","led-controller","ledmatrix","microcontroller","protogen","richies3d"],"created_at":"2025-02-01T08:18:04.444Z","updated_at":"2025-10-13T11:04:51.694Z","avatar_url":"https://github.com/stef1949.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LumiFur Controller\nA program for controlling an LED matrix display for a Protogen mask, featuring various facial expressions and Bluetooth LE control with an ESP32.\n\n## Table of Contents\n\n- [Features](#features) ✨\n- [Hardware Requirements](#hardware-requirements) 🛠️\n- [Software Requirements](#software-requirements) 💻\n- [Installation](#installation) ⚙️\n- [Usage](#usage) 📖\n- [Facial Expressions](#facial-expressions) 😃\n- [Contributing](#contributing) 🤝\n- [License](#license) 📜\n\n## Features ✨\n- Multiple facial expressions (idle, happy, angry, playful, silly, kinky, and more)\n- Smooth blinking animations\n- Bluetooth Low Energy (BLE) connectivity to switch expressions remotely\n- Boot-up animation with scrolling text\n  \n## Hardware Requirements 🛠️\n- ESP32 development board\n- 14 x MAX7219 8x8 LED matrix modules\n- Connecting wires and power supply\n  \n## Software Requirements 💻\n- VSCode with PlatformIO Extension \n- MD_MAX72XX library\n- NimBLE-Arduino library\n\n## Installation ⚙️\n\n1. Clone the repository:\n    ```sh\n    git clone https://github.com/stef1949/LumiFur_Controller.git\n    ```\n\n2. Install the required libraries in Arduino IDE:\n\n### MD_MAX72XX Library:\n\n- Go to Sketch \u003e Include Library \u003e Manage Libraries...\n- Search for MD_MAX72XX and install it.\n\n### NimBLE-Arduino Library:\n\n- Follow the installation instructions here.\n\n3. Open the project:\n\n- Open main.cpp in the Arduino IDE.\n\n4. Configure hardware settings if necessary:\n\n- Check the pin definitions (CLK_PIN, DATA_PIN, CS_PIN) and adjust them to match your setup.\n\n## Usage 📖\n\n1. Connect your ESP32 to the computer via USB.\n2. Select the correct board and port in the Arduino IDE.\n3. Click Upload to flash the code.\n\n### Assemble the hardware:\n\n- Connect the LED matrix modules to the ESP32 according to your wiring configuration.\n\n### Operate the Protogen mask:\n\n1. Power on the device.\n2. The mask will display the default idle face with animations.\n3. Use the LumiFur app to connect to 'LumiFur_BLE'.\n4. Send values between 1 and 8 to change facial expressions.\n\n### Facial Expressions 😃\n\n- 1 - Idle Face\n- 2 - Happy Face\n- 3 - Angry Face\n- 4 - Playful Face\n- 5 - Silly Face\n- 6 - Kinky Face\n- 7 - Death Face\n- 8 - Edgy Face\n\n## Contributing 🤝\nContributions are welcome! Please fork the repository and submit a pull request with your improvements.\n\n## License 📜\nThis project is licensed under the BSD 3-Clause License - see the LICENSE file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstef1949%2Flumifur_controller_max7219","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fstef1949%2Flumifur_controller_max7219","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fstef1949%2Flumifur_controller_max7219/lists"}