Add support for CarPlay by docmeth02 · Pull Request #111 · kepelet/flo

docmeth02 · 2026-02-22T12:22:26Z

This is a bit of a WIP since i can only test this in the iphone simulator without having the proper entitlements added from apple. It fully works, but does change some points in how the app works on all platforms.

Major changes i made:

PlayerViewModel → Singleton (PlayerViewModel.swift)

Added static let shared = PlayerViewModel() — the phone UI and CarPlay now share one player instance
ContentView uses PlayerViewModel.shared instead of creating its own

Audio Session Lifecycle (App.swift + PlayerViewModel.swift)

Removed setActive(true) from app launch — this was killing car FM radio the moment flo connected to CarPlay
Added setActive(true) in setNowPlaying() — activates only when actually starting playback
Added setActive(false, options: .notifyOthersOnDeactivation) in destroyPlayerAndQueue() — releases audio focus so other audio sources can resume

Now Playing / Playback Indicator Fixes (PlayerViewModel.swift)

initNowPlayingInfo now merges with the existing nowPlayingInfo dict instead of creating a fresh one (was wiping playback rate/elapsed time)
seek(to:) now updates self.progress so subsequent calls use the correct position
play() sets playbackState = .playing, pause() sets .paused — CarPlay now knows the actual state instead of guessing from playback rate

Locked-Phone Security (KeychainManager.swift + LocalFileManager.swift)

Keychain: .afterFirstUnlockThisDeviceOnly — auth tokens accessible when phone is locked in the car
Downloaded files: .completeUntilFirstUserAuthentication — offline music plays when phone is locked

Config (Info.plist + flo.entitlements + project.pbxproj)

Scene manifest with CarPlay scene configuration
com.apple.developer.carplay-audio entitlement
Auto scene manifest generation disabled, CarPlay files + framework added to target

Impact on non-CarPlay usage: The audio session and now playing are improvements for the phone app too — lock screen controls and AirPlay will be more
reliable.

