{"id":22529668,"url":"https://github.com/imjah/bulbs","last_synced_at":"2026-05-08T03:38:24.098Z","repository":{"id":190967665,"uuid":"631387318","full_name":"imjah/bulbs","owner":"imjah","description":"Ambient lighting system","archived":false,"fork":false,"pushed_at":"2025-01-23T17:46:40.000Z","size":2438,"stargazers_count":1,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-08-17T13:38:24.175Z","etag":null,"topics":["ambient-light","flutter","micropython"],"latest_commit_sha":null,"homepage":"","language":"Dart","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/imjah.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,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2023-04-22T21:35:10.000Z","updated_at":"2025-04-22T02:56:39.000Z","dependencies_parsed_at":"2025-11-15T02:02:47.732Z","dependency_job_id":null,"html_url":"https://github.com/imjah/bulbs","commit_stats":null,"previous_names":["imjah/bulbs"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/imjah/bulbs","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjah%2Fbulbs","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjah%2Fbulbs/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjah%2Fbulbs/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjah%2Fbulbs/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/imjah","download_url":"https://codeload.github.com/imjah/bulbs/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/imjah%2Fbulbs/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32765840,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-08T02:36:36.067Z","status":"ssl_error","status_checked_at":"2026-05-08T02:36:07.210Z","response_time":54,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["ambient-light","flutter","micropython"],"created_at":"2024-12-07T07:16:05.892Z","updated_at":"2026-05-08T03:38:24.081Z","avatar_url":"https://github.com/imjah.png","language":"Dart","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Bulbs\n\nNot mature yet project of RGB lights that can be controlled from your phone or local terminal.\n\n![schema](.github/demo/schema.webp)\n\n# Applications\n\nThere are several clients available.\n\n## bulbs-tui\n\nTUI application written in rust created by [@mtvrsh](https://github.com/mtvrsh).\n\n[Source](https://github.com/mtvrsh/bulbs-tui)\n\n## bulbs-cli\n\nCLI application written in python.\n\n[Source](app-cli)\n\n# Driver API\n\n| Method  | Endpoint                                             | Usage                | Returns                                       |\n| ------- | ---------------------------------------------------- | -------------------- | --------------------------------------------- |\n| **GET** | `/led`                                               | Get LED status       | [status](#status-object)                      |\n| **GET** | `/led/on`                                            | Get LED power status | `true` if LED power is ON, `false` otherwise  |\n| **PUT** | `/led/on`                                            | Power on LEDs        |                                               |\n| **GET** | `/led/off`                                           | Get LED power status | `true` if LED power is OFF, `false` otherwise |\n| **PUT** | `/led/off`                                           | Power off LEDs       |                                               |\n| **GET** | [`/led/color`](#get-ledcolor)                        | Get LED color        | [color](#color-object)                        |\n| **PUT** | [`/led/color/{value}`](#put-ledcolorvalue)           | Set LED color        |                                               |\n| **GET** | [`/led/brightness`](#get-ledbrightness)              | Get LED brightness   | [brightness](#brightness-object)              |\n| **PUT** | [`/led/brightness/{value}`](#put-ledbrightnessvalue) | Set LED brightness   |                                               |\n\n## Installation\n\nMake sure you have `just`, `python` and `pip` installed. From [api](api) directory:\n\n1. Install dependencies\n\n```bash\njust\n```\n\n2. [Flash](https://docs.micropython.org/en/latest/esp8266/tutorial/intro.html) MicroPython on your ESP8266 board\n\n```bash\n# Your board should be accessible from /dev/ttyUSB0 \n\njust flash \u003cyour-firmware-release.bin\u003e\n```\n\n3. Install API\n\n```bash\njust sync\n```\n\n4. Reboot the board\n\n## Usage\n\n### **GET** `/led/color`\n\n**Request**\n\nNo parameters needed.\n\n**Response**\n\nOn success, `200 OK` and [`color`](#color-object) object.\n\n**Example**\n\nRequest\n\n```sh\ncurl http://$DEVICE_IP/led/color\n```\n\nResponse `200 OK`\n\n```json\n{\n\t\"color\": \"#000000\"\n}\n```\n\n### **PUT** `/led/color/{value}`\n\n**Request**\n\n`Value` as hex color without leading `#`.\n\n**Response**\n\nOn success, `200 OK`.\n\nOn invalid input, `400 Bad Request` with [message](#message-object) object.\n\n**Example**\n\nRequest\n\n```sh\ncurl -X PUT http://$DEVICE_IP/led/color/5a1010\n```\n\nResponse `200 OK`\n\n### **GET** `/led/brightness`\n\n**Request**\n\nNo parameters needed.\n\n**Response**\n\nOn success, `200 OK` and [`brightness`](#brightness-object) object.\n\n**Example**\n\nRequest\n\n```sh\ncurl http://$DEVICE_IP/led/brightness\n```\n\nResponse `200 OK`\n\n```json\n{\n\t\"brightness\": 1.0\n}\n```\n\n### **PUT** `/led/brightness/{value}`\n\n**Request**\n\n`Value` as number from `0` to `1`.\n\n**Response**\n\nOn success, `200 OK`.\n\nOn invalid input, `400 Bad Request` with [message](#message-object) object.\n\n**Example**\n\nRequest\n\n```sh\ncurl -X PUT http://$DEVICE_IP/led/brightness/0.5\n```\n\nResponse `200 OK`\n\n---\n\n### Status object\n\n| Key        | Value type | Value description  |\n| ---------- | ---------- | ------------------ |\n| on         | boolean    | Power state        |\n| color      | string     | Hex color          |\n| brightness | float      | Number from 0 to 1 |\n\n### Color object\n\n| Key       | Value type | Value description |\n| --------- | ---------- | ----------------- |\n| color     | string     | Hex color         |\n\n### Brightness object\n\n| Key        | Value type | Value description  |\n| ---------- | ---------- | ------------------ |\n| brightness | float      | Number from 0 to 1 |\n\n### Message object\n\n| Key       | Value type | Value description      |\n| --------- | ---------- | ---------------------- |\n| message   | string     | Activities description |\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimjah%2Fbulbs","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fimjah%2Fbulbs","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fimjah%2Fbulbs/lists"}