Download JustChords on the App Store

ICloud Sync

Contents

JustChords keeps your songs, setlists, tags, and media in sync across your iPhone, iPad, and Mac using your personal iCloud Drive — no account sign-up and no JustChords servers involved.

How it works

When you're signed in to iCloud, JustChords stores your library in your iCloud Drive instead of only on the device. Any device signed in to the same iCloud account will see the same songs, setlists, folders, and tags, usually within a few seconds of a change.

Syncing includes:

  • Songs, setlists, folders, and tags
  • Images, PDF notesheets, audio tracks, recordings, and pad sounds attached to your songs
  • A handful of app preferences, such as your custom folder list, instrument list, and section formatting rules

Some settings are per-device on purpose (for example, view and print preferences) and do not sync, since they're often tuned to the specific device or stage setup.

Turning it on

There is no separate on/off switch for iCloud sync in JustChords. It follows your device's iCloud sign-in status automatically:

  • Signed in to iCloud → your library and media sync automatically.
  • Not signed in, or iCloud unavailable → JustChords keeps working normally, but everything stays local to that device only.

To enable sync, sign in to iCloud in your device's system Settings and make sure iCloud Drive is turned on.

Large files and downloads

Audio tracks, recordings, and pad sounds can be large, so they aren't always downloaded to every device immediately — they sync as "available in iCloud" and download on demand when you open the song that needs them. If a file hasn't finished downloading yet, JustChords shows a download status until it's ready.

If your library is still downloading when you open the app, a small notice appears at the bottom of the screen while the latest iCloud data finishes loading — see Status messages below.

If you edit the same song on two devices

If two devices change the same library file while offline from each other, iCloud detects a conflict once they reconnect. Instead of silently picking a winner, JustChords shows a warning at the bottom of the screen, and tapping it opens a version picker so you choose which version to keep. The version you don't pick is safely backed up first, so nothing is lost outright.

Old, unresolved conflicts (older than about a month) are cleared automatically to avoid clutter.

Shared Folders (band/collaborative folders) use a different, always-online sync path and resolve conflicts automatically per song or setlist based on which was edited most recently — see Collaboration.

Troubleshooting

  • Changes not appearing on another device? Make sure both devices are signed in to the same iCloud account and connected to the internet.
  • Missing audio/pad files? They may still be downloading — open the song and wait for the download to finish.
  • Stuck on "Working with local data"? The latest iCloud data hasn't arrived yet. Check your internet connection, make sure your iCloud storage isn't full, and check the sync status of the JustChords data file in the Files app. Changes you make in the meantime are saved on the device and are not uploaded until iCloud catches up.

Status messages

JustChords shows sync status in small glass-style bubbles floating at the bottom of the screen, above everything else in the app. There are four states:

MessageMeaningHow long it stays
Refreshing…
Getting the latest data from iCloud.
JustChords is downloading the latest library from iCloud. This is normal when you open the app or return to it after a while.Disappears automatically once the download finishes.
Working with local dataThe download is taking longer than usual, so you're seeing the copy saved on this device. Edits are saved locally and are uploaded after the latest iCloud data arrives.Shown for a few seconds, then hides. It disappears sooner if the download finishes.
Modifications aren't in sync
Tap to choose version to keep.
Two devices changed your library while they were offline from each other. Nothing is lost — the version you don't pick is backed up first.Stays until you tap it and choose which version to keep.
Changes not synced to iCloud
Tap to choose version to keep.
This device has edits that never reached iCloud, for example because you edited while the library was still downloading. The version picker lists them as "On this device, not synced to iCloud" next to the iCloud version.Stays until you tap it and choose which version to keep.

The warning for conflicts and unsynced changes is important to resolve, so unlike the refresh notices it doesn't go away on its own:

The conflict warning. Tap it to choose which version to keep.

See also