Add build in debian linux on android 15+ section to tips

SimonSchubert · SimonSchubert · commit 5ea6f56725f5 · 2026-03-12T12:19:40.000+01:00
diff --git a/README.md b/README.md
@@ -2,7 +2,7 @@
 
 ![Icon](https://raw.githubusercontent.com/SimonSchubert/LinuxCommandLibrary/master/art/web_hi_res_144.png)
 
-The app currently has **8290** manual pages, **28+** basic categories and a bunch of general terminal tips. It works 100% offline, doesn't need an internet connection and has no tracking software.
+The app currently has **8293** manual pages, **28+** basic categories and a bunch of general terminal tips. It works 100% offline, doesn't need an internet connection and has no tracking software.
 
 [![App Store](https://raw.githubusercontent.com/SimonSchubert/LinuxCommandBibliotheca/master/art/app_store_badge.png)](https://apps.apple.com/us/app/linux-command-library/id1219649976)
 [![Play Store](https://raw.githubusercontent.com/SimonSchubert/LinuxCommandBibliotheca/master/art/play_store_badge.png)](https://play.google.com/store/apps/details?id=com.inspiredandroid.linuxcommandbibliotheca)
@@ -13,9 +13,13 @@ Native CLI and GUI binaries for Linux, macOS, and Windows are available in [Rele
 
 #### Homebrew
 
-GUI: ```brew install --cask simonschubert/tap/linux-command-library```
+GUI:
 
-CLI: ```brew install simonschubert/tap/linux-command-library-cli```
+```brew install --cask simonschubert/tap/linux-command-library```
+
+CLI:
+
+```brew install simonschubert/tap/linux-command-library-cli```
 
 ### Android screenshots
 
diff --git a/cli/src/commonMain/kotlin/com/linuxcommandlibrary/nativecli/screens/BasicDetailScreen.kt b/cli/src/commonMain/kotlin/com/linuxcommandlibrary/nativecli/screens/BasicDetailScreen.kt
@@ -62,6 +62,7 @@ class BasicDetailScreen(
             is com.linuxcommandlibrary.shared.TextElement.Bold -> Theme.boldText(element.text)
             is com.linuxcommandlibrary.shared.TextElement.Italic -> Theme.italicText(element.text)
             is com.linuxcommandlibrary.shared.TextElement.Man -> element.man
+            is com.linuxcommandlibrary.shared.TextElement.Link -> element.text
         }
     }
 
diff --git a/cli/src/commonMain/kotlin/com/linuxcommandlibrary/nativecli/screens/TipDetailScreen.kt b/cli/src/commonMain/kotlin/com/linuxcommandlibrary/nativecli/screens/TipDetailScreen.kt
@@ -52,6 +52,7 @@ class TipDetailScreen(private val tip: TipInfo) : Screen {
             is TextElement.Bold -> Theme.boldText(element.text)
             is TextElement.Italic -> Theme.italicText(element.text)
             is TextElement.Man -> element.man
+            is TextElement.Link -> element.text
         }
     }
 
diff --git a/common/src/commonMain/kotlin/com/linuxcommandlibrary/shared/TipSectionElement.kt b/common/src/commonMain/kotlin/com/linuxcommandlibrary/shared/TipSectionElement.kt
@@ -10,6 +10,7 @@ sealed class TextElement {
     data class Bold(val text: String) : TextElement()
     data class Italic(val text: String) : TextElement()
     data class Man(val man: String) : TextElement()
+    data class Link(val text: String, val action: String) : TextElement()
 }
 
 /**
diff --git a/composeApp/src/androidMain/kotlin/com/linuxcommandlibrary/app/platform/Platform.kt b/composeApp/src/androidMain/kotlin/com/linuxcommandlibrary/app/platform/Platform.kt
@@ -1,8 +1,47 @@
 package com.linuxcommandlibrary.app.platform
 
+import android.content.Intent
+import android.os.Build
+import android.provider.Settings
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.automirrored.filled.ArrowBack
+import androidx.compose.runtime.Composable
+import androidx.compose.runtime.remember
 import androidx.compose.ui.graphics.vector.ImageVector
+import androidx.compose.ui.platform.LocalContext
 
 actual val showRateAppButton: Boolean = true
+actual val showAndroidTerminalTip: Boolean = Build.VERSION.SDK_INT >= 35
 actual val backIcon: ImageVector = Icons.AutoMirrored.Filled.ArrowBack
+
+@Composable
+actual fun rememberOpenAppAction(): (String) -> Unit {
+    val context = LocalContext.current
+    return remember(context) {
+        { action ->
+            try {
+                when (action) {
+                    "settings" -> {
+                        context.startActivity(
+                            Intent(Settings.ACTION_SETTINGS).apply {
+                                addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+                            },
+                        )
+                    }
+
+                    "terminal" -> {
+                        val intent = context.packageManager.getLaunchIntentForPackage(
+                            "com.android.virtualization.terminal",
+                        )
+                        if (intent != null) {
+                            intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK)
+                            context.startActivity(intent)
+                        }
+                    }
+                }
+            } catch (e: Exception) {
+                e.printStackTrace()
+            }
+        }
+    }
+}
diff --git a/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/App.kt b/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/App.kt
@@ -63,6 +63,7 @@ import androidx.navigation.toRoute
 import com.linuxcommandlibrary.app.data.BasicsRepository
 import com.linuxcommandlibrary.app.data.CommandsRepository
 import com.linuxcommandlibrary.app.platform.backIcon
+import com.linuxcommandlibrary.app.platform.rememberOpenAppAction
 import com.linuxcommandlibrary.app.ui.composables.AppIcon
 import com.linuxcommandlibrary.app.ui.composables.rememberIconPainter
 import com.linuxcommandlibrary.app.ui.screens.AppInfoDialog
@@ -128,11 +129,16 @@ fun LinuxApp(initialDeeplink: String? = null) {
     }
     val showSearch = rememberSaveable { mutableStateOf(false) }
 
-    val onNavigate: (String) -> Unit = remember(navController) {
+    val openAppAction = rememberOpenAppAction()
+    val onNavigate: (String) -> Unit = remember(navController, openAppAction) {
         { route ->
-            val dest = parseRoute(route)
-            if (dest != null) {
-                navController.navigate(dest)
+            if (route.startsWith("action:")) {
+                openAppAction(route.removePrefix("action:"))
+            } else {
+                val dest = parseRoute(route)
+                if (dest != null) {
+                    navController.navigate(dest)
+                }
             }
         }
     }
diff --git a/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/platform/Platform.kt b/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/platform/Platform.kt
@@ -1,6 +1,11 @@
 package com.linuxcommandlibrary.app.platform
 
+import androidx.compose.runtime.Composable
 import androidx.compose.ui.graphics.vector.ImageVector
 
 expect val showRateAppButton: Boolean
+expect val showAndroidTerminalTip: Boolean
 expect val backIcon: ImageVector
+
+@Composable
+expect fun rememberOpenAppAction(): (String) -> Unit
diff --git a/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/composables/TableView.kt b/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/composables/TableView.kt
@@ -105,6 +105,8 @@ fun TableView(
                                             end,
                                         )
                                     }
+
+                                    is TextElement.Link -> append(element.text)
                                 }
                             }
                         }
@@ -126,5 +128,6 @@ private fun List<TextElement>.toPlainText(): String = this.joinToString("") { el
         is TextElement.Bold -> element.text
         is TextElement.Italic -> element.text
         is TextElement.Man -> element.man
+        is TextElement.Link -> element.text
     }
 }
diff --git a/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/composables/TipSectionContent.kt b/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/composables/TipSectionContent.kt
@@ -1,16 +1,20 @@
 package com.linuxcommandlibrary.app.ui.composables
 
 import androidx.compose.foundation.layout.padding
+import androidx.compose.foundation.text.ClickableText
+import androidx.compose.material.MaterialTheme
 import androidx.compose.material.Text
 import androidx.compose.runtime.Composable
 import androidx.compose.runtime.remember
 import androidx.compose.ui.Modifier
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.text.AnnotatedString
+import androidx.compose.ui.text.LinkAnnotation
 import androidx.compose.ui.text.SpanStyle
 import androidx.compose.ui.text.buildAnnotatedString
 import androidx.compose.ui.text.font.FontStyle
 import androidx.compose.ui.text.font.FontWeight
+import androidx.compose.ui.text.style.TextDecoration
 import androidx.compose.ui.text.withStyle
 import androidx.compose.ui.unit.Dp
 import androidx.compose.ui.unit.dp
@@ -20,6 +24,8 @@ import com.linuxcommandlibrary.shared.TipSectionElement
 fun buildTextElementString(
     elements: List<TextElement>,
     textColor: Color = Color.Unspecified,
+    linkColor: Color = Color.Unspecified,
+    onNavigate: ((String) -> Unit)? = null,
 ): AnnotatedString = buildAnnotatedString {
     elements.forEach { textElement ->
         when (textElement) {
@@ -38,6 +44,36 @@ fun buildTextElementString(
             }
 
             is TextElement.Man -> append(textElement.man)
+
+            is TextElement.Link -> {
+                if (onNavigate != null) {
+                    val start = this.length
+                    withStyle(
+                        style = SpanStyle(
+                            color = linkColor,
+                            fontWeight = FontWeight.Bold,
+                            textDecoration = TextDecoration.Underline,
+                        ),
+                    ) {
+                        append(textElement.text)
+                    }
+                    val end = this.length
+                    addLink(
+                        LinkAnnotation.Clickable(
+                            tag = "action:${textElement.action}",
+                            linkInteractionListener = {
+                                onNavigate("action:${textElement.action}")
+                            },
+                        ),
+                        start,
+                        end,
+                    )
+                } else {
+                    withStyle(style = SpanStyle(fontWeight = FontWeight.Bold, color = textColor)) {
+                        append(textElement.text)
+                    }
+                }
+            }
         }
     }
 }
@@ -49,11 +85,12 @@ fun TipSectionContent(
     textColor: Color = Color.Unspecified,
     commandVerticalPadding: Dp = 0.dp,
 ) {
+    val linkColor = MaterialTheme.colors.primary
     sections.forEach { section ->
         when (section) {
             is TipSectionElement.Text -> {
-                val annotatedString = remember(section.elements, textColor) {
-                    buildTextElementString(section.elements, textColor)
+                val annotatedString = remember(section.elements, textColor, linkColor) {
+                    buildTextElementString(section.elements, textColor, linkColor, onNavigate)
                 }
                 Text(
                     text = annotatedString,
diff --git a/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/screens/tips/TipsViewModel.kt b/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/screens/tips/TipsViewModel.kt
@@ -2,6 +2,9 @@ package com.linuxcommandlibrary.app.ui.screens.tips
 
 import com.linuxcommandlibrary.app.data.TipInfo
 import com.linuxcommandlibrary.app.data.TipsRepository
+import com.linuxcommandlibrary.app.platform.showAndroidTerminalTip
+import com.linuxcommandlibrary.shared.TextElement
+import com.linuxcommandlibrary.shared.TipSectionElement
 import kotlinx.collections.immutable.ImmutableList
 import kotlinx.collections.immutable.persistentListOf
 import kotlinx.collections.immutable.toImmutableList
@@ -20,7 +23,80 @@ class TipsViewModel(
 
     init {
         scope.launch(Dispatchers.Default) {
-            _tips.value = tipsRepository.getTips().toImmutableList()
+            val tips = tipsRepository.getTips()
+            _tips.value = if (showAndroidTerminalTip) {
+                (tips + createTerminalSetupTip()).toImmutableList()
+            } else {
+                tips.toImmutableList()
+            }
         }
     }
+
+    private fun createTerminalSetupTip(): TipInfo {
+        val sections = listOf(
+            TipSectionElement.Text(
+                listOf(
+                    TextElement.Plain("Android 15+ includes a built-in Linux terminal running Debian. Here's how to enable it:"),
+                ),
+            ),
+            TipSectionElement.Text(
+                listOf(
+                    TextElement.Plain("1. Open "),
+                    TextElement.Link("Settings", "settings"),
+                ),
+            ),
+            TipSectionElement.Text(
+                listOf(
+                    TextElement.Plain("2. Scroll down and tap "),
+                    TextElement.Bold("System"),
+                ),
+            ),
+            TipSectionElement.Text(
+                listOf(
+                    TextElement.Plain("3. Tap "),
+                    TextElement.Bold("Developer options"),
+                ),
+            ),
+            TipSectionElement.Text(
+                listOf(
+                    TextElement.Plain("If not visible, go to "),
+                    TextElement.Bold("Settings > About phone"),
+                    TextElement.Plain(" and tap "),
+                    TextElement.Bold("Build number"),
+                    TextElement.Plain(" 7 times to unlock it"),
+                ),
+            ),
+            TipSectionElement.Text(
+                listOf(
+                    TextElement.Plain("4. Scroll down to the "),
+                    TextElement.Bold("Linux terminal"),
+                    TextElement.Plain(" toggle and enable it"),
+                ),
+            ),
+            TipSectionElement.Text(
+                listOf(
+                    TextElement.Plain("5. Open the "),
+                    TextElement.Link("Terminal", "terminal"),
+                    TextElement.Plain(" app from your app drawer"),
+                ),
+            ),
+            TipSectionElement.Text(
+                listOf(
+                    TextElement.Plain("6. Follow the on-screen setup to complete the installation"),
+                ),
+            ),
+            TipSectionElement.Text(
+                listOf(
+                    TextElement.Plain("The terminal runs a Debian Linux environment with full package management via "),
+                    TextElement.Bold("apt"),
+                    TextElement.Plain(". You can install tools, compilers, and servers just like on a regular Debian system."),
+                ),
+            ),
+        )
+        return TipInfo(
+            id = -1,
+            title = "Set up the built-in Linux terminal",
+            sections = sections.toImmutableList(),
+        )
+    }
 }
diff --git a/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/theme/DynamicThemeColors.kt b/composeApp/src/commonMain/kotlin/com/linuxcommandlibrary/app/ui/theme/DynamicThemeColors.kt
diff --git a/composeApp/src/desktopMain/kotlin/com/linuxcommandlibrary/app/platform/Platform.kt b/composeApp/src/desktopMain/kotlin/com/linuxcommandlibrary/app/platform/Platform.kt
@@ -2,7 +2,12 @@ package com.linuxcommandlibrary.app.platform
 
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.automirrored.filled.ArrowBack
+import androidx.compose.runtime.Composable
 import androidx.compose.ui.graphics.vector.ImageVector
 
 actual val showRateAppButton: Boolean = false
+actual val showAndroidTerminalTip: Boolean = false
 actual val backIcon: ImageVector = Icons.AutoMirrored.Filled.ArrowBack
+
+@Composable
+actual fun rememberOpenAppAction(): (String) -> Unit = {}
diff --git a/composeApp/src/iosMain/kotlin/com/linuxcommandlibrary/app/platform/Platform.kt b/composeApp/src/iosMain/kotlin/com/linuxcommandlibrary/app/platform/Platform.kt
@@ -2,7 +2,12 @@ package com.linuxcommandlibrary.app.platform
 
 import androidx.compose.material.icons.Icons
 import androidx.compose.material.icons.automirrored.filled.ArrowBackIos
+import androidx.compose.runtime.Composable
 import androidx.compose.ui.graphics.vector.ImageVector
 
 actual val showRateAppButton: Boolean = false
+actual val showAndroidTerminalTip: Boolean = false
 actual val backIcon: ImageVector = Icons.AutoMirrored.Filled.ArrowBackIos
+
+@Composable
+actual fun rememberOpenAppAction(): (String) -> Unit = {}
diff --git a/websiteBuilder/src/main/kotlin/com/linuxcommandlibrary/desktop/HtmlMarkdownRenderer.kt b/websiteBuilder/src/main/kotlin/com/linuxcommandlibrary/desktop/HtmlMarkdownRenderer.kt
@@ -44,6 +44,7 @@ object HtmlMarkdownRenderer {
         is TextElement.Bold -> "<b>${element.text.escapeHtml()}</b>"
         is TextElement.Italic -> "<i>${element.text.escapeHtml()}</i>"
         is TextElement.Man -> """<a href="/man/${element.man}" title="${element.man} man page">${element.man}</a>"""
+        is TextElement.Link -> "<b>${element.text.escapeHtml()}</b>"
     }
 
     private fun renderCode(code: TipSectionElement.Code): String {
@@ -88,6 +89,7 @@ object HtmlMarkdownRenderer {
                     is TextElement.Bold -> element.text.isNotBlank()
                     is TextElement.Italic -> element.text.isNotBlank()
                     is TextElement.Man -> true
+                    is TextElement.Link -> element.text.isNotBlank()
                 }
             }
         }
diff --git a/websiteBuilder/src/main/kotlin/com/linuxcommandlibrary/desktop/MarkdownBuilder.kt b/websiteBuilder/src/main/kotlin/com/linuxcommandlibrary/desktop/MarkdownBuilder.kt
@@ -42,9 +42,13 @@ class MarkdownBuilder {
         stream.appendLine()
         stream.appendLine("#### Homebrew")
         stream.appendLine()
-        stream.appendLine("GUI: ```brew install --cask simonschubert/tap/linux-command-library```")
+        stream.appendLine("GUI:")
         stream.appendLine()
-        stream.appendLine("CLI: ```brew install simonschubert/tap/linux-command-library-cli```")
+        stream.appendLine("```brew install --cask simonschubert/tap/linux-command-library```")
+        stream.appendLine()
+        stream.appendLine("CLI:")
+        stream.appendLine()
+        stream.appendLine("```brew install simonschubert/tap/linux-command-library-cli```")
         stream.appendLine()
         stream.appendLine("### Android screenshots")
         stream.appendLine()

Original file line number	Diff line number	Diff line change
`@@ -62,6 +62,7 @@ class BasicDetailScreen(`
`62`	`62`	`is com.linuxcommandlibrary.shared.TextElement.Bold -> Theme.boldText(element.text)`
`63`	`63`	`is com.linuxcommandlibrary.shared.TextElement.Italic -> Theme.italicText(element.text)`
`64`	`64`	`is com.linuxcommandlibrary.shared.TextElement.Man -> element.man`
	`65`	`+ is com.linuxcommandlibrary.shared.TextElement.Link -> element.text`
`65`	`66`	`}`
`66`	`67`	`}`
`67`	`68`
Original file line number	Diff line number	Diff line change
`@@ -52,6 +52,7 @@ class TipDetailScreen(private val tip: TipInfo) : Screen {`
`52`	`52`	`is TextElement.Bold -> Theme.boldText(element.text)`
`53`	`53`	`is TextElement.Italic -> Theme.italicText(element.text)`
`54`	`54`	`is TextElement.Man -> element.man`
	`55`	`+ is TextElement.Link -> element.text`
`55`	`56`	`}`
`56`	`57`	`}`
`57`	`58`
Original file line number	Diff line number	Diff line change
`@@ -10,6 +10,7 @@ sealed class TextElement {`
`10`	`10`	`data class Bold(val text: String) : TextElement()`
`11`	`11`	`data class Italic(val text: String) : TextElement()`
`12`	`12`	`data class Man(val man: String) : TextElement()`
	`13`	`+ data class Link(val text: String, val action: String) : TextElement()`
`13`	`14`	`}`
`14`	`15`
`15`	`16`	`/**`
Original file line number	Diff line number	Diff line change
`@@ -105,6 +105,8 @@ fun TableView(`
`105`	`105`	`end,`
`106`	`106`	`)`
`107`	`107`	`}`
	`108`	`+`
	`109`	`+ is TextElement.Link -> append(element.text)`
`108`	`110`	`}`
`109`	`111`	`}`
`110`	`112`	`}`
`@@ -126,5 +128,6 @@ private fun List<TextElement>.toPlainText(): String = this.joinToString("") { el`
`126`	`128`	`is TextElement.Bold -> element.text`
`127`	`129`	`is TextElement.Italic -> element.text`
`128`	`130`	`is TextElement.Man -> element.man`
	`131`	`+ is TextElement.Link -> element.text`
`129`	`132`	`}`
`130`	`133`	`}`