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.
README gallery: 12 shots, Advanced's four tabs and Shell
tellyscope-agent6195dcfbfbcf
diff --git a/README.md b/README.mdindex 44bd8d3..776532a 100644--- a/README.md+++ b/README.md@@ -34,17 +34,29 @@ Debloat your Android TV, install apps, and browse and transfer files on it, all<td><img src="docs/screenshots/send.png" alt="Sending a video from the phone to the TV's Movies folder"></td><td><img src="docs/screenshots/tweaks.png" alt="Tweaks: the Home screen card with Google TV Home as Current and Get another launcher, then ad-blocking Private DNS on, faster animations and clear caches"></td><td><img src="docs/screenshots/home.png" alt="Make Projectivy Launcher the home screen: the confirm says Google TV Home, the TV's built-in launcher, is the only one ever turned off"></td>- <td><img src="docs/screenshots/advanced.png" alt="Advanced monitor: CPU and RAM by app, the TV's network connection, and the apps' open connections"></td>+ <td><img src="docs/screenshots/this-tv.png" alt="Advanced monitor, This TV: CPU, memory and storage rings, the network's last minute, and the TV's facts"></td></tr><tr><td align="center"><sub>Send files to the TV</sub></td><td align="center"><sub>Block ads, tweak the TV, add a launcher</sub></td><td align="center"><sub>Make a launcher Home</sub></td>- <td align="center"><sub>Advanced monitor: what is using the CPU, RAM and network</sub></td>+ <td align="center"><sub>Advanced monitor: the TV at a glance</sub></td>+ </tr>+ <tr>+ <td><img src="docs/screenshots/cpu.png" alt="Advanced monitor, CPU: the last minute's CPU use over the apps using it most"></td>+ <td><img src="docs/screenshots/ram.png" alt="Advanced monitor, RAM: memory in use over the apps holding the most"></td>+ <td><img src="docs/screenshots/network.png" alt="Advanced monitor, Network: the TV's traffic and connection, then the data each app has used"></td>+ <td><img src="docs/screenshots/shell.png" alt="Shell: a terminal on the TV after getprop and pm list packages"></td>+ </tr>+ <tr>+ <td align="center"><sub>What is using the CPU</sub></td>+ <td align="center"><sub>What is using the RAM</sub></td>+ <td align="center"><sub>What is using the network</sub></td>+ <td align="center"><sub>A shell on the TV</sub></td></tr></table>-<sub>Rendered from the app's screenshot tests with sample data. The Install dialog is drawn to match the app, and Advanced monitor joins parts of its longer page.</sub>+<sub>Rendered from the app's screenshot tests with sample data. The Install dialog is drawn to match the app.</sub>## What it doesdiff --git a/app/src/test/java/app/tellyscope/ScreenshotTest.kt b/app/src/test/java/app/tellyscope/ScreenshotTest.ktindex 61d6559..a6b4a1b 100644--- a/app/src/test/java/app/tellyscope/ScreenshotTest.kt+++ b/app/src/test/java/app/tellyscope/ScreenshotTest.kt@@ -38,6 +38,14 @@ import androidx.compose.ui.test.hasScrollActionimport androidx.compose.ui.test.hasTextimport androidx.compose.ui.test.onNodeWithTagimport app.tellyscope.adb.ApkInfo+import app.tellyscope.adb.ShellChannel+import app.tellyscope.adb.ShellPacket+import app.tellyscope.adb.TvShell+import app.tellyscope.ui.ShellTerminal+import androidx.compose.ui.test.hasClickAction+import java.util.concurrent.LinkedBlockingQueue+import kotlinx.coroutines.CoroutineScope+import kotlinx.coroutines.Dispatchersimport app.tellyscope.adb.AppFactsimport app.tellyscope.adb.ConnectionRequestimport app.tellyscope.adb.InstallRefusal@@ -1722,6 +1730,48 @@ class ScreenshotTest {compose.onNodeWithText(Copy.makeHomeTitle("Projectivy Launcher").text()).assertExists()}+ // Advanced's tabs on a minute of stats, so the graphs have a line.+ private fun readmeAdvanced() = deviceState {+ val recent = (29 downTo 0).map { fake.snapshot(xgimi.ip).copy(at = now - it * 2_000L) }+ copy(snapshot = recent.last(), recent = recent)+ }+ private fun advancedTab(label: String) = { compose.onAllNodes(hasText(label) and hasClickAction()).onFirst().performClick(); Unit }+ @Test fun readme_thisTv() = shot("31_readme_this_tv") { AdvancedScreen(readmeAdvanced(), back = {}) }+ @Test fun readme_cpu() = shot("32_readme_cpu", before = advancedTab("CPU")) { AdvancedScreen(readmeAdvanced(), back = {}) }+ @Test fun readme_ram() = shot("33_readme_ram", before = advancedTab("RAM")) { AdvancedScreen(readmeAdvanced(), back = {}) }+ @Test fun readme_network() = shot("34_readme_network", before = advancedTab("Network")) { AdvancedScreen(readmeAdvanced(), back = {}) }++ /** A shell on the TV that answers each command from [replies] and ends it with TvShell's marker line. */+ private class ReadmeChannel(val replies: Map<String, String>) : ShellChannel {+ private val frames = LinkedBlockingQueue<ShellPacket>()+ override fun read(): ShellPacket = frames.take()+ override fun write(bytes: ByteArray) {+ val command = String(bytes).substringAfter("{ ").substringBefore("\n}")+ replies[command]?.let { frames.add(ShellPacket.Out("$it\n".toByteArray())) }+ frames.add(ShellPacket.Out("\u001ETELLYSCOPE 0 /\n".toByteArray()))+ }+ override fun close() {}+ }++ // Shell after three read-only commands.+ @Test fun readme_shell() {+ val xgimiApps = runBlocking { fake.apps(xgimi.ip) }.map { it.packageName }.filter { it.startsWith("com.xgimi.") }.sorted()+ val replies = linkedMapOf(+ "getprop ro.product.model" to "XGIMI Horizon Pro",+ "getprop ro.build.version.release" to "11",+ "pm list packages xgimi" to xgimiApps.joinToString("\n") { "package:$it" },+ )+ val channel = ReadmeChannel(replies)+ val terminal = ShellTerminal(TvShell({ throw IOException("no one-shot shell") }) { channel }, CoroutineScope(Dispatchers.IO))+ for (command in replies.keys) {+ terminal.submit(command, online = true)+ repeat(200) { if (terminal.state.value.running) Thread.sleep(10) }+ assertFalse(terminal.state.value.running)+ }+ shot("35_readme_shell", before = advancedTab("Shell")) { AdvancedScreen(readmeAdvanced(), back = {}, terminal = terminal) }+ compose.onAllNodesWithText("package:com.xgimi.ota").onFirst().assertExists()+ }+private fun homeCard(dark: Boolean) {shot("78_tweaks_home_card", dark) { DeviceTabsScreen(homeState(home = true), DeviceActions(), startTab = TvTab.Tweaks) }compose.onNodeWithText(Copy.builtIn(off = true).text()).assertExists()diff --git a/docs/screenshots/advanced.png b/docs/screenshots/advanced.pngdeleted file mode 100644index 30d8c9c..0000000Binary files a/docs/screenshots/advanced.png and /dev/null differdiff --git a/docs/screenshots/frame.py b/docs/screenshots/frame.pyindex df2fd07..0672668 100644--- a/docs/screenshots/frame.py+++ b/docs/screenshots/frame.py@@ -26,6 +26,11 @@ SHOTS = {"send": "25_readme_send","tweaks": "29_readme_tweaks","home": "30_readme_home",+ "this-tv": "31_readme_this_tv",+ "cpu": "32_readme_cpu",+ "ram": "33_readme_ram",+ "network": "34_readme_network",+ "shell": "35_readme_shell",}DP = 3 # the tests render at xxhdpi