TPE for Desktop (Legacy Adobe AIR app): Release Notes

Version history

1.1.2 (July 12 2014)


  • Adds notice regarding software end of life
  • Adds link to replacement web app
  • Permits export of locations even if map has not initialized


  • Automatic update will fail, due to a certificate mismatch
  • To install, uninstall your current version (re-run the .air installer file and choose uninstall)
  • Download the 1.1.2 update here:
  • Double-click tpe_1_1_2.air to manually install the new version
  • Your saved locations are unaffected by uninstalling your current version, but if in doubt, export to KML first

1.1.1 (December 23 2011)

New features:

  • Secondary map pin can be positioned at a saved location (use Alt/Option + Go or Alt/Option + double click on saved location coordinates)
  • Primary map pin coordinates are now shown in a suitable format to paste directly into other applications (e.g. Google Maps) when selected


  • Double clicking the map no longer recentres the primary pin, for consistency with TPE for mobile apps. You can still recentre the pin by pressing C on the keyboard.
  • Secondary pin does not reposition on change of primary position as long as it remains visible on the map


  • Secondary elevation queries used AsterGDEM in preference to SRTM: set back to use SRTM as first choice source
  • Moon phase event timing could be incorrect by 30 minutes in areas with timezones that are fractions of hours (e.g. India, +5.5 hours)
  • Typos in glossary and tool tips

1.1.0 (November 26 2011)

New features:

  • Export selected locations to KML (for use in other programs, e.g. Google Earth)
  • Import locations from KML (e.g. placemarks generated using Google Earth)
  • Waxing crescent moon data now shows best observation time


  • “Interesting” days logic improved to reduce false negatives


  • Timezone database for Europe and Russia updated
  • Program starts set to today for local system timezone (was UTC)

1.0.6 (June 5 2011)


  • Extended azimuth lines would shift slightly in 1.0.5 – fixed here (thanks to Steven Christenson)
  • Azimuth lines drawn as geodesics again (was broken in 1.0.5)
  • Some dates/locations would draw incorrect sun azimuth lines (e.g Svalbard, April 14 2010)


  • Moon information now includes waning/waxing crescent/gibbous description
  • Waxing crescent moon visibility now calculated and displayed
  • “Interesting” moon days now excludes dates when new moon is not visible
  • Secondary marker drawn in higher contrast on satellite/hybrid map types

1.0.5 (January 21 2011)


  • Updates GeoNames web services to use updated URLs
  • Improved handling of GeoNames web service errors and performance degradation
  • Terms of use and copyright notice updated

1.0.4 (December 20 2009)

New features:

  • Potentially “interesting” days for photos with the moon are denoted with an asterisk
  • In Details View, shadow length is now indicated


  • The colour of lunar azimuth lines would occasionally misbehave for southern hemisphere locations (thanks to Mark Moore)

1.0.3 (November 16 2009)


  • 1.0.2 would hang on startup for a clean install. Previous versions were not affected
  • Locations could not be created or saved for clean installs. Unsure which version introduced this defect.

1.0.2 (November 14 2009)


  • Netbook users: TPE will now fit in screens with 600px resolution
  • Selected date format changed to an international format
  • “Reset to today” button added
  • Window size and state is now restored on start-up


  • Program would previously only detect one moon phase event per month – on occasions there are two (e.g. Full moons in December 2009)

1.0.1 (November 2 2009)


  • Details view azimuth lines extend to 200 miles length on holding down Shift key
  • Timezone name tooltip modified to clarify that displayed timezone abbreviation is for midnight on the selected date


  • Program would hang on selecting date/location for which no moon phase event (e.g. Full Moon) occurred (e.g. any date in Feb 2010 in Sydney, Australia)
  • Timezone abbreviation was displayed for last calculated date, which could be different to that of actual selected date
  • On dates with daylight saving or other timezone offset adjustments, Details view altitude graphs were out of synch with displayed event times
  • On dates with daylight saving or other timezone offset adjustments, Details view events panel did not reflect adjusted time on moving slider
  • In the Configure panel, the Reset button was positioned incorrectly

My thanks to Jeff Conrad, Steve Carter, Andy Kubbat and Bruce Moss for their help in tracking these down.

1.0.0 (October 11 2009)

