{"id":15651545,"url":"https://github.com/carlosperate/lightuppi-alarm","last_synced_at":"2025-10-06T02:10:38.106Z","repository":{"id":28122307,"uuid":"31621326","full_name":"carlosperate/LightUpPi-Alarm","owner":"carlosperate","description":"Raspberry Pi Alarm Clock with sunrise lighting, coffee machine control, physical snooze button, and Android companion app:","archived":false,"fork":false,"pushed_at":"2019-01-17T17:25:14.000Z","size":1362,"stargazers_count":35,"open_issues_count":4,"forks_count":10,"subscribers_count":10,"default_branch":"master","last_synced_at":"2025-02-25T10:50:44.029Z","etag":null,"topics":["alarm","hardware","lightuppi-alarm","python","raspberry-pi"],"latest_commit_sha":null,"homepage":"http://lightupalarm.embeddedlog.com","language":"Python","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/carlosperate.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":"2015-03-03T21:05:55.000Z","updated_at":"2025-02-11T22:57:40.000Z","dependencies_parsed_at":"2022-08-02T11:01:04.147Z","dependency_job_id":null,"html_url":"https://github.com/carlosperate/LightUpPi-Alarm","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/carlosperate%2FLightUpPi-Alarm","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlosperate%2FLightUpPi-Alarm/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlosperate%2FLightUpPi-Alarm/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/carlosperate%2FLightUpPi-Alarm/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/carlosperate","download_url":"https://codeload.github.com/carlosperate/LightUpPi-Alarm/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242695400,"owners_count":20170751,"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":["alarm","hardware","lightuppi-alarm","python","raspberry-pi"],"created_at":"2024-10-03T12:38:56.789Z","updated_at":"2025-10-06T02:10:33.071Z","avatar_url":"https://github.com/carlosperate.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# LightUpPi Alarm\n\nThis is a Clock Alarm System for the Raspberry PiIt has sunrise lighting, coffee machine control, physical snooze button, and an Android companion app.\n\nIt has been modularised into the following packages:\n\n* __LightUpAlarm__: Completely independent Python package to manage alarms (create, edit, and delete Alarms; can execute a callback function on alarm alert).\n* __LightUpHardware__: Controls external hardware to complement the alarm alert, in this case it controls the room lights, mains socket switch, and snooze functionality from a physical button.\n* __LightUpServer__: Creates an HTTP server to interface with the LightUpAlarm system using a web interface or JSON (used in the LightUpDroid Android app).\n* __LightUpWeb__: Front-end web interface for the LightUpServer. \n\nAdditionally, an Android application can be used to interface with the LightUpPi Alarm system. For more information about this app please visit its repository: [LightUpDroid Alarm][1]\n\n\n## Installing LightUpPi Alarm\n\nThis application has been been develop to run a Raspberry Pi with Python 2.7. The project currently aims to maintain compatibility with Python 3. \n\nInstall the dependencies described below. Then download this repository, by clicking [here][2] or running the following in the command line:\n\n```\ngit clone git://github.com/carlosperate/LightUpPi-Alarm.git\n```\n\n### Software Dependencies\nYou can see the project Python dependencies on the [requirements.txt][3] file.\n\nMore information about specific dependencies can be found in each package README:\n* LightUpAlarm [README][4]\n* LightUpServer [README][5]\n* LightUpHardware [README][6]\n\n### Hardware Dependencies\nThis project uses the following hardware in addition to the Raspberry Pi:\n* [Pimoroni Unicorn Hat][8] for the lamp light\n* [Belkin Wemo Switch][9] for the coffee machine control\n* [Philips Hue][10] for the room light control\n\nNote that the LightUpAlarm package can be used independently as an alarm system software and does not require any additional hardware to run.\n\n## Running LightUpPi Alarm\nThere are three different ways to run LightUpPi Alarm:\n\n1. Using the command line interface only, by launching the application with the `-c` flag:\n\n    ```\n    python main.py -c\n    ```\n    \n    Instructions about how to use the CLI can be found in the LightUpAlarm package [README][4].\n    \n    \u003cimg src=\"https://raw.githubusercontent.com/carlosperate/LightUpPi-Alarm/gh-pages/images/screenshot_cli_1.png\" alt=\"CLI interface\" width=\"75%\"\u003e\n\n2. Using the web interface only, designed to run on a headless system, by launching the program with the `-s` flag:\n\n    ```\n    python main.py -s\n    ```\n    \n    And then pointing your browser to the following adddress: ` http://\u003craspberrypi_ip\u003e/LightUpPi `.\n\n    \u003cimg src=\"https://raw.githubusercontent.com/carlosperate/LightUpPi-Alarm/gh-pages/images/screenshot_web_1.png\" alt=\"Web Interface\" width=\"75%\"\u003e\n\n     You can also use the [LightUpDroid][1] app if the server is running.\n\n    \u003cimg src=\"https://raw.githubusercontent.com/carlosperate/LightUpDroid-Alarm/master/screenshots/clock.png\" alt=\"Clock Screen\" width=\"24%\"\u003e \u003cimg src=\"https://raw.githubusercontent.com/carlosperate/LightUpDroid-Alarm/master/screenshots/alarms.png\" alt=\"Alarms Screen\" width=\"24%\"\u003e \u003cimg src=\"https://raw.githubusercontent.com/carlosperate/LightUpDroid-Alarm/master/screenshots/timepicker.png\" alt=\"Timepicker Screen\" width=\"24%\"\u003e \u003cimg src=\"https://raw.githubusercontent.com/carlosperate/LightUpDroid-Alarm/master/screenshots/settings.png\" alt=\"Settings Screen\" width=\"24%\"\u003e \n\n3. Or having both the command line and the server interface running simultaneously, by launching the program with the `-s` flag:\n\n    ```\n    python main.py -b\n    ```\n\n\n## License\nThis project is licensed under The MIT License (MIT), a copy of which can be found in the [LICENSE][7] file.\n\n[1]: http://github.com/carlosperate/LightUpDroid-Alarm\n[2]: http://github.com/carlosperate/LightUpPi-Alarm/archive/master.zip\n[3]: http://github.com/carlosperate/LightUpPi-Alarm/blob/master/requirements.txt\n[4]: http://github.com/carlosperate/LightUpPi-Alarm/blob/master/LightUpAlarm/README.md\n[5]: http://github.com/carlosperate/LightUpPi-Alarm/blob/master/LightUpServer/README.md\n[6]: http://github.com/carlosperate/LightUpPi-Alarm/blob/master/LightUpHardware/README.md\n[7]: http://raw.githubusercontent.com/carlosperate/LightUpPi-Alarm/master/LICENSE\n[8]: http://shop.pimoroni.com/products/unicorn-hat\n[9]: http://www.belkin.com/uk/p/P-F7C027/\n[10]: http://www.philips.co.uk/c-p/8718291797098/hue-personal-wireless-lighting\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlosperate%2Flightuppi-alarm","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcarlosperate%2Flightuppi-alarm","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcarlosperate%2Flightuppi-alarm/lists"}