Full documentation: drewferg11.github.io/Split-Flap-Display
A fully 3D-printed, modular split-flap display with an ESP32-based web interface. Forked from jhoff/Split-Flap-Display, which builds on the original hardware design by Morgan Manly. This fork adds extended firmware, in-depth documentation, a firmware web flasher, and support for a 16-module dual I²C configuration.
You don't need PlatformIO or a build environment to get started. Flash the latest firmware straight from your browser over USB. No code, no compilers, just a data cable and Chrome, Edge, or Opera on desktop. The installer auto-detects your board (WROOM, C3, or S3) and walks you through Wi-Fi setup right after flashing.
Prefer to build it yourself? See the manual install guide.
- 8 or 16-module display: single row of 8 modules, or dual row of 16 over an I²C bus(es)
- Web interface: configure and control the display from any browser on your network
- Multiple display modes: custom text, multi-word cycling, date, time, and random test
- 37 or 48 character support: standard or extended character set per module
- WiFi configuration: set up via access point on first boot, then connects to your network
- MQTT support: integrate with Home Assistant or other MQTT brokers
- OTA updates: update firmware and filesystem over the air without USB
PRs and issues welcome! See CONTRIBUTING.md for the issue/PR flow, formatting requirements, and a note on the project's licensing situation.
- 3D model files (
STL/,3MF/,step/) are licensed under CC BY-NC-SA 4.0. See LICENSE-HARDWARE.md. Original design by Morgan Manly. - Firmware source code does not yet have an explicit license. This fork inherits that from jhoff/Split-Flap-Display and its own upstream. The intent is to move to a permissive open-source license (likely MIT) once upstream adopts one. Contributions are accepted under that understanding. See CONTRIBUTING.md.
- Custom PCB design (
custom-pcb/): license TBD.
