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.

README gallery: 12 shots, Advanced's four tabs and Shell

tellyscope-agent6195dcfbfbcf
diff --git a/README.md b/README.md
index 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 does
diff --git a/app/src/test/java/app/tellyscope/ScreenshotTest.kt b/app/src/test/java/app/tellyscope/ScreenshotTest.kt
index 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.hasScrollAction
import androidx.compose.ui.test.hasText
import androidx.compose.ui.test.onNodeWithTag
import 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.Dispatchers
import app.tellyscope.adb.AppFacts
import app.tellyscope.adb.ConnectionRequest
import 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.png
deleted file mode 100644
index 30d8c9c..0000000
Binary files a/docs/screenshots/advanced.png and /dev/null differ
diff --git a/docs/screenshots/frame.py b/docs/screenshots/frame.py
index 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