maxswinkels/busybar-emulator

BUSY Bar Emulator is an unofficial local emulator for a small hardware LED display gadget called the Flipper BUSY Bar. It is not made by the company that sells the real device, and it exists so people can start building and testing apps for the BUSY Bar before their own hardware order arrives, or if they never get one at all. The real BUSY Bar works by receiving plain HTTP requests to draw text, images, and animations on its small pixel grid. This emulator copies that same HTTP API on your own computer, using the same fonts, the same 72 by 16 pixel animations, the same set of stock icons, and the same gamma correction that makes the real LEDs look a certain way. Because the API matches so closely, an app written to talk to this emulator should run on the real hardware without changes, other than pointing it at a different address. Running it locally starts a small web server with no external dependencies, plus a browser based control panel built with Vue 3 that mirrors the real device's screens for network, firmware, settings, and drawing. There is also a draw tool in the browser that lets you place text, shapes, and icons directly on the simulated screen and see it update live, and you can export what you made as a PNG image or an animated GIF to share. The project includes several example scripts written in Python that show off different things the emulator can do, such as showing a clock, playing a themed status animation, drawing a weather icon, or animating a fire effect. The emulator also adds scenario controls not found on the real device, like faking a low battery, going offline for a while, or having another app take over the display with a higher priority, which are useful for testing how a real app behaves in less than ideal conditions. Community made apps for the BUSY Bar are shared in a separate linked gallery repository. The project is licensed under the MIT License.