Skip to content

Where to go next

You have a running Lightnet installation. From here, what you read depends on what you want to do.

  • Build your own scenes


    The animation framework — palettes, layers, groups, color references, reactive music triggers, and every JSON field.

    Firmware → Animations & Scenes

  • Drive Lightnet from your own code


    Full HTTP and WebSocket reference, including the 14-byte binary packet format and CRC algorithm.

    Firmware → API Reference

  • Understand the internals


    Two-binary source layout, library structure, I²C protocol, discovery sequence, controller boot.

    Firmware → Architecture

  • Hack on the mobile app


    Package layout, the device domain layer, the Compose visualiser, and the DemoConnector test harness.

    App → Development

  • Manage updates


    Panel OTA via twiboot, serial firmware upload, and controller self-update over ArduinoOTA.

    Firmware → OTA & Updates

  • Something broken?


    Debug macros, common symptoms, and how to inspect panel state over WebSocket.

    Firmware → Troubleshooting

Quick reference

  • Glossary — every term Lightnet uses, in one place
  • FAQ — common questions about scope, networking, panels-per-controller, and the API
  • Release notes — version history (placeholder until releases ship)

Contribute

Lightnet is open source under GPL-3.0. Three repositories:

Repo What lives there
lightnet This documentation hub
lightnet-firmware Controller + panel firmware
lightnet-mobile Kotlin Multiplatform app

Issues and pull requests are welcome on all three.