CloudBox: Prefetch Mode

This article describes what prefetch mode is and how to set it up on your CloudBox

Dustin avatar
Written by Dustin
Updated over a week ago

What is Prefetch Mode?

  • Prefetch mode is designed to minimize downtime, ensuring a continuous music experience at your location/s, even during internet outages.

  • Each night the device will download the media for the next day along with the music schedule for the next 24 hours.

Steps to get rolling

  1. Reach out to a customer support agent or your account manager and ask them to enable prefetch on your account. Also, let them know which locations you'd like to enable prefetch on so we can confirm if you have the v6+ of our APK on the box; nearly all of our devices in the field will be on v6+.

  2. Specify a "Media Download Window" when the media is permitted to download. If the Media Download window is not set it will download at any time

  3. Please be aware that Prefetch Mode is not supported in conjunction with our Pandora Radio Integration. This limitation is due to the operational characteristics of Pandora's systems, and therefore, we will not be able to offer this as a future development.

The Cloudbox keeps media in the cache until the cache is full and then starts evicting (as needed) least recently used media not referenced by the current schedule. Power cycling will dump the entire cached media.

How does the Cloudbox work differently with prefetch mode enabled.

  • When changing stations: "Play Now" wont work! It has to get the 24 hour schedule before it plays the new selection. If the station is changed it won't update until the next media window

  • Currently prefetch only works with v6+ of our APK and deliberately has no album art downloaded to save download bandwidth. If you are using one of our older Cloudboxes we may need to upgrade your Cloudbox's software in order to use this feature.


  • If the Cloudbox is online, will the controls and history work? YES, but if you change the station the update won't take place until the next allotted media download window occurs.

  • Will the royalty free music (elevator style jazz music) ever play after is has download media? NO

  • Can a station change be forced? YES, First, change the station. Afterwards, click the "Download Media" button under the zones page in Tune in order to force the Cloudbox to download a new 24-hour schedule and media.

How to Set The Prefetch Media Download Window

Select Account and the Prefetch tab

Then Select Edit

Adjust your media download window time accordingly and hit Save

Can I enable Prefetch for only specific locations? Yes!

At the bottom of the Prefetch tab you'll see each username for your account. Here you can toggle the switch to the right to turn it on, or to the left to turn it off for a location.

Did this answer your question?