· |

Location Sychronization

Today, we’re updating the TPE web app to version 1.1.

The most significant aspect of the new update is the release of Location Synchronization.

If you’re a regular user of TPE, you probably have built up a reasonable sized list of saved photography locations. While it’s long been possible to import/export your locations as KML in the desktop app, many of you have asked about the ability to synchronize the lists automatically across multiple machines.

Location Synchronization allows you to do exactly that, free of charge for up to 1,000 saved locations per account. To get started with Location Sync, go to the Locations page within TPE for Desktop and sign up for an account.

In addition to Location Sync, there are a few notable improvements and fixes in 1.1:

  • Infinite scrolling on the locations page: this improves load time and performance significantly for those of you with a large number of saved locations – just keep scrolling down to load more locations from your list.
  • The timezone database has been updated reflecting recent changes, in particular the new time zone rules affecting many parts of Russia
  • Incorrect time labeling on the chart affecting Daylight saving dates (i.e. today in the USA) are now fixed

We’ll be adding Location Sync into the mobile versions of TPE in the coming weeks (once we get our iOS 8 update complete).

In the meantime, we hope you like the 1.1 web app release!


Location Sychronization

Today, we’re announcing a public beta of location synchronization for the TPE web app.

Location sync is something you’ve been asking about for a while, and so we’re pleased to have a solution that you can start testing today.

What it does

Location Synchronization allows you to push your locations to a central database and to pull them down on demand to a new machine. It works for the desktop web app today.

You can synchronize up to 1000 locations free of charge. You’ll need to create a free account to get started.

Any locations you synchronize are not shared publicly or with other users: they remain available only to your account.

The technology

We’ve spent quite a while pondering how to do location synchronization. Many of you asked if we could not just use iCloud. Apart from the various issues that iCloud sync suffered in its early days, the main barrier to using it is lack of cross-platform support: we need to be able to support desktop, iOS and Android.

We looked at other solutions that might support cross-platform sync, such as Wasabi Sync and Parse. However, it did not feel right to be dependent on a 3rd party service for something that would be so critical once users started putting data into it. (That decision seems to have been borne out: it looks like Wasabi Sync has shut its doors to new accounts.)

The other barrier to rolling out synchronization was our own Desktop app: the desktop app was always likely to the centre of the synchronization solar system. Planning at the desktop and synching locations out to laptops, tablets and mobiles is probably the key use case.

However, the old Adobe AIR desktop app was not a great place to be adding new capabilities: it was a technological dead-end.

With the arrival of the replacement web app, we were finally in a position to start tackling Location Synchronization properly in our own code.

What’s next?

It’s taken just over 2 months to get to public beta. I suspect we’ll be in beta for another 4-8 weeks to prove out the platform and build confidence that everything is going well.

Once beta is complete, we’ll promote the beta site to production, and any locations and accounts you create in the beta site will live on back in the main web app. We’ll then add location sync to the mobile apps. (As there’s a material cost to providing the service, so we expect to charge a small fee for this option on mobile platforms.)

Start syncing today!

Version 1.1 Beta of the web app is available at beta.photoephemeris.com today. But before you head over there, read more about how to get started:

Please let us know what you think!


At the time of writing, nothing. But less than 48 hours from now, TPE for Desktop (the original Adobe AIR version) will stop working.

I imagine that’s why you’re now reading this page. Here’s the short version of the story and what to do next.

TPE for Desktop was built using Adobe AIR which is a variant of Flash. The maps functionality was provided by Google Maps for Flash API. Back in 2011, Google announced that it was deprecating the Flash API and that it would be turned off altogether after 3 years. That time has now come (2 Sep 2014).

The consequence of this is that the maps in TPE for Desktop will no longer work after 2 Sep 2014. Furthermore, for versions 1.1.1 and below, the user interface will be ‘frozen’ as the app waits for Google Maps to initialize (and, of course, it no longer will.)

Back in July, we announced that TPE would be changing, and made a brand new web app version available. We published two posts on prominent photography web-sites (on Digital Photography School and Light Stalking) announcing the change, and posted updates on our various social media page.

We also released an update for TPE for Desktop to v1.1.2 that included prominent announcements of the deprecation date and details on what to use instead.

That aside, there are still going to be quite a few users taken by surprise by the change. We’re sorry if you didn’t see any of the advance notices, but we hope that you’ll find moving to the new web a straightforward change.

What to do

Here’s what you need to do:

  • If you don’t care about your saved locations in the old TPE for Desktop, you can move straightaway to the web web app. Read about the pre-requisites here (basically, just a modern web browser), and jump right in: TPE for Desktop (Web App)
  • If you’ve already updated to v1.1.2 of the old TPE for Desktop, and you have saved locations you’d like to move to the new web app, you will need to export them first, then import into web app. Full instructions are here: Part 6: Moving from legacy TPE for Desktop to the Web App
  • If you’re still running 1.1.1 or earlier, and have saved locations you’d like to retain, then life is little more complicated after 2 Sep 2014. You will need to uninstall the old version, download and install 1.1.2, export locations, then import to the web app. Again, full details are here: Part 6: Moving from legacy TPE for Desktop to the Web App

Getting started with the new web app

The best way to get up to speed quickly with the new web app is to download the Quick Start Guide – a free, 2-page PDF that gives a concise overview of all the key functionality. You can download it here:

A 3-page PDF quick start guide to using the TPE for Desktop web app.
File size 355.45kB | Last modified Mon Sep 1, 2014 at 22:36 | Download count 29258

