Skip to content

A rootless Android app that boots Alpine Linux: run containers (Podman/Docker/LXC) and GUI desktop apps.

feat(ui): render server-mode black overlay with hold-to-exit

ExTvafe9b9d61493
diff --git a/app/src/main/java/com/excp/podroid/MainActivity.kt b/app/src/main/java/com/excp/podroid/MainActivity.kt
index cab5c08..c35cfe7 100644
--- a/app/src/main/java/com/excp/podroid/MainActivity.kt
+++ b/app/src/main/java/com/excp/podroid/MainActivity.kt
@@ -36,14 +36,37 @@ class MainActivity : ComponentActivity() {
setContent {
val windowSizeClass = calculateWindowSizeClass(this)
val navVm: NavGraphViewModel = hiltViewModel()
+ val headlessVm: com.excp.podroid.ui.HeadlessViewModel = hiltViewModel()
val darkTheme by navVm.darkTheme.collectAsStateWithLifecycle(initialValue = null)
val dynamicColor by navVm.dynamicColorEnabled.collectAsStateWithLifecycle(initialValue = false)
+ val headlessActive by headlessVm.active.collectAsStateWithLifecycle()
+
+ // Server mode: near-zero window brightness + keep the screen on so the
+ // app stays foreground (the VM is never backgrounded -> never killed).
+ androidx.compose.runtime.LaunchedEffect(headlessActive) {
+ val lp = window.attributes
+ if (headlessActive) {
+ lp.screenBrightness = 0.004f
+ window.attributes = lp
+ window.addFlags(android.view.WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
+ } else {
+ lp.screenBrightness = android.view.WindowManager.LayoutParams.BRIGHTNESS_OVERRIDE_NONE
+ window.attributes = lp
+ window.clearFlags(android.view.WindowManager.LayoutParams.FLAG_KEEP_SCREEN_ON)
+ }
+ }
+
PodroidTheme(darkTheme = darkTheme, dynamicColor = dynamicColor) {
Surface(
modifier = Modifier.fillMaxSize(),
color = MaterialTheme.colorScheme.background,
) {
- PodroidNavGraph(windowSizeClass = windowSizeClass)
+ androidx.compose.foundation.layout.Box(Modifier.fillMaxSize()) {
+ PodroidNavGraph(windowSizeClass = windowSizeClass)
+ if (headlessActive) {
+ com.excp.podroid.ui.components.HeadlessOverlay(onExit = { headlessVm.disable() })
+ }
+ }
}
}
}
diff --git a/app/src/main/java/com/excp/podroid/ui/HeadlessViewModel.kt b/app/src/main/java/com/excp/podroid/ui/HeadlessViewModel.kt
new file mode 100644
index 0000000..f414ffb
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/HeadlessViewModel.kt
@@ -0,0 +1,22 @@
+/*
+ * Podroid - Rootless Podman for Android
+ * Copyright (C) 2024-2026 Podroid contributors
+ *
+ * Exposes the shared server-mode state to MainActivity so it can draw the black
+ * overlay and drop window brightness, and lets the overlay turn it off.
+ */
+package com.excp.podroid.ui
+
+import androidx.lifecycle.ViewModel
+import com.excp.podroid.engine.hostbridge.HeadlessModeManager
+import dagger.hilt.android.lifecycle.HiltViewModel
+import kotlinx.coroutines.flow.StateFlow
+import javax.inject.Inject
+
+@HiltViewModel
+class HeadlessViewModel @Inject constructor(
+ private val headlessModeManager: HeadlessModeManager,
+) : ViewModel() {
+ val active: StateFlow<Boolean> = headlessModeManager.active
+ fun disable() = headlessModeManager.setActive(false)
+}
diff --git a/app/src/main/java/com/excp/podroid/ui/components/HeadlessOverlay.kt b/app/src/main/java/com/excp/podroid/ui/components/HeadlessOverlay.kt
new file mode 100644
index 0000000..699c969
--- /dev/null
+++ b/app/src/main/java/com/excp/podroid/ui/components/HeadlessOverlay.kt
@@ -0,0 +1,65 @@
+/*
+ * Podroid - Rootless Podman for Android
+ * Copyright (C) 2024-2026 Podroid contributors
+ *
+ * Full-screen pure-black overlay for server mode. Consumes all touches (the app
+ * is still foreground, so this prevents stray input), shows a faint exit hint for
+ * a few seconds, and exits on a 3-second press-and-hold.
+ */
+package com.excp.podroid.ui.components
+
+import androidx.compose.foundation.background
+import androidx.compose.foundation.gestures.awaitEachGesture
+import androidx.compose.foundation.gestures.awaitFirstDown
+import androidx.compose.foundation.gestures.waitForUpOrCancellation
+import androidx.compose.foundation.layout.Box
+import androidx.compose.foundation.layout.fillMaxSize
+import androidx.compose.foundation.layout.padding
+import androidx.compose.material3.Text
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.LaunchedEffect
+import androidx.compose.runtime.getValue
+import androidx.compose.runtime.mutableStateOf
+import androidx.compose.runtime.remember
+import androidx.compose.runtime.setValue
+import androidx.compose.ui.Alignment
+import androidx.compose.ui.Modifier
+import androidx.compose.ui.graphics.Color
+import androidx.compose.ui.input.pointer.pointerInput
+import androidx.compose.ui.res.stringResource
+import androidx.compose.ui.unit.dp
+import com.excp.podroid.R
+import kotlinx.coroutines.delay
+import kotlinx.coroutines.withTimeoutOrNull
+
+@Composable
+fun HeadlessOverlay(onExit: () -> Unit) {
+ var hintVisible by remember { mutableStateOf(true) }
+ // Hide the hint a few seconds after it (re)appears, keeping the screen black.
+ LaunchedEffect(hintVisible) {
+ if (hintVisible) { delay(4000); hintVisible = false }
+ }
+ Box(
+ modifier = Modifier
+ .fillMaxSize()
+ .background(Color.Black)
+ .pointerInput(Unit) {
+ awaitEachGesture {
+ awaitFirstDown(requireUnconsumed = false)
+ hintVisible = true
+ // null == the 3s timeout fired while still held -> exit.
+ val releasedEarly = withTimeoutOrNull(3000L) { waitForUpOrCancellation(); true }
+ if (releasedEarly == null) onExit()
+ }
+ },
+ contentAlignment = Alignment.BottomCenter,
+ ) {
+ if (hintVisible) {
+ Text(
+ text = stringResource(R.string.server_mode_exit_hint),
+ color = Color(0x33FFFFFF),
+ modifier = Modifier.padding(bottom = 48.dp),
+ )
+ }
+ }
+}