Skip to content

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.md
index 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.kt
index 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.kt
index 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.List
import androidx.compose.material.icons.filled.MoreVert
import androidx.compose.material.icons.filled.Search
import androidx.compose.material.icons.filled.Settings
+import androidx.compose.material.icons.filled.Share
import androidx.compose.material3.AlertDialog
import androidx.compose.material3.AssistChip
import androidx.compose.material3.Badge
@@ -93,6 +94,7 @@ import androidx.compose.ui.graphics.SolidColor
import androidx.compose.ui.graphics.lerp
import androidx.compose.ui.graphics.vector.ImageVector
import androidx.compose.ui.graphics.vector.PathParser
+import androidx.compose.ui.platform.LocalContext
import androidx.compose.ui.platform.LocalDensity
import androidx.compose.ui.platform.testTag
import 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.current
val others = state.device.access?.others.orEmpty().size
val fresh = state.historyNew
IconButton(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.kt
index 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.Intent
import androidx.compose.foundation.clickable
import androidx.compose.foundation.layout.Arrangement
import androidx.compose.foundation.layout.Column
@@ -21,6 +23,7 @@ import androidx.compose.material.icons.automirrored.filled.ArrowBack
import androidx.compose.material.icons.automirrored.filled.KeyboardArrowRight
import androidx.compose.material.icons.filled.KeyboardArrowDown
import androidx.compose.material.icons.filled.KeyboardArrowUp
+import androidx.compose.material.icons.filled.Share
import androidx.compose.material.icons.filled.Star
import androidx.compose.material3.AlertDialog
import androidx.compose.material3.Button
@@ -52,6 +55,7 @@ import androidx.compose.ui.graphics.PathFillType
import androidx.compose.ui.graphics.SolidColor
import androidx.compose.ui.graphics.vector.ImageVector
import androidx.compose.ui.graphics.vector.PathParser
+import androidx.compose.ui.platform.LocalContext
import androidx.compose.ui.platform.LocalUriHandler
import androidx.compose.ui.semantics.Role
import 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.current
val 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.kt
index 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.Intent
import android.graphics.Bitmap
import android.graphics.Canvas
import android.graphics.Paint
@@ -106,6 +107,7 @@ import app.tellyscope.ui.ReportKind
import app.tellyscope.ui.ReportScreen
import app.tellyscope.ui.ReportUi
import app.tellyscope.ui.SettingsScreen
+import app.tellyscope.ui.SHARE_TEXT
import app.tellyscope.data.RELEASES
import androidx.compose.ui.platform.UriHandler
import androidx.compose.ui.platform.LocalUriHandler
@@ -131,6 +133,8 @@ import org.junit.Rule
import org.junit.Test
import org.junit.runner.RunWith
import org.robolectric.RobolectricTestRunner
+import org.robolectric.RuntimeEnvironment
+import org.robolectric.Shadows.shadowOf
import org.robolectric.annotation.Config
import 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()() }