New features:

  • Plain text notes can be entered for any saved Location
  • Primary elevation above sea level can be selected and copied to the clipboard


  • Auto-switch views checkbox has moved from Locations to Configuration
  • If Lock button is released programmatically (e.g. when swapping markers) it flashes briefly
  • When waiting for secondary marker elevation data, current data is dimmed rather than cleared (to match behaviour of primary marker)
  • Pre-sunrise/post-sunset azimuth extension lines drawn wider for improved visibility


  • Scroll bars would previously appear if distance from primary to secondary marker was too large to be displayed
  • Distance to horizon was previously displayed at times when primary marker was lower in elevation than horizon – it is now only displayed when marker lies at higher elevation
  • Variable length of detail view azimuth lines was broken in 1.0 RC1 – fixed here
  • Timezone change icon was not displayed for GMT locations (e.g. London on Sunday 25th October 2009)
  • Timezone change icon was incorrectly displayed for some locations (e.g. Moscow on Sunday 25th October 2009)

1.0 Release Candidate 1 (September 20 2009)

New features:

  • Location list can be dynamically filtered
  • Map coordinates are displayed to 4 decimal places
  • Map coordinates can be selected and copied to the clipboard (e.g. to paste into Google Earth)
  • ASTER GDEM and GTOPO30 elevation data sets are now used if preferred SRTM service returns ‘no data’
  • Details view slider can be adjusted in 1 minute increments using left/right cursor keys (click to select it first)
  • Sun azimuth lines continue to be displayed after sunset (or before sunrise) up to the end (start) of astronomical twilight
  • Link to Terms of Use added to About page


  • Details view slider tooltip shows fractional hour of day when dragging
  • Sun and moon azimuth and altitude are grayed out only if azimuth is close to bearing of secondary marker
  • Default distance to horizon assuming camera height of 5ft above ground has been removed
  • Distance to horizon warning is only displayed if user has specified elevation at horizon and distance from primary to secondary is greater than implied distance to horizon
  • All azimuth lines are drawn to 200 miles length


  • Too many days were displayed at certain window sizes leading to overlapping controls
  • Clicking the Search label displayed the Horizon glossary entry

Beta 0.9.6 (August 9 2009)

Minor changes and bug fixes:

  • Map can now be zoomed using mouse scroll wheel
  • Elevation at horizon controls relocated to right hand panel and expanded for clarity
  • Added icon showing when distance to horizon is indicated on the map (and estimated distance is shown numerically in icon tooltip)
  • Warning icon is displayed in Geodetics panel if secondary marker lies beyond the calculated distance to the horizon
  • If no elevation at the horizon is specified, a default distance to the horizon is calculated assuming a camera height of 5ft above the ground (~3 miles)
  • If elevation at horizon is locked to secondary marker location and markers are swapped, lock is now released automatically
  • When secondary marker is moved, previous elevation data is cleared pending receipt of new data
  • Added option to have search for nearest place name automatically on change of primary map marker location
  • Sun and moon azimuth and altitude are greyed out if altitude is below apparent altitude to secondary marker
  • Place name search term is no longer cleared on moving to search result position
  • Maximum length of azimuth lines changed from 200km to 200 miles
  • Elevations above sea level are now always displayed in either feet or metres (previously would show miles or km depending on value)
  • Fixes bug where pressing F1 would switch to Locations view (as well as opening help page in browser)
  • Time zone controls consolidated and tidied up
  • Other minor fixes and improvements

Beta 0.9.5 (July 27 2009)

* Improved Details view now includes Twilight times and Geodetics panel
  • Use secondary map marker to determine when sun or moon will clear an obstacle such as a mountain (Geodetics)
  • Correct rise and set times for the dip of the horizon (e.g. the sun is seen to rise earlier from a mountain top)
  • Use secondary map marker to set elevation at the horizon, or specify manually (to calculate dip of the horizon)
  • View the estimated distance to the horizon on the map, based on height above the horizon
  • Swap primary and secondary map marker positions using button or keyboard shortcut (S)
  • Haversine formula (for determining great circle distances) replaced with Vincenty algorithm for improved accuracy
  • Ctrl + and Ctrl – zooms in and out of map
  • Number keypad plus and minus added to keyboard shortcuts
  • Revised and expanded glossary
  • F1 key opens usage instructions in browser (requires internet connection)
  • Fixes bug where rise/set times were not recalculated on double-clicking map
  • Fixes bug where previous/next event in details view could stall on a particular event
  • Tooltips updated and corrected

