[hatstand]

The iOS side of clementine-player/Android-Remote#408, after #81.

Music kept on the phone with "Every time I connect" is now updated without opening the app. About every 6 hours, a background processing task syncs the rules for the last Clementine that synced, at its last address.

• When it runs: iOS starts the task (BGProcessingTaskRequest, requiresExternalPower) only while the phone is on power, usually overnight. It is scheduled when the app goes to the background and again after each run.
• Network: it runs only on a network Download over allows, and never in Low Data Mode.
• How it connects: BackgroundSync.run reconnects the app's own RemoteSession without asking for every playlist's songs. That connection doesn't offer the phone as a renderer either (resume(offeringRenderer: false)), so a Clementine can't start playing on the phone in the background. With Syncer.onlyServerID set, a different Clementine answering at that address is left alone, and doesn't become the one the rules shown are for. After the sync it disconnects, unless the app has been opened in the meantime. If the app is already connected, its connection syncs instead.
• When iOS ends the task: Syncer.stop() cancels the sync. What's downloaded so far stays, and the next sync carries on.
• Setting: a switch under Download over, "Update kept music in the background", on by default. Its wording and translator notes match Android's.

Behind testing features, so there's no release note. Info.plist and project.yml gain the processing background mode and the task identifier. Neither change touches the project file.

BackgroundSyncTests covers:

• the network rule, and which rules need syncing;
• against a fake Clementine:
  • it connects, syncs and disconnects;
  • it leaves another Clementine alone;
  • it gives up when nothing is there;
  • it does nothing when there's nothing to sync or the setting is off;
  • it syncs over the app's own connection;
  • it resumes a suspended session without offering the renderer.

🤖 Generated with Claude Code

https://claude.ai/code/session_01R2bAq6kZW6eyymkA3zsd4p

[github-actions]

Screenshots

From run 42303435999, against a real Clementine. Left: main. Right: this pull request, light and dark.

Screen	main	This PR	This PR, dark
01_connect
02_queue
03_player
04_connection
05_settings
06_library
07_library_album
08_search
09_outputs
10_internet
11_internet_radio
fold_outer_player	–

Screens at a failure

dark_failure

failure