iCloud Syncing
Syncing is performed by Apple's secure and reliable iCloudKit. Newly entered data is automatically synced in the background when it is safe to do so.
When the app is being used it may take iCloudKit up to a minute to upload changes to the cloud.
Pushing Song One into the background (closing/minimizing Song One's app window) initiates an iCloud sync request to immediately upload the latest song catalog changes.
Moving Song One into the foreground (opening Song One's app window) initiates an iCloud sync request to immediately fetch the latest song catalog changes.
Editing On Multiple Devices
Push the app into the background on your current device before editing your song catalog on another device:
On iOS press the home button of your device (or swipe the screen upwards from the bottom edge) to return to the 'Home Screen'.
Do not swipe Song One's minimized app window upwards (this would force Song One to quit immediately).
On macOS minimize Song One's application window to continue editing a song on another device.
To continue editing a song on macOS (after you have pushed Song One into the background on iOS) re-open Song One's minimized application window on macOS.
Syncing Intervals
The changes to a song are synced within 5 to 40 seconds when you:
close the song (by selecting another song),
switch to a different app or
push Song One into the background.
The changes to a set are synced within 10 to 40 seconds.
Note: If Song One is also running on a second device the sets will update via iCloud but the screen on the second device will not refresh. To refresh the screen re-open/close the set on the second device.
The changes to the theme settings are synced within 5 to 15 seconds. Themes may be customized on multiple devices at the same time. The screen on each device will automatically refresh. (Note: Background images are added to the specific song and are synced with the lyrics.)
Note: Your theme settings are backed up via iCloud but are not included in your local song catalog backup.
Theme settings cannot be recalled if you delete Song One on all devices and delete the data of Song One's iCloud container (in your system preferences).
iCloud Troubleshooting Guide
Song One's preferences/settings offer an option to disable iCloud sync. Make sure the option is turned on to sync your devices. If you are experiencing a syncing problem try the following options:
Make sure that iCloud and your iCloud Drive are enabled:
iOS
Settings > Apple ID > iCloud > iCloud Drive: On
Settings > Apple ID > iCloud > Song One: On
macOS 13 (or higher)
Apple icon (top left) > System Settings > User Name/Apple ID > iCloud > iCloud Drive: On
Options > 'Apps that store documents on iCloud' > Song One: (set check mark)
macOS 11-12
Apple icon (top left) > System Preferences > iCloud > iCloud Drive: (set check mark)
Options > Song One > 'Apps that store documents on iCloud': (set check mark)
Make sure that you are signed into the same iCloud account on all devices:
iOS
Settings > Apple ID: User Name & Email
macOS 13 (or higher)
Apple icon (top left) > System Settings > Apple ID: User Name & Email
macOS 11-12
Apple icon (top left) > System Preferences > iCloud > Apple ID: User Name & Email
Make sure that you are online via WIFI or a cellular data plan (and Song One has permission to use them):
iOS
Settings > Cellular > Cellular Data > Song One: On
Make sure that syncing is allowed (iCloud syncing may be disabled on devices managed by an educational institution):
iOS
Settings > General > Profile > "Documents in the cloud not allowed"
Make sure that there is sufficient storage space in your iCloud account and on your devices:
iOS
Settings > Apple ID > iCloud (top of the screen)
Settings > General > iPad/iPhone Storage
macOS 13 (or higher)
Apple icon (top left) > System Settings > User Name/Apple ID > iCloud (top of the screen)
Apple icon (top left) > About This Mac > More Info > Storage
macOS 11-12
Apple icon (top left) > System Preferences > iCloud (bottom of the screen)
Apple icon (top left) > About This Mac > Storage
Check the battery level of your mobile devices:
iOS automatically disables syncing in the low power mode.
Test iCloud syncing in the finder:
Attempt to sync a test file added to your iCloud folder on your Mac and the iCloud folder on your mobile device ('Files' app). If unsuccessful contact Apple support through this site.
AirDrop a test file from one device to another. (This may refresh your iCloud connection.)
Turn Song One's iCloud switch off, restart your devices and turn Song One's iCloud switch back on:
iOS
Settings > Apple ID > iCloud > iCloud Drive: Off (restart) On
Settings > Apple ID > iCloud > Song One: Off (restart) On
macOS 13 (or higher)
Apple icon (top left) > System Settings > User Name/Apple ID > iCloud > iCloud Drive: Off (restart) On
Options > 'Apps that store documents on iCloud' > Song One: Off (restart) On
macOS 11-12
Apple icon (top left) > System Preferences > iCloud > iCloud Drive: Off (restart) On
Options > Song One > 'Apps that store documents on iCloud': Off (restart) On
Log out of your iCloud account, restart your device and log back in:
iOS
Settings > Apple ID (scroll to bottom): Sign out (restart) sign in
macOS 11-12
Apple icon (top left) > System Preferences > iCloud : Sign out (restart) sign in
Contact Apple through this site.
Last updated
