lodesong

iPhone app: device checklist

updated Nov 2, 2026

For #410. Nothing here can be seen without a phone: CI only proves the app compiles. Install the latest lodesong-ios.ipa (docs/ios.md), play something from your own library, and go through it in this order (the first three are where a web view most likely differs from Safari). Fill in the last column and open one issue per failing row.

Phone: ______ iOS: ______ app version: ______ date: ______

#do thisshould happenif it doesn't, look atpass
1Flip the silent switch on (orange showing), play a songyou hear itAudioSession.prepare (category .playback) in AppModel.swift
2Play a song, press the side button to lockmusic carries on, and on into the next song (let one finish)UIBackgroundModes: audio in project.yml; the page's gapless scheduling while backgrounded (JS timers are throttled), see apps/player/src/lib/audio
3Wake the lock screen while playingcover, title, artist and a moving scrubberthe page's navigator.mediaSession metadata; WebKit may not publish it from a web view, the planned fix is a native Now Playing layer fed by the keep bridge
4On the lock screen: pause, play, next, previous, drag the scrubbereach one works and the page followssame as 3 (remote commands)
5Control Center: the same card and buttonssame as 3 and 4same as 3
6AirPods (or the car): double tap / press to pause and play, skipthe music followssame as 4
7Unplug or switch off the AirPods while playingmusic pauses and does not blast from the speakeriOS does this by itself; note if not
8Get a call (or set an alarm for a minute away) while playing, finish itmusic pauses, and comes back by itself afterwardsinterruption(_:) in PlayerController.swift, which re-takes the audio session and calls keepNative.play()
9Play, open another app (Safari, Maps) for a minute, come backmusic never stopped; the page is where you left itbackground modes as in 2
10Play for 10 minutes with the screen lockedno gap, no stall, track changes land on timegapless scheduling, as in 2
11Switch off Wi-Fi and mobile data, reopen the appthe "can't reach" screen appearsfail(_:) in PlayerController.swift
12Switch the network back, press try againthe player loads againreload()
13Four quick taps on the sign-in page backgroundthe small menu appears (reload, change server)the preview message in userContentController
14Change server, enter another addressthe app loads that one; killing and reopening the app keeps itAppModel.server
15Kill the app, reopen itstill signed inwebsiteDataStore = .default()
16Rotate the phonethe layout follows, no reload
17Tap a link to another siteit opens in Safari, not in the appdecidePolicyFor in PlayerController.swift
18(If you use AltStore) wait 6 days, or add the source and install a newer releaseit refreshes, or shows the update (docs/ios.md)altstore.json on the release

What is already handled in code

  • The silent switch (1): the audio session category is .playback from launch.
  • A call or alarm (8): the app listens for the audio session interruption and resumes when iOS says it should. It only resumes if music was playing when the interruption began.

Reporting a failure

One issue per row: the row number, the phone and iOS version, what you saw instead. If the lock screen controls (3 to 6) are flaky or missing, say so in the issue for the native Now Playing layer rather than patching the page.

Checked without a phone

  • The project generates and compiles for the simulator and for a device in CI (iOS workflow).
  • The simulator can show the first-run screen, the layout and the failure screen (rows 11, 12, 13, 14, 16, 17) but not the silent switch, the lock screen or interruptions (1 to 10), so those need the phone.

On this page