So to actually test this in testflight, you would need to first apply for the carplay entitlement with the account that builds the testflight binaries (https://developer.apple.com/documentation/carplay/requesting-carplay-entitlements)

Simulator Screenshot - iPhone 17 - 2026-02-22 at 13 21 13

Simulator Screenshot - iPhone 17 - 2026-02-22 at 13 20 58

Simulator Screenshot - iPhone 17 - 2026-02-22 at 13 20 43

Simulator Screenshot - iPhone 17 - 2026-02-22 at 13 20 13

This commit addresses multiple issues causing crashes on smaller screens, particularly iPhone 13 mini (390pt width): 1. Fixed ContentView floating player padding scope issue - Variable was declared in wrong scope causing undefined behavior - Combined padding values into single expression - Updated threshold from 375pt to 390pt to include iPhone 13 mini 2. Restored text scaling in StatCardView - Added .minimumScaleFactor(0.7) to all text elements - Prevents text overflow crashes when content is too long - Applied to title, value, and subtitle text in both iOS 26+ and legacy versions 3. Conditional layout in HomeView to prevent geometry loops - Small screens (≤390pt): Use regular HStack without EqualHeightItem - Larger screens (>390pt): Use EqualHeightHStack for visual consistency - Avoids infinite geometry calculation loop when combining minimumScaleFactor with EqualHeightItem Related to PR kepelet#102 and PR kepelet#105 Fixes white screen crashes reported on iPhone 13 mini (builds 206-207) Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

Removed duplicate bottom padding from FloatingPlayerView that was causing excessive spacing below the miniplayer. ContentView already applies appropriate bottom padding to account for the tab bar. Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>

- Handle missing `song` key in getSimilarSongs2 response without crashing - Show alert to user on empty results or network failure - Replace duplicate ArtistRadioPlayable with existing RadioEntity - Increase default song count to 100 Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

- Align Artist Radio button to leading edge - Rename button label to "Play Artist Radio" - Reduce miniplayer bottom padding to close gap above tab bar Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

faultables · 2026-02-22T15:16:35Z

woah, looks nice, thanks! will add it to 2.2!

if you see this you may join to flo campfire here: https://campfire.flooo.club/join/qJEV-Wphv-bUOD :)

i have promised this before so here we are!

… model

- individual loading state - make both button width equal

but for now only for "smaller" screens

…lay now playing

docmeth02 · 2026-02-26T19:11:27Z

rebased onto version 2.1 codebase and added the new artist radio and top songs buttons to carplay

The cherry-pick of PR #111 (CarPlay support) replaced the project.pbxproj with the fork's version, dropping the flo Watch Watch App build target. Restore the Watch target by starting from the pre-cherry-pick pbxproj and surgically adding only CarPlay-specific entries: - CarPlay.framework linkage - CarPlayCoordinator, CarPlaySceneDelegate, CarPlayNowPlayingManager, CarPlayImageLoader file references and source build phase entries - CarPlay and Frameworks PBXGroups - flo.entitlements reference and CODE_SIGN_ENTITLEMENTS build setting https://claude.ai/code/session_015rkZGZikDmQB6kje6uGB6n

faultables · 2026-03-09T23:07:40Z

ok i think we can ship this (all commits in this PRs are already on release 2.2 btw)

faultables · 2026-03-14T18:30:55Z

@docmeth02 does the CarPlay support still work on this branch? #118

docmeth02 · 2026-03-15T09:23:53Z

yup, it is working in the ios simulator @faultables

faultables · 2026-03-15T10:40:11Z

yup, it is working in the ios simulator @faultables

how do i check it on my xcode project? somehow on my carplay simulator can’t see any flo apps

docmeth02 · 2026-03-15T10:59:21Z

oh yeah i noticed you are missing the carplay entitlement in #118

`diff --git a/flo.xcodeproj/project.pbxproj b/flo.xcodeproj/project.pbxproj
index 0188792..cdb74e3 100644
--- a/flo.xcodeproj/project.pbxproj
+++ b/flo.xcodeproj/project.pbxproj
@@ -970,6 +970,7 @@
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
ASSETCATALOG_COMPILER_INCLUDE_ALL_APPICON_ASSETS = YES;
+ CODE_SIGN_ENTITLEMENTS = flo/flo.entitlements;
"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Developer";
CODE_SIGN_STYLE = Manual;
CURRENT_PROJECT_VERSION = 211;
@@ -1013,6 +1014,7 @@
ASSETCATALOG_COMPILER_APPICON_NAME = AppIcon;
ASSETCATALOG_COMPILER_GLOBAL_ACCENT_COLOR_NAME = AccentColor;
ASSETCATALOG_COMPILER_INCLUDE_ALL_APPICON_ASSETS = YES;
+ CODE_SIGN_ENTITLEMENTS = flo/flo.entitlements;
"CODE_SIGN_IDENTITY[sdk=iphoneos*]" = "iPhone Distribution";
CODE_SIGN_STYLE = Manual;
CURRENT_PROJECT_VERSION = 211;

`
shows up for me again in the Simulator after that patch 👍

faultables · 2026-03-16T19:13:39Z

closing this as all commits have been cherrypicked to release/2.2

faultables and others added 13 commits February 17, 2026 23:52

feat: init flo watch companion app

fdc929d

feat: init watch app related ui

bcb16c8

chore: add watchkitapp bundle

c875ce7

chore: update pbxproj

d68c495

hotfix: scale factor in stat cards

030a4cd

build(release): bump version to 2.1 (207)

d72a521

add support for navidrome artis radio

9e4da54

fix: artist radio UX polish and miniplayer gap

fc8f267

- Align Artist Radio button to leading edge - Rename button label to "Play Artist Radio" - Reduce miniplayer bottom padding to close gap above tab bar Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

docs(l10n): add another words

904d7a6

build(release): bump version to 2.1 (209)

f3d9787

faultables and others added 11 commits February 24, 2026 01:13

feat: prepare IAP

09a1004

if you see this you may join to flo campfire here: https://campfire.flooo.club/join/qJEV-Wphv-bUOD :)

feat: add alternative app icon

3913518

i have promised this before so here we are!

docs(l10n): add another words

cecb6b2

feat: added top songs for artist + refactor artist detail to use view…

44f1ffc

… model

feat: add another alternative app icon

fa8f561

feat: add some adjustment

3e8f670

- individual loading state - make both button width equal

build(release): bump version to 2.1 (210)

6bf2d0a

feat: bring back to bottom padding

b78059b

but for now only for "smaller" screens

build(release): bump version to 2.1 (211)

cfdfad8

initial support for apple carplay

bb3f9de

use MPNowPlayingInfoCenter to acurately mirror ios playback into carp…

0e1099d

…lay now playing

docmeth02 force-pushed the feat/carplay branch from f0653db to 0e1099d Compare February 26, 2026 19:00

Add artist radio and artist top songs to carplay

0906d44

faultables closed this Mar 16, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Add support for CarPlay#111

Add support for CarPlay#111
docmeth02 wants to merge 25 commits intokepelet:developfrom
docmeth02:feat/carplay

docmeth02 commented Feb 22, 2026

Uh oh!

faultables commented Feb 22, 2026

Uh oh!

docmeth02 commented Feb 26, 2026

Uh oh!

faultables commented Mar 9, 2026

Uh oh!

faultables commented Mar 14, 2026

Uh oh!

docmeth02 commented Mar 15, 2026

Uh oh!

faultables commented Mar 15, 2026

Uh oh!

docmeth02 commented Mar 15, 2026

Uh oh!

faultables commented Mar 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

docmeth02 commented Feb 22, 2026

Uh oh!

faultables commented Feb 22, 2026

Uh oh!

docmeth02 commented Feb 26, 2026

Uh oh!

faultables commented Mar 9, 2026

Uh oh!

faultables commented Mar 14, 2026

Uh oh!

docmeth02 commented Mar 15, 2026

Uh oh!

faultables commented Mar 15, 2026

Uh oh!

docmeth02 commented Mar 15, 2026

Uh oh!

faultables commented Mar 16, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants