{"id":21002514,"url":"https://github.com/pimatic/pimatic-sunrise","last_synced_at":"2025-05-15T00:31:12.935Z","repository":{"id":15946533,"uuid":"18688938","full_name":"pimatic/pimatic-sunrise","owner":"pimatic","description":"pimatic plugin for events on sunrise, sunset and more.","archived":false,"fork":false,"pushed_at":"2019-07-26T19:10:43.000Z","size":108,"stargazers_count":2,"open_issues_count":3,"forks_count":7,"subscribers_count":6,"default_branch":"master","last_synced_at":"2024-11-06T14:51:43.176Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"CoffeeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pimatic.png","metadata":{"files":{"readme":"README.md","changelog":"HISTORY.md","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":"2014-04-11T21:14:05.000Z","updated_at":"2019-03-17T16:24:18.000Z","dependencies_parsed_at":"2022-08-30T14:10:32.247Z","dependency_job_id":null,"html_url":"https://github.com/pimatic/pimatic-sunrise","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/pimatic%2Fpimatic-sunrise","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimatic%2Fpimatic-sunrise/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimatic%2Fpimatic-sunrise/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pimatic%2Fpimatic-sunrise/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pimatic","download_url":"https://codeload.github.com/pimatic/pimatic-sunrise/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225316759,"owners_count":17455311,"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":[],"created_at":"2024-11-19T08:18:58.828Z","updated_at":"2024-11-19T08:18:59.357Z","avatar_url":"https://github.com/pimatic.png","language":"CoffeeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# pimatic sunrise Plugin\n\nEvents for sunrise, sunset and more.\n\n    {\n      \"plugin\": \"sunrise\",\n      \"latitude\": 37.371794,\n      \"longitude\": -122.03476\n    }\n\nThe Plugin uses [suncalc](https://github.com/mourner/suncalc). The following events are supported:\n\n  * `sunrise`: sunrise (top edge of the sun appears on the horizon)\n  * `sunriseEnd`: sunrise ends (bottom edge of the sun touches the horizon)\n  * `goldenHourEnd`: morning golden hour (soft light, best time for photography) ends\n  * `solarNoon`: solar noon (sun is in the highest position)\n  * `goldenHour`: evening golden hour starts\n  * `sunsetStart`: sunset starts (bottom edge of the sun touches the horizon)\n  * `sunset`: sunset (sun disappears below the horizon, evening civil twilight starts)\n  * `dusk`: dusk (evening nautical twilight starts)\n  * `nauticalDusk`: nautical dusk (evening astronomical twilight starts)\n  * \u003cs\u003e`night`: night starts (dark enough for astronomical observations)\u003c/s\u003e\n  * \u003cs\u003e`nightEnd`: night ends (morning astronomical twilight starts)\u003c/s\u003e\n  * `nauticalDawn`: nautical dawn (morning nautical twilight starts)\n  * `dawn`: dawn (morning nautical twilight ends, morning civil twilight starts)\n  * `nadir`: nadir (darkest moment of the night, sun is in the lowest position)\n  \nNote: `night` and `nightEnd` have been deprecated as these events yield invalid results for several \n locations due to a bug in the underlying suncalc package. The `night starts` and `night ends` predicates \n are also affected. \n\n## Device Configuration\n\nOptionally, you can setup a `SunriseDevice` to get sunlight times displayed for a given location. If no location is \nprovided with the device configuration the location given with the plugin configuration applies. The `attributes` \nproperty is used to define which sunlight-related attributes shall be exposed by the device. The name given for an \nattribute is one of the sunlight event names listed above. \n\nIf a label text is set for an attribute the text will be used as an acronym for the attribute on display. Otherwise, the \nacronym will be constructed from the event name. If the label text is an empty string no acronym will be displayed.\n\nIf you wish to obtain the times in the timezone of the location at the given coordinates you can \nadditionally set the `timezone` property. This will transform the times to the given timezone and will cut off \nthe timezone offsets before converting the resulting times to the localized time string. For a list of valid \"TZ\" \ntimezone strings, see [Wikipedia - List of Timezones](https://en.wikipedia.org/wiki/List_of_tz_database_time_zones). \n\nIf the `timezone` property is absent or the property is set to an empty string no transformation will be performed. \nAdditionally, it is possible to set a `utcOffset` offset time in hours relative to the `timezone`. \nThis is useful for example if you wish to neglect daylight savings, i.e. you can set the `timezone`to `UTC` \nand provide the required `utcOffset` value. \n\nNote, by default, all times will be given in the local time zone of the system on which pimatic is installed. If you \nwish to use a different timezone, e.g. universal time to neglect daylight savings, you can set the `localTimezone` \nand `localUtcOffset` properties. However, these properties are only applicable if the `timezone` property has been set.\n\n    {\n          \"id\": \"sunrise-1\",\n          \"class\": \"SunriseDevice\",\n          \"name\": \"Sunrise\",\n          \"latitude\": 52.5072111,\n          \"longitude\": 13.1449592,\n          \"attributes\": [\n            {\n              \"name\": \"sunrise\",\n              \"label\": \"Sunrise Time\"\n            },\n            {\n              \"name\": \"sunset\",\n              \"label\": \"Sunset Time\"\n            }\n          ]\n    }","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpimatic%2Fpimatic-sunrise","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpimatic%2Fpimatic-sunrise","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpimatic%2Fpimatic-sunrise/lists"}