An Android app (and home screen widget) that displays sunrise, sunset, civil/nautical/astronomical twilight times for a given location.
App and Widget Features
The app:
- displays the current time, and notes the time until next sunrise, sunset, or civil/nautical/astronomical twilight.
- can set an alarm for next sunrise, sunset, or civil/nautical/astronomical twilight.
- can display the configured location on a map (requires a map application).
- does not require GPS. The location is manually specified by default (and optionally obtained from GPS).
- does not require network connectivity. Calculations are performed locally on the device using.
The widget is themeable and provides:
- a dark theme (and dark w/ transparent background)
- a light theme (and light w/ transparent background)
- a theme editor and support for basic custom themes.
The widget is (re)configurable:
- configure location (latitude / longitude)
- configure timezone
- configure widget theme
- configure user-defined title (supports limited substitutions)
- configure "show noon" and "show comparison"
- configure "comparison mode" (against tomorrow or yesterday)
The widget is resizable and has layouts for:
- a 1x1 widget that displays either the sunrise OR sunset time.
- a 1x1 widget that displays both the sunrise AND sunset times.
- a 1x1 widget that flips between sunrise and sunset times.
- a 2x1 widget that displays the sunrise and sunset times, and displays the difference in the amount of daylight (in minutes) between today and tomorrow (or today and yesterday).
Bug Reports
You can report bugs using the issue tracker. Be aware that times are approximate and may differ from official sources (up to 10 minutes).
When submitting a bug please be detailed and specific. What did you expect the app to do, what did you actually observe? Bugs that can't be reproduced won't get fixed. If reporting inaccurate times include the lat/lon, timezone, and the date. Other useful information includes Android OS version and your specific device model.
Donations
Pay as you like. I want to express my thanks to those who have sent me something. Its a very meaningful gesture.
The goal of this project is an app that is free and open-source (FOSS). The source code is available under GPLv3 (https://github.com/forrestguice/SuntimesWidget).
Icons borrowed from:
- "Google Android Design Icons 20131120" [Apache License 2.0]
- "Google Material Icons" [Apache License 2.0] (https://material.io/icons/)
- "Material Design Icons" [SIL Open Font License 1.1] (https://materialdesignicons.com)
Libraries used:
- Time4A [LGPL-2.1] (http://github.com/MenoData/Time4A)
- ca.rmen.sunrisesunset [LGPL-2.1] (http://github.com/caarmen/SunriseSunset)
- sunrisesunsetlib-java [Apache License 2.0] (http://mikereedell.github.io/sunrisesunsetlib-java/)
- QuadFlask/colorpicker [Apache License 2.0] (https://github.com/QuadFlask/colorpicker)
German translation by Henrik "HerHde" Hüttemann.
Polish and Esperanto translations by Verdulo.
French translation by Jej.
Hungarian translation by Erci.
Contributions to the project are welcome.