{"id":18400634,"url":"https://github.com/lenaschimmel/bestelampe","last_synced_at":"2025-10-13T17:39:20.027Z","repository":{"id":219883197,"uuid":"734864397","full_name":"lenaschimmel/bestelampe","owner":"lenaschimmel","description":"Die beste Lampe","archived":false,"fork":false,"pushed_at":"2025-03-26T10:35:40.000Z","size":80026,"stargazers_count":18,"open_issues_count":2,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-07-23T19:33:23.607Z","etag":null,"topics":["esp32","lamp","led","light","openhardware","pwm"],"latest_commit_sha":null,"homepage":"","language":"Rust","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/lenaschimmel.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"license/CC-BY-SA-4.0.txt","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":"2023-12-22T21:06:43.000Z","updated_at":"2025-07-04T14:47:10.000Z","dependencies_parsed_at":"2024-11-06T03:14:20.363Z","dependency_job_id":null,"html_url":"https://github.com/lenaschimmel/bestelampe","commit_stats":null,"previous_names":["lenaschimmel/bestelampe"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/lenaschimmel/bestelampe","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lenaschimmel%2Fbestelampe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lenaschimmel%2Fbestelampe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lenaschimmel%2Fbestelampe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lenaschimmel%2Fbestelampe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/lenaschimmel","download_url":"https://codeload.github.com/lenaschimmel/bestelampe/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/lenaschimmel%2Fbestelampe/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279016369,"owners_count":26085828,"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","status":"online","status_checked_at":"2025-10-13T02:00:06.723Z","response_time":61,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["esp32","lamp","led","light","openhardware","pwm"],"created_at":"2024-11-06T02:35:32.617Z","updated_at":"2025-10-13T17:39:19.989Z","avatar_url":"https://github.com/lenaschimmel.png","language":"Rust","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003c!--\nSPDX-FileCopyrightText: 2024 Lena Schimmel \u003cmail@lenaschimmel.de\u003e\nSPDX-License-Identifier: CC-BY-SA-4.0\n\n[besteLampe!](https://lenaschimmel.de/besteLampe!) © 2024 by [Lena Schimmel](mailto:mail@lenaschimmel.de) is licensed under [CC BY-SA 4.0](http://creativecommons.org/licenses/by-sa/4.0/?ref=chooser-v1)\n--\u003e\n\n\u003c!-- *Apart from this README, most documentation and notes are in German. If this project becomes more than a proof-of-concept, all important parts the documentation will be translated to English. The name will remain German, as it should be understandable to English speakers as well.* --\u003e\n\n![Header image with PCB closeup](assets/header.jpg)\n\n## besteLampe!\n**Most lamps suck. This is an open source hardware and software project to create not only a better lamp, but the best lamp(s). Or *\"besteLampe(n)!\"* as we say in German.**\n\nOf course, there are **many** kinds of lamps, and for some use cases, better alternatives exist. This one is created with two main use cases in mind:\n - indoor lamp for general room lighting and as a sunrise alarm clock \n - outdoor lamp in front of apartments (called ABL, see below)\n\nThe first case involves more direct, manual control of a single lamp, and the second case is more about automatic control (time based, responding to movement, linked with nearby lamps). Anyway, the lamp in each use case will sometimes be operated *just like in the other use case*, so both have mostly the same requirements, just with different priorities.\n\n## Structure of this repository\nThis project started out with a lot of experimental modules, see [experiments.md](./experiments.md) for information about those.\n\nCurrent development is focused on the Access Balcony Lamp (ABL), see [hardware/abl](./hardware/abl/) for more information.\n\nDevelopment on indoor lamps may continue once the ABL is finished.\n\nThe repository is currently undegoing some restructuring to make it clearer which parts are outdated, active or for future applications.\n\n## What makes ~~a good~~ the best lamp?\nThese are the design goals of *besteLampe!* \n\n - **Free and Open** • open hardware, open software, open protocols\n - **State-of-the-art dimming** • Flicker free, smooth dimming, extremely wide contrast ratio (a.k.a \"dim to zero\"), independent dimming of color and brightness. (See  [\"The problem with driving LEDs with PWM\"](https://codeinsecurity.wordpress.com/2023/07/17/the-problem-with-driving-leds-with-pwm/) by Graham to understand what's so hard about that.)\n - **Premium color control** • Use as many color channels as needed to extend the color gamut and achieve good color quality in a reasonable range of colors. (See [the wiki page \"Colors\"](https://github.com/lenaschimmel/bestelampe/wiki/Colors) for the complexities involved)\n - **Smart, but not smart-ass** • Offers a wide range of wireless connection option, but is also a good, usable device when it's only connection is to the power grid.\n - **Cost efficient** • Should be less expensive than off-the-shelf smart lamps, even if they lack most of its features.\n - **Versatile** • Can be used for many different applications.\n - **Modular** • Provide many features, but not absurdly many, on the base module.\n - **Mains operated, but low voltage DC** • Don't mess with deadly AC.\n - **Power efficiency** • mostly by dimming and switching off.\n - **React to motion and presence** • IR-sensors can only detect motion, so a microwave- or mmwave-sensor must be supported.\n - **Hackable** • Over the air update, flash software and view logs via USB or UART. Pins for future expansions.\n - **Insect friendly** • Reduce the amount of light at night and offer insect friendly spectrum options.\n - **Sleep cycle aware** • Dim lights and avoid blue wavelength at night.\n - **Durable** • Should be usable for decades. Possibility to repair or replace individual parts or modules. Monitor it's own state and send warnings.\n - **Reliable** • Handle outages gracefully, no matter if power outage, network problems or minor component defects.\n - **Fun** • When all the important features are done, add some nice extras. Blinkenlighs-like light shows? UV light? Light based games? Let's do it!\n\n## Not-to-do-list\n - Battery charging, photovoltaic, etc.\n - Addressable LEDs. There is a pin called \"Neopixel\" but that's not really a design priority, since most addressable LEDs lack in light quality (dimming steps, CRI, flicker)\n\n## License\nThe besteLampe! is open hardware: \n\n- The hardware design is licensed under [CERN-OHL-S v2](https://ohwr.org/cern_ohl_s_v2.txt) or any later version.\n- The software is licensed under [GNU General Public Licence v3.0](https://creativecommons.org/licenses/by-sa/4.0/legalcode) or later\n- The documentation is licensed under [Creative Commons Attribution Share Alike 4.0 International](https://creativecommons.org/licenses/by-sa/4.0/)\n\n\u003cimg src=\"assets/oshw_facts.svg\" width=\"20%\" /\u003e\n\nSee the [license](./license) directory for more details.","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flenaschimmel%2Fbestelampe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Flenaschimmel%2Fbestelampe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Flenaschimmel%2Fbestelampe/lists"}