Knowledgebase

Need help with Orpheus? You’re in the right place!

Dropbox API v2 Upgrade – October 2017

Today we released an update to both the free and pro versions of Orpheus. This update integrates the Dropbox API v2, because v1 has been retired today.

We kept our Dropbox API v1 integration alive for as long as possible because it provided useful syncing and caching features.  The Dropbox API v2 has many fantastic features and improvements, however it does have some differences. Most importantly, this:

Internet access is now required to access Dropbox charts real time.

Musicians who gig or rehearse in places without internet access are advised to store charts in a local folder or on your device SD card.

Is there an offline mode?

Yes. It’s fiddly to set up, but once configured it works nicely. Tutorial here.

In case you’re wondering about caching…

The cache function hasn’t changed; it downloads a copy of the file on first access for showing a chart. Changes (eg annotations) are saved to that local copy. Any updates to the remote version (Dropbox), result in the cache file being cleared and it being re-downloaded on next load. With this in mind, you may be wondering, “If the chart is cached locally why can’t it be  accessed offline?” Jeremy explains, “A local copy of the chart is stored in the cache, but the metadata is not – it’s pulled from Dropbox. To work offline, the system would need to get and store all of the Dropbox metadata and then update it when a connection is there; triggering subsequent cache events and metadata changes.”

Thank you for being a loyal user of Orpheus. We hope the above post explains the changes. And we hope that you continue to find Orpheus helpful.

Maeve Lander is a software developer by day, jazz trumpeter by night. She created Orpheus ~6 years ago, when Android was first born. It has gone through iteration over the years, but has always held true to the original vision; a minimalist sheet music reader that just does one thing, really well.

Leave a Comment


Comments are for discussing this post with other visitors. For technical support please submit a request here.