Beta 0.9.0 (June 17 2009)

  • Main window is now resizable: additional dates are shown when space is available
  • Details view is now maintained on changing selected date: watch the moon graph change from day-to-day!
  • Updates and corrections to About page

Beta 0.8.4 (May 29 2009)

  • Fixes azimuth lines drawn on map: earlier versions would display inaccurately for bearings other than a multiple of 90 degrees and for locations away from the equator. (Sincere thanks to Brian Henderson for pointing out this issue.)
  • Azimuth lines drawn as geodesic lines rather than straight lines
  • Maximum line length restricted to 200km in length to maintain visual accuracy – zoom in to see longer lines

Beta 0.8.3 (May 26 2009)

  • Holding down shift key now extends rise/set/azimuth lines through marker location for easier visual alignment (when zoomed in)
  • Map marker position is no longer automatically centred in map (use the new Centre button to do this)
  • Lunar coordinates algorithm for rise/set changed to Meeus from Van Flandern & Pulkkinen for better consistency
  • Bennett refraction formula incorporated into moonrise/set algorithm
  • Previous/next event in Details view no longer resets to first event
  • Tooltips include keyboard shortcut hint where applicable
  • Fixes to refraction threshold values in Details view
  • Occasional keyboard non-responsiveness fixed

Beta 0.8.2 (May 11 2009)

  • Elevation angles in Details view are now corrected for refraction
  • Improved refraction modelling allows for observer elevation above mean sea level
  • Search box visibility improved
  • Timeout for GeoNames web services is now user configurable
  • Details view now updates correctly if timezone override is used
  • Configuration option “Adjust for observer altitude” removed

Beta 0.8.1 (April 18 2009)

  • Adjust for observer altitude disabled (pending fix to logic – with thanks to Jeff Conrad for setting me straight on this)
  • Additional tool tips included
  • Minor corrections to glossary
  • Updated About page

Beta 0.8.0 (Apr 14 2009)

  • Details function added to visualise sun/moon azimuth and elevation at an arbitrary time
  • Map legend implementation improved
  • Map colours are user selectable
  • Reset to default function for configuration options
  • Expanded glossary
  • User interface refinements

Beta 0.7.6 (Apr 5 2009)

  • Improved scrolling on next and previous date
  • Minor user interface refinements
  • Adds ability to configure default location name format
  • Minor fixes to data display on startup

Beta 0.7.5 (Apr 4 2009)

  • Adds automated time zone management using the Chronos XML Time Zone Repository. Daylight savings policies for all known timezones are handled automatically (that’s pretty much everywhere but on the high seas)
  • Adds configuration option to correct sunrise/sunset/moonrise/moonset for observer altitude. (Altitude is determined automatically by the program using the GeoNames Shuttle Radar Topography Mission web service)
  • Adds legend explaining azimuth lines on map
  • Adds tooltips for user interface controls
  • Expanded Glossary: additional terms and corrections
  • Fixes rise/set/twilight times at Daylight Savings transitions
  • Fixes frozen sunrise/sunset times for extreme latitudes
  • Fixes issue whereby sunrise/sunset/twilight data would sometimes be reported for the previous day to that selected
  • Fixes issues with incorrect time zone offsets for computers set to system timezones ahead of UTC (e.g. Australia)
  • Fixes issue whereby azimuth line would be drawn the wrong way around the globe if the line would otherwise have spanned the anti-meridian (+-180 degrees longitude)

Beta 0.7.4 (Mar 12 2009)

  • Fixes occasional errors in displayed date/time of new, first quarter, full, last quarter moon
  • Resolves occasional timezone issues also affecting key phases of the moon during DST transition months
  • Adds new keyboard shortcut: T to toggle display of Twilight information in Ephemeris view

Beta 0.7.3

Minor changes:

  • Switch to using VSOP87 algorithm for solar coordinate calculations for improved accuracy
  • Added clarification to Glossary default text
  • Added latitude/longitude label above map control

Beta 0.7.2

  • Adds automatic version updating using Adobe AIR update framework

Beta 0.7.1

  • Internal testing only

Beta 0.7.0

  • Initial Beta release

[Originally published Mar 10 2009]