Debloat your Android TV, install apps, browse and transfer files on it, all from your phone. Just 3 MB, no tracking, no root, no PC.
Share Tellyscope in the TV menu and in Settings
jesse-agent-2327d2eb4aefc99
diff --git a/CHANGELOG.md b/CHANGELOG.mdindex a6d96bb..0b2b54d 100644--- a/CHANGELOG.md+++ b/CHANGELOG.md@@ -12,6 +12,8 @@ until this file has a section for its version.## Unreleased+- **New:** Share Tellyscope, in ⋮ and in Settings, sends a friend the GitHub link.+## 0.11.0 — 2026-10-27- **New:** A Home screen card in Tweaks: pick your TV's home screen in one place. [#186](../../pull/186)diff --git a/app/src/main/java/app/tellyscope/ui/Copy.kt b/app/src/main/java/app/tellyscope/ui/Copy.ktindex 0b1fb3e..38a2239 100644--- a/app/src/main/java/app/tellyscope/ui/Copy.kt+++ b/app/src/main/java/app/tellyscope/ui/Copy.kt@@ -585,6 +585,9 @@ object Copy {const val HISTORY = "History"const val ADVANCED_MONITOR = "Advanced monitor"+ /** In the TV menu and in Settings: opens Android's share sheet with the repo link. */+ const val SHARE = "Share Tellyscope"+/** Under History in the menu, and on top of the History screen: apps Restore everything turns back on. */fun stillOff(n: Int) = if (n == 1) "1 app still off" else "$n apps still off"fun stillOffTitle(n: Int) = if (n == 1) "1 app Tellyscope turned off is still off" else "$n apps Tellyscope turned off are still off"diff --git a/app/src/main/java/app/tellyscope/ui/DeviceTabs.kt b/app/src/main/java/app/tellyscope/ui/DeviceTabs.ktindex b891acb..8ea1bfc 100644--- a/app/src/main/java/app/tellyscope/ui/DeviceTabs.kt+++ b/app/src/main/java/app/tellyscope/ui/DeviceTabs.kt@@ -38,6 +38,7 @@ import androidx.compose.material.icons.filled.Listimport androidx.compose.material.icons.filled.MoreVertimport androidx.compose.material.icons.filled.Searchimport androidx.compose.material.icons.filled.Settings+import androidx.compose.material.icons.filled.Shareimport androidx.compose.material3.AlertDialogimport androidx.compose.material3.AssistChipimport androidx.compose.material3.Badge@@ -93,6 +94,7 @@ import androidx.compose.ui.graphics.SolidColorimport androidx.compose.ui.graphics.lerpimport androidx.compose.ui.graphics.vector.ImageVectorimport androidx.compose.ui.graphics.vector.PathParser+import androidx.compose.ui.platform.LocalContextimport androidx.compose.ui.platform.LocalDensityimport androidx.compose.ui.platform.testTagimport androidx.compose.ui.text.SpanStyle@@ -461,6 +463,7 @@ private fun AppMenu(state: UiState, actions: DeviceActions) {if (forgetting) ForgetDialog(name(device), onForget = { forgetting = false; actions.forget(device.id) }, onDismiss = { forgetting = false })if (renaming) RenameDialog(device.nickname.orEmpty(), device.model ?: networkName(device), onSave = { renaming = false; actions.rename(device.id, it) }, onDismiss = { renaming = false })val c = MaterialTheme.colorScheme+ val context = LocalContext.currentval others = state.device.access?.others.orEmpty().sizeval fresh = state.historyNewIconButton(onClick = { open = true }) {@@ -500,6 +503,7 @@ private fun AppMenu(state: UiState, actions: DeviceActions) {Text("Tellyscope", style = MaterialTheme.typography.labelLarge, color = c.onSurfaceVariant, modifier = Modifier.padding(start = 16.dp, top = 16.dp, bottom = 8.dp))SheetGroup({ MenuRow(Icons.Default.Settings, "Settings") { pick(actions.settings) } },+ { MenuRow(Icons.Default.Share, Copy.SHARE) { pick { shareTellyscope(context) } } },{ MenuRow(Icons.Default.Info, "About & licences") { pick { about = true } } },)Spacer(Modifier.height(16.dp))diff --git a/app/src/main/java/app/tellyscope/ui/SettingsScreen.kt b/app/src/main/java/app/tellyscope/ui/SettingsScreen.ktindex 736c014..37f88cc 100644--- a/app/src/main/java/app/tellyscope/ui/SettingsScreen.kt+++ b/app/src/main/java/app/tellyscope/ui/SettingsScreen.kt@@ -3,6 +3,8 @@package app.tellyscope.ui+import android.content.Context+import android.content.Intentimport androidx.compose.foundation.clickableimport androidx.compose.foundation.layout.Arrangementimport androidx.compose.foundation.layout.Column@@ -21,6 +23,7 @@ import androidx.compose.material.icons.automirrored.filled.ArrowBackimport androidx.compose.material.icons.automirrored.filled.KeyboardArrowRightimport androidx.compose.material.icons.filled.KeyboardArrowDownimport androidx.compose.material.icons.filled.KeyboardArrowUp+import androidx.compose.material.icons.filled.Shareimport androidx.compose.material.icons.filled.Starimport androidx.compose.material3.AlertDialogimport androidx.compose.material3.Button@@ -52,6 +55,7 @@ import androidx.compose.ui.graphics.PathFillTypeimport androidx.compose.ui.graphics.SolidColorimport androidx.compose.ui.graphics.vector.ImageVectorimport androidx.compose.ui.graphics.vector.PathParser+import androidx.compose.ui.platform.LocalContextimport androidx.compose.ui.platform.LocalUriHandlerimport androidx.compose.ui.semantics.Roleimport androidx.compose.ui.unit.dp@@ -64,8 +68,17 @@ internal const val CLEANYOURTV = "https://github.com/Gathin23/cleanyourtv"/** CONTRIBUTING's guide to pointing the app at your own lists. */internal val OWN_LISTS_GUIDE = RELEASES.removeSuffix("/releases") + "/blob/main/CONTRIBUTING.md#using-your-own-lists"+/** What Share Tellyscope sends: what it is, then the repo, whose page shows it and how to install. */+internal val SHARE_TEXT = "Tellyscope: debloat and control your Android TV from your phone. Free, open source, no tracking. $REPO"++/** Android's share sheet with [SHARE_TEXT], so any app the user picks can send it on. */+internal fun shareTellyscope(context: Context) {+ val send = Intent(Intent.ACTION_SEND).setType("text/plain").putExtra(Intent.EXTRA_TEXT, SHARE_TEXT)+ runCatching { context.startActivity(Intent.createChooser(send, null)) }+}+/**- * App-wide choices, not tied to one TV: update checks and Report a problem first, then a folded+ * App-wide choices, not tied to one TV: update checks, Report a problem and Share Tellyscope first, then a folded* Advanced with where the debloat lists come from and how to use your own.*/@OptIn(ExperimentalMaterial3Api::class)@@ -88,6 +101,7 @@ fun SettingsScreen(var editing by rememberSaveable { mutableStateOf(false) }var advanced by rememberSaveable { mutableStateOf(false) }val browser = LocalUriHandler.current+ val context = LocalContext.currentval open = { url: String -> runCatching { browser.openUri(url) }; Unit }if (editing) SourceDialog(listSource, onSave = { editing = false; onListSource(it) }, onDismiss = { editing = false })Scaffold(@@ -150,6 +164,17 @@ fun SettingsScreen(Spacer(Modifier.width(16.dp))Icon(Icons.AutoMirrored.Filled.KeyboardArrowRight, contentDescription = null)}+ HorizontalDivider(color = MaterialTheme.colorScheme.surface)+ Row(Modifier.fillMaxWidth().clickable { shareTellyscope(context) }.padding(16.dp), verticalAlignment = Alignment.CenterVertically) {+ Icon(Icons.Default.Share, contentDescription = null, tint = MaterialTheme.colorScheme.onSurfaceVariant)+ Spacer(Modifier.width(16.dp))+ Column(Modifier.weight(1f)) {+ Text(Copy.SHARE, style = MaterialTheme.typography.titleSmall)+ Text("Send someone the link to Tellyscope\u2019s GitHub page.", style = MaterialTheme.typography.bodyMedium)+ }+ Spacer(Modifier.width(16.dp))+ Icon(Icons.AutoMirrored.Filled.KeyboardArrowRight, contentDescription = null)+ }}}item {diff --git a/app/src/test/java/app/tellyscope/ScreenshotTest.kt b/app/src/test/java/app/tellyscope/ScreenshotTest.ktindex 41cc393..cc9853e 100644--- a/app/src/test/java/app/tellyscope/ScreenshotTest.kt+++ b/app/src/test/java/app/tellyscope/ScreenshotTest.kt@@ -2,6 +2,7 @@package app.tellyscope+import android.content.Intentimport android.graphics.Bitmapimport android.graphics.Canvasimport android.graphics.Paint@@ -106,6 +107,7 @@ import app.tellyscope.ui.ReportKindimport app.tellyscope.ui.ReportScreenimport app.tellyscope.ui.ReportUiimport app.tellyscope.ui.SettingsScreen+import app.tellyscope.ui.SHARE_TEXTimport app.tellyscope.data.RELEASESimport androidx.compose.ui.platform.UriHandlerimport androidx.compose.ui.platform.LocalUriHandler@@ -131,6 +133,8 @@ import org.junit.Ruleimport org.junit.Testimport org.junit.runner.RunWithimport org.robolectric.RobolectricTestRunner+import org.robolectric.RuntimeEnvironment+import org.robolectric.Shadows.shadowOfimport org.robolectric.annotation.Configimport org.robolectric.annotation.GraphicsMode@@ -586,7 +590,7 @@ class ScreenshotTest {compose.onNodeWithContentDescription("More options").performClick()compose.mainClock.advanceTimeBy(1_000)// Every group is there: this TV's items, the app's, then Forget. Rename, Forget and About open dialogs.- for (i in listOf("Rename this TV", Copy.HISTORY, Copy.ADVANCED_MONITOR, "Settings", "About & licences", "Forget this TV")) compose.onNodeWithText(i).assertHasClickAction()+ for (i in listOf("Rename this TV", Copy.HISTORY, Copy.ADVANCED_MONITOR, "Settings", Copy.SHARE, "About & licences", "Forget this TV")) compose.onNodeWithText(i).assertHasClickAction()compose.onNodeWithText(item).performClick()compose.mainClock.advanceTimeBy(1_000)return calls@@ -595,6 +599,21 @@ class ScreenshotTest {@Test fun tabs_menuAdvancedOpensAdvanced() = assertEquals(listOf("advanced"), pickFromMenu(Copy.ADVANCED_MONITOR))@Test fun tabs_menuHistoryOpensHistory() = assertEquals(listOf("history"), pickFromMenu(Copy.HISTORY))@Test fun tabs_menuSettingsOpensSettings() = assertEquals(listOf("settings"), pickFromMenu("Settings"))+ @Test fun tabs_menuShareOpensShareSheet() {+ assertEquals(emptyList<String>(), pickFromMenu(Copy.SHARE))+ assertSharedTellyscope()+ }++ /** The last activity started is Android's share sheet around a plain-text send of [SHARE_TEXT]. */+ private fun assertSharedTellyscope() {+ val chooser = shadowOf(RuntimeEnvironment.getApplication()).nextStartedActivity+ assertEquals(Intent.ACTION_CHOOSER, chooser.action)+ @Suppress("DEPRECATION") val send = chooser.getParcelableExtra<Intent>(Intent.EXTRA_INTENT)!!+ assertEquals(Intent.ACTION_SEND, send.action)+ assertEquals("text/plain", send.type)+ assertEquals(SHARE_TEXT, send.getStringExtra(Intent.EXTRA_TEXT))+ assertTrue(SHARE_TEXT.endsWith(RELEASES.removeSuffix("/releases")))+ }private fun settings(opened: MutableList<String> = mutableListOf()) = @Composable {val links = object : UriHandler { override fun openUri(uri: String) { opened += uri } }@@ -621,6 +640,12 @@ class ScreenshotTest {compose.onNodeWithText("Use your own debloat lists").assertHasClickAction()}+ @Test fun settings_shareOpensShareSheet() {+ compose.setContent { TellyscopeTheme(dark = false, dynamic = false) { settings()() } }+ compose.onNodeWithText(Copy.SHARE).performClick()+ assertSharedTellyscope()+ }+@Test fun settings_dark() = shot("81_settings", dark = true) { settings()() }@Test fun settings_advanced() = shot("82_settings_advanced", before = { compose.onNodeWithText("Advanced").performClick(); Unit }) { settings()() }@Test fun settings_advanced_dark() = shot("82_settings_advanced", dark = true, before = { compose.onNodeWithText("Advanced").performClick(); Unit }) { settings()() }