release 0.15.0

[forrestguice]

• adds "Welcome Dialog"; a guided introduction and initial configuration wizard (closes First Time Install Experience #603).
• adds "High Contrast" app themes (Quite a few custom theme settings not working #492, Mad defaults on install #615); changes default theme to "System default" (closes [Feature request] Set "system default" theme by default #666).
• adds "Text Size" setting; display "small", "normal", "large", or "extra-large" text (closes Quite a few custom theme settings not working #492, closes Mad defaults on install #615, closes [Feature request] enlarge font size #622, closes [Feature request] Accessibility issues in GUIs #656).
• adds support for "Quick Settings" tiles; show information in the settings tray; "clock tile" and "next event tile" (closes [feature request] Solar time in status bar #399).
• adds support for "Cross-Quarter Days" (closes Feature Request: Add cross-quarter day dates/times #551); solstice and equinox midpoints.
• adds support for custom sun elevation events. Show custom events from a widget, or use them to schedule alarms and notifications (closes Hoping for more detailed Notifications and offset by the degree of elevation of the sun #522, closes Feature Request: Custom Offset +- to Sunset #537, closes Custom sun elevation angle -event [Feature request] #598).
• adds "date" widget; show the date using different calendars (Coptic, Ethiopian, Gregorian, Hebrew, Julian, Solar Hijiri, Thai Solar) (closes [feature request] Solar Hijiri Calendar #398); adds "date" option to clock widget (Gregorian).
• adds support for "Quick Notifications" (closes Ephemeral notifications #552); notifications are automatically dismissed after a few moments.
• adds alarm "note"; show user-defined text as part of notifications and other UI; supports %s substitutions.
• adds alarm "snooze limit" option; defaults to "no limit".
• adds support for alarm challenges (and addons); dismiss alarms after solving "easy math" problems; dismiss alarms with an NFC tag (https://github.com/forrestguice/SuntimesNFC).
• adds alarm "reminder" option (closes Various alarm issues #628), and "reminder action" option; notifications may perform a custom action when dismissed.
• increments alarm database version 3 -> 4; adds "note", "flags", "actionID2", and "actionID3" columns.
• enhances alarm cards; list UI now indicates state, animates sounding and snoozing states, and displays action buttons when applicable.
• adds alarm list sort options; "Enabled First", "Show Offsets" (closes Confusing UX on alarm list #611, closes Alarm list sorting question (0.14.7) #618); adds "Clear Selection" button.
• adds "Altitude Graph" to Sun Position dialog; adds 3x2 "Altitude Graph" to sun position widgets (closes Findings after the summer season #625).
• adds "Seek Altitude" to Sun Position dialog (Findings after the summer season #625); jump to sunrise, sunset, noon, or user-defined sun elevation.
• changes the main card to display moon illumination as a range (closes Inconsistent moon illumination numbers #384, closes Displays moon as 100%@0:08 for two consecutive nights #572).
• adds Moon dialog playback controls; step forward/back by 5m increments.
• adds "lunar noon" and "lunar midnight" to Moon dialog; enhances rise/set view (swipe-able, seeks forward/back).
• adds "moon day" widget (closes the moon day #345); show number of days since the new moon.
• adds "Emphasize Field" to User Interface settings; enlarges text displayed by main table ([Feature request] enlarge font size #622, Mad defaults on install #615).
• removes "Set Date" dialog; replaced with "View Date" (Sun/Moon Drop-downs show wrong data #613); cards now seek to date instead of (re)centering.
• enhances solstice/equinox card (swipe-able, cross-quarter dates).
• adds 3x1 sun widget (Widget width and layout tweaks #423); an expanded version of the 2x1 widget.
• adds "use app time zone" widget option.
• adds TimeZone dialog preview; replaces TimeZone dialog sort action mode with a context menu.
• misc dialog improvements; changes to Location, Date, and TimeZone dialog layouts.
• misc settings; "object shadow" moved from "General" to "User Interface".
• fixes bug "sun/moon drop-downs show wrong data" (closes Sun/Moon Drop-downs show wrong data #613).
• fixes bug "sun position is out of alignment" (closes sun position is out of alignment #601).
• fixes bug where already enabled alarms fail to reschedule after modifying alarm details (#TODO).
• fixes tooltip help (now available for all buttons); press and hold to display help.

[forrestguice]

Adding code means adding bugs.
I'm releasing v0.15.0 as it is.

I think this could use more testing, but I'm running low on energy.. Time to recharge.
If I've missed something obvious (hope not), it can always be fixed in the next patch.

[jackthebean]

Great load of improvements. Thanks for all the work.

[jackthebean]

Thanks for all the improvements.

However looking at below:

I cannot work out what the marked bit shows and cannot see anywhere that describes it.

Also in the help page the descriptions are a bit unclear. Clearer are those at

www.weather.gov

Twilight Types

🔗 https://www.weather.gov/lmk/twilight-types

which make it clearer that civil twilight is, for example, a period between 6 and 12 degrees below horizon rather than just at 6 degrees.

It would be good to have option to put back those timings eg nautical and astronomical twilights which have disappeared from the standard view.

Oddity: When I tap on day length icon near bottom of default page it shows different days. Today is 13th Feb and if I tap on it it shows data for 13th, if I change main screen to 12th it still shows 13th, change main screen to 11th and tapping on day length bar bring up data for 11th. Same if going into the future. 14th shows 13th and 15th shows 15th.

See below

[forrestguice]

Hi. I was just about to tag the next patch, and saw this (normally responses aren't so quick ;)

I cannot work out what the marked bit shows and cannot see anywhere that describes it.

0.93 m is the object height, 2.79 m is the shadow length, and 2.07 m is shadow length at noon. Click : -> Object Shadow to change the object height (or click that area). There should also be a line mentioning it from : -> Help.

It would be good to have option to put back those timings eg nautical and astronomical twilights which have disappeared from the standard view.

These were removed from defaults after receiving some (blistering) criticism about the table being overcrowded. You can restore them from Settings -> User Interface -> Nautical Twilight, etc.

which make it clearer that civil twilight is, for example, a period between 6 and 12 degrees below horizon rather than just at 6 degrees.

This is actually nautical twilight (6 to 12 degrees). In the morning, civil twilight begins at 6 degrees, and ends at sunrise (0), and vice versa in the evening (beings at sunset (0), ends at 6 degrees). The "note area" ("2h 11m until noon" (next to clock)) makes some attempt to clarify, by using phrases "until civil twilight" in the morning, and "until end civil twilight" in the evening. Agreed it is still confusing if you aren't already familiar with the domain.

Oddity: When I tap on day length icon near bottom of default page it shows different days. Today is 13th Feb and if I tap on it it shows data for 13th, if I change main screen to 12th it still shows 13th, change main screen to 11th and tapping on day length bar bring up data for 11th. Same if going into the future. 14th shows 13th and 15th shows 15th.

Good catch. This seems like something left over from the previous implementation - the "yestderday/today/tomorrow" are a special case (for a reason I can no longer remember) - they are passing the same date (today) when opening the dialog.

[forrestguice]

That "oddity" is something to be fixed with v0.15.2.
We can expand the help too. It is intentionally brief, but another sentence wouldn't hurt. It needs to communicate that the morning times (rising times) indicate the start of twilight, while evening times indicate its end.

[forrestguice]

Reading this once more (because I rush sometimes)..

In that first screenshot, it indicates an infinite shadow, maybe a funny way of saying the sun is below the horizon.
That part of the dialog has been a bit of an undocumented feature for awhile. The help dialog (and the line explaining the icon) are recent additions.

[jackthebean]

As you say - a very quick response!

Sorry I may be being dim but what is the object that has a height of 0.93m? Is this just a ' an object 0.93m tall would have a shadow.....' ? Why 0.93m? Thought it might be exact imperial unit but isn't. Nothing about it on the help page.

Will try to write a version update for the help if that would be useful. And will get civil twilight right!
Thanks for the rest.

[forrestguice]

Is this just a ' an object 0.93m tall would have a shadow....

Yes, this - just some object. I think the most useful value is probably your own height. Units should be metric by default, but this can be changed from Settings -> General.

Why 0.93m?

I'm not sure, but I'm guessing at some point while exploring the UI the height slider was dragged. The default value should be 6ft (~1.83 m).

[jackthebean]

Pretty sure that I never changed the height slider but have now. Thanks for the explanation.