{"id":15750582,"url":"https://github.com/chadsr/aurora-server","last_synced_at":"2025-06-10T19:13:07.572Z","repository":{"id":45132769,"uuid":"150739791","full_name":"chadsr/Aurora-Server","owner":"chadsr","description":"A wireless, ESP32 controlled, addressable RGB LED strip server (UDP streaming \u0026 JSON API)","archived":false,"fork":false,"pushed_at":"2022-01-06T08:53:12.000Z","size":32,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-04-01T09:01:31.707Z","etag":null,"topics":["addressable-leds","esp32","esp32-arduino","fastled","json-api","platformio","rgb-led","udp-stream","wifi-led-controller","wireless","wireless-led-controller"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/chadsr.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-28T12:49:40.000Z","updated_at":"2024-11-20T23:07:40.000Z","dependencies_parsed_at":"2022-09-24T20:22:27.751Z","dependency_job_id":null,"html_url":"https://github.com/chadsr/Aurora-Server","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadsr%2FAurora-Server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadsr%2FAurora-Server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadsr%2FAurora-Server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadsr%2FAurora-Server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chadsr","download_url":"https://codeload.github.com/chadsr/Aurora-Server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chadsr%2FAurora-Server/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259132744,"owners_count":22810507,"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":["addressable-leds","esp32","esp32-arduino","fastled","json-api","platformio","rgb-led","udp-stream","wifi-led-controller","wireless","wireless-led-controller"],"created_at":"2024-10-04T06:41:21.555Z","updated_at":"2025-06-10T19:13:07.521Z","avatar_url":"https://github.com/chadsr.png","language":"C++","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Aurora Server (ESP32)\n[![Build](https://github.com/Chadsr/Aurora-Server/actions/workflows/build.yml/badge.svg)](https://github.com/Chadsr/Aurora-Server/actions/workflows/build.yml)\n### A wireless, ESP32 controlled, addressable RGB LED strip server (UDP streaming \u0026amp; JSON API)\n\n## Setup\n### 1.\n```\ngit clone git@github.com:Chadsr/Aurora-Server.git\ncd Aurora-Server/\n```\n\n### 2. Configure\n#### 2.1 Setup network credentials\nEdit `src/main.h` with your wireless network AP (2.4Ghz) SSID and password.\n\n#### 2.2 Setup LED quantity and data pin\nEdit `LED_PIN` and `NUM_LEDS` in `src/leds.h`, to reflect your setup.\n\n## Compilation \u0026 Upload\n\n### 1. Using PlatformIO\nConnect your device via usb and run:\n```\nplatformio run --target upload\n```\n\n## API Endpoints\n\n| Endpoint       | Type   | Description                                                                   | Example Return Value |\n| -------------- | ------ | ----------------------------------------------------------------------------- | -------------------- |\n| `/leds`        | `GET`  | Returns a count of the available induvidual LEDs                              | `{\"count\": 720}`     |\n| `/leds`        | `POST` | Accepts a list of RGB colour assignments for sequences of LEDs \u003csup\u003e[1]\u003c/sup\u003e | `{\"success\": true}`  |\n| `/leds/toggle` | `POST` | Toggles all configures LEDs on/off                                            | `{\"success\": true}`  |\n\n### Example Request: \u003csup\u003e[1]\u003c/sup\u003e\n```\n{\n  \"clearPrevious\": true, \n    \"sections\": [\n      {\n            \"r\": 50,\n            \"g\": 255,\n            \"b\": 0,\n            \"startPosition\": 1,\n            \"endPosition\": 240\n        },\n        {\n            \"r\": 100,\n            \"g\": 100,\n            \"b\": 100,\n            \"startPosition\": 241,\n            \"endPosition\": 480\n        },\n              {\n            \"r\": 0,\n            \"g\": 255,\n            \"b\": 0,\n            \"startPosition\": 481,\n            \"endPosition\": 720\n        }\n    ]\n}\n```\n### clearPrevious\nA boolean value specifying whether previous LED assignments should be reset (turned off) or if the request should be applied directly.\n### sections\nA list of colour sequences\n#### r, g, b\nUnsigned integer colour values representing an RGB colour.\n#### startPosition\nThe LED index to start applying the given colour to.\n#### endPosition\nThe LED index to finish applying the given colour to.\n\n## UDP Streaming\n*UDP streaming is still experimental and has not been tested. Development of a client application can be found in [this repository](https://github.com/Chadsr/Aurora-Client).*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchadsr%2Faurora-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchadsr%2Faurora-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchadsr%2Faurora-server/lists"}