If you’d like to understand the application in more depth, we have a series of five step-by-step tutorials that will guide you through it available here:


Getting help

Everything you’ve learned about how to use TPE from the old desktop app is still relevant: the same principles apply, and you’ll see much that is familiar with the new web app user interface.

However, if you have any questions, or run into any problems with the new version, drop us a line by email: Support

New Features

Once you get started with the new web app, we hope you’ll enjoy exploring some of its new features. These include:

  • Google Street View available from within the app
  • 45° map imagery available at higher zoom levels in satellite map mode
  • 6° shadow circle and ‘golden hour’ indication: hold down the shift key and try dragging the time slider back and forth around sunrise or sunset times
  • ShotHotspot.com: a direct link from within the app to ShotHotspot.com, to allow you easily to explore locations in more depth
  • Share/save links to your favourite shots: just copy the URL from your browser’s address bar. For example, here’s a sunrise shot plan from Grand Teton National Park, Wyoming: http://ephemer.is/1wU2G58

We hope you enjoy the new web app: do let us know your feedback.

Why did you…?

Finally, here are answers to a few of the questions that have come up over the past couple of months:

  • …not just find a different mapping provider and keep the Adobe AIR app going? A: Adobe AIR is no longer a good choice for a modern desktop application. Most of the efforts in recent years have gone towards trying to support mobile app development rather than desktop applications; furthermore, Adobe stopped development of Flex (aka Flash Builder) that was the toolkit used to build TPE
  • …write a web app instead of a new desktop app? A: a browser-based web app is the best way to provide cross-platform support today. A new desktop app would likely have required development of separate versions for Windows and Mac, which we simply didn’t have the time or resources to do
  • …require a modern browser? Why is my older browser not supported? A: we have built the application using modern web development technologies which do not support older browsers. These provide significant productivity enhancements for developers which result in more features being delivered to end users. There are few barriers nowadays to running a current version of a web browser (most will auto-update themselves if permitted), and so we feel this is the right trade-off
  • …change the user interface? A: the old user interface had some distinct limitations which we have tried to overcome with the new version. For example, the multi-day view was not well-equipped to show additional information such as for celestial bodies other than the sun and moon (something we’d like to add in the future). Additionally, we are looking to adopt a similar UI style across both the web app and mobile apps over time. The “right-hand sidebar” style does not work at all in portrait mode on phones and tablets.

Kiribati 2 September 2014


One month from today, if you boot up the TPE for Desktop Adobe AIR, this is likely what you will see:

Initialization failed

As previously announced, On 2 September 2014, Google will permanently turn off the Google Maps for Flash API, and TPE for Desktop will be no more – at least the Adobe AIR app will be no more.

Its replacement is already available and waiting in the wings: our new Desktop web app. You can find it at:


Kiribati 2 September 2014

We’d encourage you to head over there today and get started. You can export your saved locations from the Adobe AIR app and import them straight into the web app and carry on planning your shots without interruption.

You’ll need an up-to-date web browser that doesn’t block cookies or use of local storage. We’ve tested with:

  • Firefox 30, 31
  • Chrome 36.0.1985.125
  • Internet Explorer 11
  • Safari 7.0.5
  • Opera 23.0

So, don’t wait until the last minute: start using the new web app today and let us know what you think via the Support tab on the right hand side of the page.

Please help spread the word by sharing this post with your photography colleagues!


Full screen mode in TPE Web 0.9.4

Full screen mode in TPE Web 0.9.4

Many thanks to those of you who have provided feedback over the past few days on the desktop web app. It’s always invaluable to get input from our enthusiastic early adopters.

I know many of you are long-time TPE users, so I’m particularly keen to hear your experiences.

We’ve pushed out an update this evening (version 0.9.4 for those of you who track such things). It has a few important updates:

Download speed and page size

We’ve tweaked our server settings to decrease the total page download size by around 40%. Which should help :)

Full screen mode

We changed the way full screen mode operates. Given that many of you like to have the map as large as possible, full screen mode now hides the event timeline and chart, but keeps the time of day slider visible. You can use this, together with the shift key, to see how the sun and moon move through the day.

The critical azimuth/altitude information is visible in the time slider legend. That together with the “magic hour” circle (press Shift), let’s you explore the light through the day with the minimum of screen real estate lost to other numeric or chart information.

New settings

To provide some choices for users with different display sizes and preferences, we’ve added two new settings:

  • Widescreen: this will toggle the display consume the majority of the width of the display at all times (rather than just in full screen mode)
  • Show civil twilight only: you can check this option to dispense with the nautical and astronomical twilight events in the timeline (which are only relevant to certain types of photography), thus conserving width on smaller displays and avoiding the need for horizontal scrolling so often

Moon Phase Events

Two new date selection controls at the top of the screen: you can now jump between moon phase events at the click of a button. In addition to the date, the exact time of day is set from the time of the moon phase event.

This is a great way to skip forward and back by a week or so at a time, so if you’re looking to see the sun rise/set direction move noticeably, these controls have that task covered too.

UI improvements

We’re continuing to refine the UI, and you’ll probably notice several small changes. For example, we flipped the colours on the time of day slider to make it stand out more.


Er, yes. One or two. We’ve fixed a few. There’ll surely be more. Just as no battle plan survives contact with the enemy… ;)

Updated Quick Start Guide

There’s now a Help section on the right hand side, with a link to an updated Quick Start Guide with full details on how to use the web app.

Please keep the feedback coming, and we’ll keep polishing!

← Older Newer →