{"id":23386944,"url":"https://github.com/ztkent/sunlight-meter","last_synced_at":"2026-05-06T04:05:55.830Z","repository":{"id":268285808,"uuid":"903804957","full_name":"ztkent/sunlight-meter","owner":"ztkent","description":"Monitor daily light conditions","archived":false,"fork":false,"pushed_at":"2025-01-15T03:32:23.000Z","size":23,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-02-14T08:37:05.909Z","etag":null,"topics":["android","golang","htmx","raspberry-pi","tsl25911"],"latest_commit_sha":null,"homepage":"","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ztkent.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}},"created_at":"2024-12-15T15:52:04.000Z","updated_at":"2025-01-15T03:32:25.000Z","dependencies_parsed_at":null,"dependency_job_id":"f0fd84a9-80ea-4e58-92b9-4ff66253350f","html_url":"https://github.com/ztkent/sunlight-meter","commit_stats":null,"previous_names":["ztkent/sunlight-meter"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ztkent%2Fsunlight-meter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ztkent%2Fsunlight-meter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ztkent%2Fsunlight-meter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ztkent%2Fsunlight-meter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ztkent","download_url":"https://codeload.github.com/ztkent/sunlight-meter/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247842600,"owners_count":21005311,"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":["android","golang","htmx","raspberry-pi","tsl25911"],"created_at":"2024-12-22T01:13:54.380Z","updated_at":"2025-04-08T12:33:14.539Z","avatar_url":"https://github.com/ztkent.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Sunlight Meter\nUsing the Adafruit TSL2591 Digital Light Sensor and a Raspberry Pi to monitor daily sunlight conditions.  \n\n## About\nThe [TSL2591](https://www.adafruit.com/product/1980) is a high dynamic range digital light sensor.  \nIt can detect infrared, full-spectrum and human-visible light, then transmit that data over a serial connection.   \n\nFeatures:  \n- Monitors the current light conditions.\n- Reports real-time data for monitoring or automation.\n- Saves historical data to give insight on changes over time.\n- Provides a dashboard to control the sensor and visualize data.\n- Determines if your location is: ☁️ shade, partial shade, partial sun, or full sun ☀️\n\n## How it works\n### Configuration: \nThe TSL2591 sensor is connected to a Raspberry Pi via i2c.  \nConnecting the sensor to the Pi:\n- Vin to 3.3V\n- GND to GND\n- SDA to SDA\n- SCL to SCL\n\nSunlight Meter automatically adjusts sensor gain and integration time.  \nThis helps ensure accurate readings and avoid saturation in high light conditions.  \n\n### API:\nSunlight Meter runs an API that allows remote access to the sensor data and jobs.  \nConnect remotely to:\n- Start/Stop any recording job.\n- Receive real-time readings and light conditions. \n- Download historical data as a SQLite DB.\n- Check device wifi-signal strength.\n\n### Dashboard:\nThe dashboard is a web app that displays the current light conditions and historical data.  \n- Visualize historical light conditions\n- Control the sensor\n- Export the results\n\n## Understanding Lux Values\nFrom https://en.wikipedia.org/wiki/Lux:  \n| Illuminance (lux) | Surfaces illuminated by |\n| --- | --- |\n| 0.0001 | Moonless, overcast night sky (starlight) |\n| 0.002 | Moonless clear night sky with airglow |\n| 0.05–0.3 | Full moon on a clear night |\n| 3.4 | Dark limit of civil twilight under a clear sky |\n| 20–50 | Public areas with dark surroundings |\n| 50 | Family living room lights |\n| 80 | Office building hallway/toilet lighting |\n| 100 | Very dark overcast day |\n| 150 | Train station platforms |\n| 320–500 | Office lighting |\n| 400 | Sunrise or sunset on a clear day |\n| 1000 | Overcast day; typical TV studio lighting |\n| 10,000–25,000 | Full daylight (not direct sun) |\n| 32,000–100,000 | Direct sunlight |","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fztkent%2Fsunlight-meter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fztkent%2Fsunlight-meter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fztkent%2Fsunlight-meter/lists"}