How matrixbox-dev/matrixbox works
MatrixBOX is CircuitPython firmware for a programmable LED-matrix device, with a built-in web interface and a collection of device apps. The main workflow loads settings, initializes the display and network, serves a home page, then launches the selected app; users can also configure Wi-Fi and device settings remotely. Departures is a substantial standalone app with its own settings, data-processing, rendering, skin and web layers. The graph reflects documented and indexed relationships; unsampled app implementations are represented by their exact source paths, without inferred internal call chains.
Main entry points: main.py Runtime Loop · functions.py Departure Processing · varinit.py Departures State · web.py Departures Web UI
Components 29
Firmware Core
- Runtime Loop
main.py - Boot Setup
boot.py - Settings
lib/load_settings.py - Matrix Display
lib/load_screen.py - Display Fonts
lib/font_large.py - Button Input
lib/check_button.py
Web And Network
- HTTP Router
lib/ampule.py - Device Web UI
lib/web_interface.py - Wi-Fi Manager
lib/wlan.py - File Manager
lib/filemanager.py - AI Assistant
lib/ai_agent.py - HTTP Client
lib/adafruit_requests.py - Socket Manager
lib/adafruit_connection_manager.py
Device Apps
- Clock
apps/clock/code.py - Paint
apps/paint/code.py - Weather
apps/weather/code.py - Stocks
apps/stocks/code.py - Last.fm
apps/lastfm/code.py - Screensavers
apps/screensaver/code.py - Other Official Apps
apps
Departures App
- Departures App Entry
apps/departures/code.py - Departures State
apps/departures/varinit.py - Departure Processing
apps/departures/functions.py - Transit Data And Text
apps/departures/dicts.py - Display Rendering
apps/departures/createhtml.py - Skin Loader
apps/departures/skinloader.py - Departures Web UI
apps/departures/web.py
Other components
- Device User
- Transit Service
Connections 38
- Device User → Runtime Loop: operates
README.md - Runtime Loop → Settings: loads settings
main.py - Runtime Loop → Matrix Display: uses display
main.py - Runtime Loop → Button Input: checks input
main.py - Runtime Loop → Wi-Fi Manager: connects network
main.py - Runtime Loop → Device Web UI: loads interface
main.py - Runtime Loop → HTTP Router: registers routes
main.py - Boot Setup → Settings: loads settings
boot.py - Matrix Display → Display Fonts: renders text
lib/load_screen.py - Device Web UI → HTTP Router: registers routes
lib/web_interface.py - Device Web UI → File Manager: loads manager
lib/web_interface.py - Device Web UI → AI Assistant: calls assistant
lib/web_interface.py - Wi-Fi Manager → HTTP Router: registers routes
lib/wlan.py - Runtime Loop → Socket Manager: gets SSL context
main.py - Runtime Loop → HTTP Client: creates session
main.py - Runtime Loop → Clock: launches app
main.py - Runtime Loop → Paint: launches app
main.py - Runtime Loop → Weather: launches app
main.py - Runtime Loop → Stocks: launches app
main.py - Runtime Loop → Last.fm: launches app
main.py - Runtime Loop → Screensavers: selects saver
main.py - Runtime Loop → Other Official Apps: loads selected app
main.py - Runtime Loop → Departures App Entry: launches app
- Departures App Entry → Departures State: initializes state
- Departures State → Departure Processing: imports processing
apps/departures/varinit.py - Departures State → Transit Data And Text: loads dictionaries
apps/departures/varinit.py - Departure Processing → Departures State: uses settings
apps/departures/functions.py - Departure Processing → Display Rendering: uses rendering
apps/departures/functions.py - Departure Processing → Transit Data And Text: uses text data
- Departure Processing → Transit Service: retrieves departures
- Departures App Entry → Departures Web UI: serves app UI
- Departures Web UI → Departures State: uses settings
apps/departures/web.py - Departures Web UI → Departure Processing: uses processing
apps/departures/web.py - Departures Web UI → Transit Data And Text: uses dictionaries
apps/departures/web.py - Departures Web UI → Skin Loader: loads skins
apps/departures/web.py - Display Rendering → Departures State: uses state
apps/departures/createhtml.py - Display Rendering → Departure Processing: uses processing
apps/departures/createhtml.py - Display Rendering → Skin Loader: uses skins
apps/departures/createhtml.py