Skip to content

StreamVault is a TV-first free IPTV player for Android TV built with Kotlin, Jetpack Compose, Room, Hilt, and Media3.

refactor(live): move EPG guide clock

David Nashash02eddcc6afc9
diff --git a/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgControlComponents.kt b/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgControlComponents.kt
index c297e00a..2e4fd6c2 100644
--- a/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgControlComponents.kt
+++ b/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgControlComponents.kt
@@ -23,16 +23,13 @@ import androidx.compose.foundation.text.KeyboardOptions
import androidx.compose.material.icons.Icons
import androidx.compose.material.icons.filled.Search
import androidx.compose.runtime.Composable
-import androidx.compose.runtime.CompositionLocalProvider
import androidx.compose.runtime.LaunchedEffect
import androidx.compose.runtime.getValue
import androidx.compose.runtime.mutableStateOf
-import androidx.compose.runtime.produceState
import androidx.compose.runtime.remember
import androidx.compose.runtime.rememberCoroutineScope
import androidx.compose.runtime.saveable.rememberSaveable
import androidx.compose.runtime.setValue
-import androidx.compose.runtime.staticCompositionLocalOf
import androidx.compose.ui.Alignment
import androidx.compose.ui.Modifier
import androidx.compose.ui.focus.FocusRequester
@@ -80,30 +77,6 @@ import java.time.ZoneId
import kotlinx.coroutines.delay
import kotlinx.coroutines.launch
-private val LocalGuideNow = staticCompositionLocalOf { 0L }
-
-@Composable
-internal fun rememberGuideNow(): Long {
- val currentTime by produceState(initialValue = System.currentTimeMillis()) {
- while (true) {
- value = System.currentTimeMillis()
- delay(30_000L)
- }
- }
- return currentTime
-}
-
-@Composable
-internal fun GuideNowProvider(content: @Composable () -> Unit) {
- val now = rememberGuideNow()
- CompositionLocalProvider(LocalGuideNow provides now) {
- content()
- }
-}
-
-@Composable
-internal fun currentGuideNow(): Long = LocalGuideNow.current
-
@Composable
internal fun GuideDensityRow(
selectedDensity: GuideDensity,
diff --git a/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgGridComponents.kt b/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgGridComponents.kt
index b589f960..da1b7dd0 100644
--- a/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgGridComponents.kt
+++ b/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgGridComponents.kt
@@ -51,6 +51,7 @@ import androidx.tv.material3.SurfaceDefaults
import androidx.tv.material3.Text
import com.streamvault.app.R
import com.streamvault.feature.live.presentation.epg.GuideDensity
+import com.streamvault.feature.live.presentation.epg.currentLiveGuideNow
import com.streamvault.core.ui.image.ChannelLogoBadge
import com.streamvault.core.ui.interaction.TvButton
import com.streamvault.core.ui.interaction.TvClickableSurface
@@ -241,7 +242,7 @@ private fun GuideTimelineHeader(
markerStepMs: Long,
scrollState: androidx.compose.foundation.ScrollState
) {
- val now = currentGuideNow()
+ val now = currentLiveGuideNow()
val appTimeFormat = LocalLiveTimeFormat.current
val hourFormat = remember(appTimeFormat) { appTimeFormat.createLiveTimeFormatter() }
val zone = remember { ZoneId.systemDefault() }
@@ -351,7 +352,7 @@ fun EpgRow(
onProgramFocused: (Program) -> Unit
) {
var isFocused by remember { mutableStateOf(false) }
- val now = currentGuideNow()
+ val now = currentLiveGuideNow()
val currentProgram by remember(programs, now) {
derivedStateOf { programs.currentProgramAt(now) }
}
@@ -554,7 +555,7 @@ fun ProgramItem(
onFocused: () -> Unit
) {
var isFocused by remember { mutableStateOf(false) }
- val now = currentGuideNow()
+ val now = currentLiveGuideNow()
val isCurrent = now in program.startTime until program.endTime
val appTimeFormat = LocalLiveTimeFormat.current
diff --git a/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgHeroComponents.kt b/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgHeroComponents.kt
index f590d3b6..af58fad2 100644
--- a/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgHeroComponents.kt
+++ b/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgHeroComponents.kt
@@ -43,6 +43,7 @@ import androidx.tv.material3.SurfaceDefaults
import androidx.tv.material3.Text
import com.streamvault.app.R
import com.streamvault.feature.live.presentation.epg.GuideDensity
+import com.streamvault.feature.live.presentation.epg.currentLiveGuideNow
import com.streamvault.core.ui.image.ChannelLogoBadge
import com.streamvault.player.ui.PlayerRenderView
import com.streamvault.domain.playback.isArchivePlayable
@@ -103,7 +104,7 @@ internal fun GuideHeroSection(
focusedProgram: Program?,
modifier: Modifier = Modifier
) {
- val now = currentGuideNow()
+ val now = currentLiveGuideNow()
val heroSelection by remember(uiState, focusedChannel, focusedProgram, now) {
derivedStateOf {
resolveGuideHeroSelection(
@@ -258,7 +259,7 @@ internal fun ImmersiveGuideHero(
if (isRefreshing) {
GuideHeroBadge(text = stringResource(R.string.epg_loading))
}
- if (selection?.program != null && selection.channel.isArchivePlayable(selection.program, currentGuideNow())) {
+ if (selection?.program != null && selection.channel.isArchivePlayable(selection.program, currentLiveGuideNow())) {
GuideHeroBadge(
text = if (selection.program.hasArchive) {
stringResource(R.string.epg_program_replay_ready)
@@ -320,7 +321,7 @@ internal fun GuidePreviewPane(
val renderSurfaceType by (previewPlayerEngine?.renderSurfaceType)?.collectAsStateWithLifecycle(
initialValue = PlayerRenderSurfaceType.SURFACE_VIEW
) ?: remember { mutableStateOf(PlayerRenderSurfaceType.SURFACE_VIEW) }
- val now = currentGuideNow()
+ val now = currentLiveGuideNow()
val appTimeFormat = LocalLiveTimeFormat.current
val timeFormat = remember(appTimeFormat) { appTimeFormat.createLiveTimeFormat() }
diff --git a/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgScreen.kt b/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgScreen.kt
index 7f714f25..b76b90d3 100644
--- a/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgScreen.kt
+++ b/app/src/main/java/com/streamvault/app/ui/screens/epg/EpgScreen.kt
@@ -5,6 +5,8 @@ import com.streamvault.domain.playback.ArchiveReplayMechanism
import com.streamvault.domain.playback.archivePlaybackCapability
import com.streamvault.domain.playback.isArchivePlayable
import com.streamvault.feature.live.presentation.model.guideLookupKey
+import com.streamvault.feature.live.presentation.epg.LiveGuideNowProvider
+import com.streamvault.feature.live.presentation.epg.currentLiveGuideNow
import androidx.compose.foundation.BorderStroke
import androidx.compose.foundation.background
import androidx.compose.foundation.clickable
@@ -417,7 +419,7 @@ fun FullEpgScreen(
}
else -> {
- GuideNowProvider {
+ LiveGuideNowProvider {
GuidePreviewPane(
previewPlayerEngine = uiState.previewPlayerEngine,
isPreviewLoading = uiState.isPreviewLoading,
@@ -460,7 +462,7 @@ fun FullEpgScreen(
trackColor = SurfaceHighlight
)
}
- GuideNowProvider {
+ LiveGuideNowProvider {
EpgGrid(
modifier = Modifier
.fillMaxWidth()
@@ -636,7 +638,7 @@ fun FullEpgScreen(
val dialogState = selectedProgram
if (dialogState != null) {
- GuideNowProvider {
+ LiveGuideNowProvider {
val (channel, program) = dialogState
val reminderProviderId = program.providerId.takeIf { it > 0L } ?: channel.providerId
LaunchedEffect(channel.id, reminderProviderId, program.channelId, program.title, program.startTime) {
@@ -651,7 +653,7 @@ fun FullEpgScreen(
val reminderButtonLabel = if (
reminderProviderId > 0L &&
program.channelId.isNotBlank() &&
- program.startTime > currentGuideNow() + 60_000L
+ program.startTime > currentLiveGuideNow() + 60_000L
) {
when {
reminderStateMatches && programReminderUiState.isLoading ->
@@ -663,12 +665,12 @@ fun FullEpgScreen(
} else {
null
}
- val canWatchArchive = channel.isArchivePlayable(program, currentGuideNow())
+ val canWatchArchive = channel.isArchivePlayable(program, currentLiveGuideNow())
CompactGuideProgramDialog(
channel = channel,
program = program,
providerLabel = uiState.providerSourceLabel,
- now = currentGuideNow(),
+ now = currentLiveGuideNow(),
onDismiss = { selectedProgram = null },
onWatchLive = {
selectedProgram = null
@@ -717,7 +719,7 @@ fun FullEpgScreen(
}
}
},
- onScheduleRecording = if (channel.streamUrl.isNotBlank() && program.endTime > currentGuideNow()) {
+ onScheduleRecording = if (channel.streamUrl.isNotBlank() && program.endTime > currentLiveGuideNow()) {
{
notificationPermissionGate.runRecordingAction {
viewModel.scheduleRecording(channel, program)
@@ -726,7 +728,7 @@ fun FullEpgScreen(
} else {
null
},
- onScheduleDailyRecording = if (channel.streamUrl.isNotBlank() && program.endTime > currentGuideNow()) {
+ onScheduleDailyRecording = if (channel.streamUrl.isNotBlank() && program.endTime > currentLiveGuideNow()) {
{
notificationPermissionGate.runRecordingAction {
viewModel.scheduleRecording(channel, program, com.streamvault.domain.model.RecordingRecurrence.DAILY)
@@ -735,7 +737,7 @@ fun FullEpgScreen(
} else {
null
},
- onScheduleWeeklyRecording = if (channel.streamUrl.isNotBlank() && program.endTime > currentGuideNow()) {
+ onScheduleWeeklyRecording = if (channel.streamUrl.isNotBlank() && program.endTime > currentLiveGuideNow()) {
{
notificationPermissionGate.runRecordingAction {
viewModel.scheduleRecording(channel, program, com.streamvault.domain.model.RecordingRecurrence.WEEKLY)
diff --git a/app/src/main/java/com/streamvault/app/ui/screens/epg/PlayerTransparentGuideOverlay.kt b/app/src/main/java/com/streamvault/app/ui/screens/epg/PlayerTransparentGuideOverlay.kt
index cb62d20a..8d36c47a 100644
--- a/app/src/main/java/com/streamvault/app/ui/screens/epg/PlayerTransparentGuideOverlay.kt
+++ b/app/src/main/java/com/streamvault/app/ui/screens/epg/PlayerTransparentGuideOverlay.kt
@@ -36,10 +36,10 @@ import com.streamvault.app.ui.screens.epg.EpgUiState
import com.streamvault.app.ui.screens.epg.EpgViewModel
import com.streamvault.app.ui.screens.epg.GuideCategoryPickerDialog
import com.streamvault.app.ui.screens.epg.GuideMessageState
-import com.streamvault.app.ui.screens.epg.GuideNowProvider
+import com.streamvault.feature.live.presentation.epg.LiveGuideNowProvider
import com.streamvault.app.ui.screens.epg.GuideSearchOverlay
import com.streamvault.app.ui.screens.epg.GuideToolbarButton
-import com.streamvault.app.ui.screens.epg.currentGuideNow
+import com.streamvault.feature.live.presentation.epg.currentLiveGuideNow
import com.streamvault.app.ui.screens.epg.isGuideCategoryLocked
import com.streamvault.core.ui.theme.OnSurfaceDim
import com.streamvault.core.ui.theme.Primary
@@ -75,8 +75,8 @@ fun PlayerTransparentGuideOverlay(
BackHandler(onBack = onDismiss)
- GuideNowProvider {
- val now = currentGuideNow()
+ LiveGuideNowProvider {
+ val now = currentLiveGuideNow()
val headerDateFormat = remember { SimpleDateFormat("EEE, MMM d, h:mm a", Locale.getDefault()) }
val headerTitle = focusedProgram?.title ?: focusedChannel?.name ?: stringResource(R.string.epg_title)
val favoritesLabel = stringResource(R.string.epg_favorites_filter_favorites)
diff --git a/docs/COMPOSE_REDUCTION_PHASE5_TRANSITIONAL_DEPENDENCIES.md b/docs/COMPOSE_REDUCTION_PHASE5_TRANSITIONAL_DEPENDENCIES.md
index 40c6fe3b..72015d3d 100644
--- a/docs/COMPOSE_REDUCTION_PHASE5_TRANSITIONAL_DEPENDENCIES.md
+++ b/docs/COMPOSE_REDUCTION_PHASE5_TRANSITIONAL_DEPENDENCIES.md
@@ -129,9 +129,10 @@ The `:feature:live` module itself depends only on `:core:navigation`, `:core:ui`
feature-to-feature imports. Home and Guide ViewModels are being moved behind
the live boundary incrementally: `HomeViewModel`, the sidebar/preview surface,
the loading/preview host supporting composables, the live source switcher, Home
-quick-filter panel/chip row, the reusable EPG guide shortcut chip, Home reorder
-top bar, and Home channel row surface are now feature-owned while the Home and
-EPG screen/dialog composition remains in `:app`.
+quick-filter panel/chip row, the reusable EPG guide shortcut chip, the shared
+EPG guide-now ticker/provider, Home reorder top bar, and Home channel row
+surface are now feature-owned while the Home and EPG screen/dialog composition
+remains in `:app`.
The source switcher receives localized labels from the app at the current
composition boundary. Live-owned
presentation primitives, `HomeUiState`, `HomePreviewUiState`, and Guide
diff --git a/docs/superpowers/plans/2026-08-28-live-feature-extraction.md b/docs/superpowers/plans/2026-08-28-live-feature-extraction.md
index f5156afa..a4353d7e 100644
--- a/docs/superpowers/plans/2026-08-28-live-feature-extraction.md
+++ b/docs/superpowers/plans/2026-08-28-live-feature-extraction.md
@@ -19,8 +19,9 @@ claim the Live slice or Phase 5 complete.
Status update (2026-08-29): `HomeViewModel`, the sidebar/preview surface, the
loading/preview host supporting composables, the live source switcher, Home
-quick-filter panel/chip row, the reusable EPG guide shortcut chip, Home reorder
-top bar, and Home channel row surface are now feature-owned
+quick-filter panel/chip row, the reusable EPG guide shortcut chip, the shared
+EPG guide-now ticker/provider, Home reorder top bar, and Home channel row
+surface are now feature-owned
and their feature checks are green. Home screen/dialog composition, the
remaining live cards/rows, complete locale resource migration, and acceptance
gates remain open.
@@ -657,7 +658,7 @@ Move `HomeScreen.kt`, `HomeScreenDialogs.kt`, and `HomeSidebarComponents.kt`. Re
The first screen wiring checkpoint is complete: Home now calls the
feature-owned `LiveSourceSwitcher`, `LiveQuickFiltersPanel` (including its
`LiveSelectionChipRow`), `LiveGuideShortcutChip`, `LiveReorderTopBar`, and
-`LiveChannelRowSurface`,
+`LiveGuideNowProvider`/`currentLiveGuideNow`, and `LiveChannelRowSurface`,
passing app-localized labels/title formatting/accessibility text through
explicit presentation parameters. The quick-filter key/selection rules are
covered by `LiveQuickFiltersTest`. The remaining app-owned live cards and
diff --git a/feature/live/src/main/java/com/streamvault/feature/live/presentation/epg/LiveGuideNow.kt b/feature/live/src/main/java/com/streamvault/feature/live/presentation/epg/LiveGuideNow.kt
new file mode 100644
index 00000000..8763a0b9
--- /dev/null
+++ b/feature/live/src/main/java/com/streamvault/feature/live/presentation/epg/LiveGuideNow.kt
@@ -0,0 +1,35 @@
+package com.streamvault.feature.live.presentation.epg
+
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.CompositionLocalProvider
+import androidx.compose.runtime.LaunchedEffect
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableLongStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.staticCompositionLocalOf
+import androidx.compose.runtime.setValue
+import kotlinx.coroutines.delay
+
+private val LocalLiveGuideNow = staticCompositionLocalOf { 0L }
+
+@Composable
+fun rememberLiveGuideNow(): Long {
+ var currentTime by remember { mutableLongStateOf(System.currentTimeMillis()) }
+ LaunchedEffect(Unit) {
+ while (true) {
+ currentTime = System.currentTimeMillis()
+ delay(30_000L)
+ }
+ }
+ return currentTime
+}
+
+@Composable
+fun LiveGuideNowProvider(content: @Composable () -> Unit) {
+ CompositionLocalProvider(LocalLiveGuideNow provides rememberLiveGuideNow()) {
+ content()
+ }
+}
+
+@Composable
+fun currentLiveGuideNow(): Long = LocalLiveGuideNow.current