Skip to content

Debloat any Android or Google TV over Wi-Fi and get an Apple TV-style home.

feat(addons): add scoreboard app usage leaderboard add-on

Eric Woodford17cb24d9d3bb
diff --git a/addons/README.md b/addons/README.md
index cd33dfe22..638766b62 100644
--- a/addons/README.md
+++ b/addons/README.md
@@ -22,6 +22,7 @@ the core bigger or change how it behaves. You install an add-on only if you want
| [TV Static](tv-static/) | An off-the-air moment each time the screen turns on: the picture opens from a bright line, snow and hiss, colour bars or an old "no signal" screen for 3 to 10 s, then fades into what was on screen; the card sets style, sound and length | [@luyzfernando08](https://github.com/luyzfernando08) | Xiaomi Mi Box S (Android TV 9), Philco by Skyworth (Android TV 14) | foreground service (screen-on watcher), start at boot, display over other apps | <img src="tv-static/screenshot.jpg" width="240" alt="TV Static on a TV"> |
| [Brightness](brightness/) | Dims the picture below the TV's own minimum over every app (and the picture settings on Realtek TVs), with a warm night mode on a schedule and a one-press normal screen | [@maxhayim](https://github.com/maxhayim) | MOKA R8G (Android 14) | overlay, foreground service, start at boot | <img src="brightness/screenshot.jpg" width="240" alt="Brightness on a TV"> |
| [Sleep Timer](sleep-timer/) | A sleep timer: 15 to 120 minutes, a one-minute countdown over what is playing with "15 more minutes", then standby; over HDMI-CEC the TV turns off with the box | [@luyzfernando08](https://github.com/luyzfernando08) | Xiaomi Mi Box S (Android TV 9) | accessibility (lock-screen action only), display over other apps, exact alarms | <img src="sleep-timer/screenshot.jpg" width="240" alt="Sleep Timer on a TV"> |
+| [Scoreboard](scoreboard/) | Streaming app usage leaderboard tracking launches and watch time with D-pad click-to-launch | [EricWoodford](https://github.com/EricWoodford) | TiVo Stream 4K (Android TV 12) | `PACKAGE_USAGE_STATS` (granted via ADB) | <img src="scoreboard/screenshot.jpg" width="240" alt="Scoreboard on a TV"> |
| [Quiet Hours](quiet-hours/) | A volume cap for the night (or all day): the volume is brought back down to the cap whenever it goes above, a muted TV is left alone, headphones can stay uncapped | [@maxhayim](https://github.com/maxhayim) | MOKA R8G (Android 14) | foreground service, start at boot | <img src="quiet-hours/screenshot.jpg" width="240" alt="Quiet Hours on a TV"> |
| [Remote Access](remote-access/) | Whether the TV is open to remote control: network debugging (ADB) and its port, the TV's address, Tailscale, and a button that switches network debugging off | [@maxhayim](https://github.com/maxhayim) | MOKA R8G (Android 14) | network state; `WRITE_SECURE_SETTINGS` granted by ADB, only for the off button | <img src="remote-access/screenshot.jpg" width="240" alt="Remote Access on a TV"> |
| [Bluetooth Connect](bluetooth-connect/) | Paired Bluetooth speakers and headphones with a Connect / Disconnect button, which the TV's own settings lack | [@thenewnano](https://github.com/thenewnano) | Philips UHD Android TV (Android 14) | Nearby devices (`BLUETOOTH_CONNECT`), granted by ADB | <img src="bluetooth-connect/screenshot.jpg" width="240" alt="Bluetooth Connect on a TV"> |
diff --git a/addons/scoreboard/.gitignore b/addons/scoreboard/.gitignore
new file mode 100644
index 000000000..a7e04a21b
--- /dev/null
+++ b/addons/scoreboard/.gitignore
@@ -0,0 +1,4 @@
+.gradle/
+build/
+app/build/
+local.properties
diff --git a/addons/scoreboard/README.md b/addons/scoreboard/README.md
new file mode 100644
index 000000000..e2ee3d854
--- /dev/null
+++ b/addons/scoreboard/README.md
@@ -0,0 +1,23 @@
+# Streaming App Usage Scoreboard
+
+An app usage leaderboard for Android TV that tracks launch counts and foreground watch time for streaming and media apps (YouTube, Netflix, Disney+, Prime Video, Max, Plex, Peacock, Paramount+, Spotify, Twitch, Tubi, Pluto TV, etc.).
+
+For the [Clean Your TV](../../README.md) launcher it declares a [module card](../../docs/modules.md), so once you answer **Show card** its tile reads "Scoreboard" with an amber glow; on any other Android TV home it functions as a standalone Leanback application.
+
+## Features
+- **Strict Streaming Filter:** Excludes background system services, settings, and package installers to focus purely on entertainment and streaming media.
+- **D-Pad Remote Navigation:** Highlight any app row and press **OK / Center** on your TV remote to immediately launch that streaming service.
+- **Top 10 Leaderboard:** Displays rankings with gold (🥇), silver (🥈), and bronze (🥉) medal badges along with total launch metrics.
+
+## Permissions
+- `PACKAGE_USAGE_STATS` (System AppOps permission, granted via ADB):
+ ```bash
+ adb shell appops set com.poppy.scoreboard GET_USAGE_STATS allow
+ ```
+
+## Build and Install
+```bash
+cd addons/scoreboard && ./gradlew assembleRelease
+adb install -r app/build/outputs/apk/release/app-release.apk
+adb shell appops set com.poppy.scoreboard GET_USAGE_STATS allow
+```
diff --git a/addons/scoreboard/app/build.gradle b/addons/scoreboard/app/build.gradle
new file mode 100644
index 000000000..1d1c78501
--- /dev/null
+++ b/addons/scoreboard/app/build.gradle
@@ -0,0 +1,31 @@
+plugins {
+ id 'com.android.application'
+}
+
+android {
+ namespace 'com.poppy.scoreboard'
+ compileSdk 34
+
+ defaultConfig {
+ applicationId 'com.poppy.scoreboard'
+ minSdk 26
+ targetSdk 34
+ versionCode 1
+ versionName '1.0.0'
+ }
+
+ buildTypes {
+ release {
+ minifyEnabled false
+ signingConfig signingConfigs.debug
+ }
+ }
+ compileOptions {
+ sourceCompatibility JavaVersion.VERSION_17
+ targetCompatibility JavaVersion.VERSION_17
+ }
+}
+
+dependencies {
+ implementation 'androidx.annotation:annotation:1.7.1'
+}
diff --git a/addons/scoreboard/app/src/main/AndroidManifest.xml b/addons/scoreboard/app/src/main/AndroidManifest.xml
new file mode 100644
index 000000000..a2f1bd353
--- /dev/null
+++ b/addons/scoreboard/app/src/main/AndroidManifest.xml
@@ -0,0 +1,32 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+
+ <uses-feature android:name="android.software.leanback" android:required="true" />
+ <uses-feature android:name="android.hardware.touchscreen" android:required="false" />
+ <uses-permission android:name="android.permission.PACKAGE_USAGE_STATS" />
+
+ <application
+ android:allowBackup="false"
+ android:supportsRtl="true"
+ android:theme="@android:style/Theme.Material.NoActionBar.Fullscreen"
+ android:label="@string/app_name"
+ android:icon="@drawable/icon"
+ android:banner="@drawable/icon">
+
+ <activity
+ android:name=".ScoreboardActivity"
+ android:exported="true">
+ <intent-filter>
+ <action android:name="android.intent.action.MAIN" />
+ <category android:name="android.intent.category.LEANBACK_LAUNCHER" />
+ </intent-filter>
+ <intent-filter>
+ <action android:name="android.intent.action.MAIN" />
+ <category android:name="com.gathin.tvhome.category.DOCK_CARD" />
+ </intent-filter>
+ <meta-data
+ android:name="com.gathin.tvhome.card"
+ android:resource="@xml/module_card" />
+ </activity>
+
+ </application>
+</manifest>
diff --git a/addons/scoreboard/app/src/main/java/com/poppy/scoreboard/ScoreboardActivity.java b/addons/scoreboard/app/src/main/java/com/poppy/scoreboard/ScoreboardActivity.java
new file mode 100644
index 000000000..e7dc081a1
--- /dev/null
+++ b/addons/scoreboard/app/src/main/java/com/poppy/scoreboard/ScoreboardActivity.java
@@ -0,0 +1,359 @@
+package com.poppy.scoreboard;
+
+import android.app.Activity;
+import android.app.usage.UsageEvents;
+import android.app.usage.UsageStats;
+import android.app.usage.UsageStatsManager;
+import android.content.Context;
+import android.content.Intent;
+import android.content.pm.ApplicationInfo;
+import android.content.pm.PackageManager;
+import android.graphics.Color;
+import android.graphics.drawable.Drawable;
+import android.os.Bundle;
+import android.util.TypedValue;
+import android.view.Gravity;
+import android.view.KeyEvent;
+import android.view.View;
+import android.view.ViewGroup;
+import android.widget.ImageView;
+import android.widget.LinearLayout;
+import android.widget.TextView;
+
+import java.util.ArrayList;
+import java.util.Calendar;
+import java.util.Collections;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+public class ScoreboardActivity extends Activity {
+
+ static class AppScore {
+ String packageName;
+ String label;
+ Drawable icon;
+ int launchCount;
+ long totalTimeMs;
+ }
+
+ @Override
+ protected void onCreate(Bundle savedInstanceState) {
+ super.onCreate(savedInstanceState);
+ setContentView(R.layout.activity_scoreboard);
+
+ renderScoreboard();
+ }
+
+ private boolean isStreamingApp(String pkg) {
+ if (pkg == null) return false;
+ String p = pkg.toLowerCase();
+
+ // System & Utility Blocklist
+ if (p.contains("setting") ||
+ p.contains("installer") ||
+ p.contains("systemui") ||
+ p.contains("android.vending") ||
+ p.contains("google.android.gms") ||
+ p.contains("google.android.katniss") ||
+ p.contains("google.android.tv.assistant") ||
+ p.contains("remote.service") ||
+ p.contains("dreamx") ||
+ p.contains("mediashell") ||
+ p.contains("launcher") ||
+ p.contains("setupwraith") ||
+ p.contains("tvhome") ||
+ p.contains("scoreboard") ||
+ p.contains("headphones") ||
+ p.contains("weather") ||
+ p.contains("palantir") ||
+ p.contains("wireguard") ||
+ p.contains("tcl.suspension") ||
+ p.contains("tcl.bi") ||
+ p.contains("tcl.guard") ||
+ p.contains("tcl.usercenter") ||
+ p.contains("tcl.messagebox") ||
+ p.contains("tcl.partnercustomizer") ||
+ p.contains("tvinput") ||
+ p.contains("tivo.atom") ||
+ p.contains("tivo.sageservice") ||
+ p.contains("tivo.tvlaunchercustomization") ||
+ p.contains("nes.") ||
+ p.contains("sei.") ||
+ p.contains("droidlogic") ||
+ p.contains("talkback") ||
+ p.contains("providers") ||
+ p.startsWith("android")) {
+ return false;
+ }
+
+ // Streaming & Media Whitelist
+ return p.contains("netflix") ||
+ p.contains("amazonvideo") ||
+ p.contains("prime") ||
+ p.contains("avod") ||
+ p.contains("disney") ||
+ p.contains("youtube") ||
+ p.contains("plex") ||
+ p.contains("peacock") ||
+ p.contains("hulu") ||
+ p.contains("wbd") ||
+ p.contains("max") ||
+ p.contains("hbo") ||
+ p.contains("cbs") ||
+ p.contains("paramount") ||
+ p.contains("spotify") ||
+ p.contains("twitch") ||
+ p.contains("tubi") ||
+ p.contains("pluto") ||
+ p.contains("vudu") ||
+ p.contains("apple.atve") ||
+ p.contains("appletv") ||
+ p.contains("airscreen") ||
+ p.contains("espn") ||
+ p.contains("crunchyroll") ||
+ p.contains("starz") ||
+ p.contains("discovery") ||
+ p.contains("kodi") ||
+ p.contains("vlc") ||
+ p.contains("pandora") ||
+ p.contains("deezer") ||
+ p.contains("iheart") ||
+ p.contains("tclchannel") ||
+ p.contains("tivoplusplayer") ||
+ p.equals("com.google.android.videos");
+ }
+
+ private void renderScoreboard() {
+ UsageStatsManager usm = (UsageStatsManager) getSystemService(Context.USAGE_STATS_SERVICE);
+ PackageManager pm = getPackageManager();
+
+ Calendar cal = Calendar.getInstance();
+ long endTime = cal.getTimeInMillis();
+ cal.add(Calendar.MONTH, -6);
+ long startTime = cal.getTimeInMillis();
+
+ Map<String, Integer> eventCounts = new HashMap<>();
+
+ if (usm != null) {
+ UsageEvents events = usm.queryEvents(startTime, endTime);
+ if (events != null) {
+ UsageEvents.Event event = new UsageEvents.Event();
+ while (events.hasNextEvent()) {
+ events.getNextEvent(event);
+ int eventType = event.getEventType();
+ if (eventType == UsageEvents.Event.ACTIVITY_RESUMED || eventType == 1) { // 1 = MOVE_TO_FOREGROUND / RESUMED
+ String pkg = event.getPackageName();
+ if (isStreamingApp(pkg)) {
+ eventCounts.put(pkg, eventCounts.getOrDefault(pkg, 0) + 1);
+ }
+ }
+ }
+ }
+ }
+
+ Map<String, AppScore> scoreMap = new HashMap<>();
+
+ // Also query time in foreground
+ List<UsageStats> statsList = usm != null ? usm.queryUsageStats(UsageStatsManager.INTERVAL_BEST, startTime, endTime) : null;
+ if (statsList != null) {
+ for (UsageStats us : statsList) {
+ String pkg = us.getPackageName();
+ if (!isStreamingApp(pkg)) continue;
+
+ int count = eventCounts.getOrDefault(pkg, 0);
+ if (count <= 0 && us.getTotalTimeInForeground() <= 1000) continue;
+
+ AppScore existing = scoreMap.get(pkg);
+ if (existing == null) {
+ existing = new AppScore();
+ existing.packageName = pkg;
+ existing.launchCount = count;
+ try {
+ ApplicationInfo ai = pm.getApplicationInfo(pkg, 0);
+ existing.label = String.valueOf(pm.getApplicationLabel(ai));
+ existing.icon = pm.getApplicationIcon(ai);
+ } catch (Exception e) {
+ existing.label = getFriendlyName(pkg);
+ }
+ scoreMap.put(pkg, existing);
+ }
+ existing.totalTimeMs += us.getTotalTimeInForeground();
+ }
+ }
+
+ // Add any remaining from eventCounts
+ for (Map.Entry<String, Integer> entry : eventCounts.entrySet()) {
+ String pkg = entry.getKey();
+ if (!scoreMap.containsKey(pkg)) {
+ AppScore s = new AppScore();
+ s.packageName = pkg;
+ s.launchCount = entry.getValue();
+ try {
+ ApplicationInfo ai = pm.getApplicationInfo(pkg, 0);
+ s.label = String.valueOf(pm.getApplicationLabel(ai));
+ s.icon = pm.getApplicationIcon(ai);
+ } catch (Exception e) {
+ s.label = getFriendlyName(pkg);
+ }
+ scoreMap.put(pkg, s);
+ }
+ }
+
+ List<AppScore> scores = new ArrayList<>(scoreMap.values());
+ Collections.sort(scores, (a, b) -> {
+ if (b.launchCount != a.launchCount) {
+ return Integer.compare(b.launchCount, a.launchCount);
+ }
+ return Long.compare(b.totalTimeMs, a.totalTimeMs);
+ });
+
+ LinearLayout container = findViewById(R.id.scoreboard_list);
+ container.removeAllViews();
+
+ int totalLaunches = 0;
+ for (AppScore s : scores) {
+ totalLaunches += s.launchCount;
+ }
+
+ TextView totalLabel = findViewById(R.id.total_launches_label);
+ if (totalLabel != null) {
+ totalLabel.setText("Streaming: " + totalLaunches + " total plays tracked");
+ }
+
+ int rank = 1;
+ View firstRow = null;
+
+ for (AppScore app : scores) {
+ if (app.launchCount <= 0 && app.totalTimeMs <= 0) continue;
+
+ final String targetPkg = app.packageName;
+
+ LinearLayout row = new LinearLayout(this);
+ row.setOrientation(LinearLayout.HORIZONTAL);
+ row.setGravity(Gravity.CENTER_VERTICAL);
+ row.setFocusable(true);
+ row.setFocusableInTouchMode(true);
+ row.setClickable(true);
+ row.setBackgroundResource(R.drawable.item_focus_bg);
+
+ LinearLayout.LayoutParams rowLp = new LinearLayout.LayoutParams(
+ ViewGroup.LayoutParams.MATCH_PARENT, dpToPx(64));
+ rowLp.setMargins(0, 0, 0, dpToPx(10));
+ row.setLayoutParams(rowLp);
+ row.setPadding(dpToPx(16), 0, dpToPx(20), 0);
+
+ // Rank Badge
+ TextView rankView = new TextView(this);
+ String medal = rank == 1 ? "🥇 #1" : rank == 2 ? "🥈 #2" : rank == 3 ? "🥉 #3" : " #" + rank;
+ rankView.setText(medal);
+ rankView.setTextColor(rank == 1 ? Color.parseColor("#E5A93C") : rank == 2 ? Color.parseColor("#CBD5E1") : rank == 3 ? Color.parseColor("#CD7F32") : Color.parseColor("#94A3B8"));
+ rankView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 18);
+ rankView.setTypeface(null, android.graphics.Typeface.BOLD);
+ rankView.setWidth(dpToPx(72));
+ row.addView(rankView);
+
+ // Icon
+ ImageView iconView = new ImageView(this);
+ if (app.icon != null) {
+ iconView.setImageDrawable(app.icon);
+ }
+ LinearLayout.LayoutParams iconLp = new LinearLayout.LayoutParams(dpToPx(40), dpToPx(40));
+ iconLp.setMargins(dpToPx(8), 0, dpToPx(16), 0);
+ iconView.setLayoutParams(iconLp);
+ row.addView(iconView);
+
+ // App Label
+ TextView labelView = new TextView(this);
+ String dispLabel = app.label != null && !app.label.isEmpty() ? app.label : getFriendlyName(app.packageName);
+ labelView.setText(dispLabel);
+ labelView.setTextColor(Color.WHITE);
+ labelView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 17);
+ labelView.setTypeface(null, android.graphics.Typeface.BOLD);
+ LinearLayout.LayoutParams labelLp = new LinearLayout.LayoutParams(0, ViewGroup.LayoutParams.WRAP_CONTENT, 1f);
+ labelView.setLayoutParams(labelLp);
+ row.addView(labelView);
+
+ // Launch Count Score Pill
+ TextView countView = new TextView(this);
+ countView.setText(app.launchCount + " plays");
+ countView.setTextColor(Color.parseColor("#38BDF8"));
+ countView.setTextSize(TypedValue.COMPLEX_UNIT_SP, 16);
+ countView.setTypeface(null, android.graphics.Typeface.BOLD);
+ row.addView(countView);
+
+ // Click & Key Listener to launch the app
+ row.setOnClickListener(v -> launchTargetApp(targetPkg));
+
+ row.setOnKeyListener((v, keyCode, event) -> {
+ if (event.getAction() == KeyEvent.ACTION_UP && (
+ keyCode == KeyEvent.KEYCODE_DPAD_CENTER ||
+ keyCode == KeyEvent.KEYCODE_ENTER ||
+ keyCode == KeyEvent.KEYCODE_NUMPAD_ENTER ||
+ keyCode == KeyEvent.KEYCODE_BUTTON_A)) {
+ launchTargetApp(targetPkg);
+ return true;
+ }
+ return false;
+ });
+
+ container.addView(row);
+
+ if (firstRow == null) {
+ firstRow = row;
+ }
+ rank++;
+ }
+
+ if (firstRow != null) {
+ firstRow.requestFocus();
+ }
+ }
+
+ private void launchTargetApp(String targetPkg) {
+ try {
+ PackageManager pm = getPackageManager();
+ Intent intent = pm.getLeanbackLaunchIntentForPackage(targetPkg);
+ if (intent == null) {
+ intent = pm.getLaunchIntentForPackage(targetPkg);
+ }
+ if (intent != null) {
+ intent.addFlags(Intent.FLAG_ACTIVITY_NEW_TASK | Intent.FLAG_ACTIVITY_RESET_TASK_IF_NEEDED);
+ startActivity(intent);
+ }
+ } catch (Exception e) {
+ e.printStackTrace();
+ }
+ }
+
+ private static String getFriendlyName(String pkg) {
+ if (pkg == null) return "";
+ String p = pkg.toLowerCase();
+ if (p.contains("netflix")) return "Netflix";
+ if (p.contains("amazonvideo") || p.contains("prime")) return "Prime Video";
+ if (p.contains("disney")) return "Disney+";
+ if (p.contains("youtube.tvunplugged")) return "YouTube TV";
+ if (p.contains("youtube.tvmusic")) return "YouTube Music";
+ if (p.contains("youtube")) return "YouTube";
+ if (p.contains("plex")) return "Plex";
+ if (p.contains("peacock")) return "Peacock";
+ if (p.contains("hulu")) return "Hulu";
+ if (p.contains("wbd") || p.contains("max") || p.contains("hbo")) return "Max";
+ if (p.contains("airscreen")) return "AirScreen";
+ if (p.contains("cbs") || p.contains("paramount")) return "Paramount+";
+ if (p.contains("spotify")) return "Spotify";
+ if (p.contains("espn")) return "ESPN";
+ if (p.contains("twitch")) return "Twitch";
+ if (p.contains("tubi")) return "Tubi";
+ if (p.contains("pluto")) return "Pluto TV";
+ if (p.contains("vudu")) return "Fandango at Home (Vudu)";
+ if (p.contains("tivoplusplayer")) return "TiVo+";
+ if (p.contains("apple")) return "Apple TV";
+ if (p.contains("videos")) return "Google TV";
+ return pkg;
+ }
+
+ private int dpToPx(int dp) {
+ return (int) (dp * getResources().getDisplayMetrics().density + 0.5f);
+ }
+}
\ No newline at end of file
diff --git a/addons/scoreboard/app/src/main/res/drawable/icon.xml b/addons/scoreboard/app/src/main/res/drawable/icon.xml
new file mode 100644
index 000000000..a96e94764
--- /dev/null
+++ b/addons/scoreboard/app/src/main/res/drawable/icon.xml
@@ -0,0 +1,11 @@
+<vector xmlns:android="http://schemas.android.com/apk/res/android"
+ android:width="320dp"
+ android:height="180dp"
+ android:viewportWidth="320"
+ android:viewportHeight="180">
+ <path android:fillColor="#151A22" android:pathData="M0,0h320v180h-320z" />
+ <!-- Trophy Icon -->
+ <path
+ android:fillColor="#E5A93C"
+ android:pathData="M170,55h-10V45H100v10H90c-5.5,0 -10,4.5 -10,10v5c0,12.75 9.6,23.15 21.95,24.7 2.15,6.15 7.45,10.75 14.05,11.8V125H100v10h60v-10h-16v-18.5c6.6,-1.05 11.9,-5.65 14.05,-11.8C170.4,93.15 180,82.75 180,70V65C180,59.5 175.5,55 170,55zM90,70V65h10v19.1C94.2,82 90,76.5 90,70zM170,70c0,6.5 -4.2,12 -10,14.1V65h10V70z"/>
+</vector>
diff --git a/addons/scoreboard/app/src/main/res/drawable/item_focus_bg.xml b/addons/scoreboard/app/src/main/res/drawable/item_focus_bg.xml
new file mode 100644
index 000000000..e7674c522
--- /dev/null
+++ b/addons/scoreboard/app/src/main/res/drawable/item_focus_bg.xml
@@ -0,0 +1,16 @@
+<selector xmlns:android="http://schemas.android.com/apk/res/android">
+ <item android:state_focused="true">
+ <shape android:shape="rectangle">
+ <solid android:color="#2A374A" />
+ <stroke android:width="2dp" android:color="#E5A93C" />
+ <corners android:radius="12dp" />
+ </shape>
+ </item>
+ <item>
+ <shape android:shape="rectangle">
+ <solid android:color="#1A222C" />
+ <stroke android:width="1dp" android:color="#334155" />
+ <corners android:radius="12dp" />
+ </shape>
+ </item>
+</selector>
diff --git a/addons/scoreboard/app/src/main/res/layout/activity_scoreboard.xml b/addons/scoreboard/app/src/main/res/layout/activity_scoreboard.xml
new file mode 100644
index 000000000..a24f3a1ef
--- /dev/null
+++ b/addons/scoreboard/app/src/main/res/layout/activity_scoreboard.xml
@@ -0,0 +1,70 @@
+<?xml version="1.0" encoding="utf-8"?>
+<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
+ android:layout_width="match_parent"
+ android:layout_height="match_parent"
+ android:orientation="vertical"
+ android:background="#0F141C"
+ android:paddingStart="48dp"
+ android:paddingTop="36dp"
+ android:paddingEnd="48dp"
+ android:paddingBottom="36dp">
+
+ <!-- Header -->
+ <LinearLayout
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:orientation="horizontal"
+ android:gravity="center_vertical"
+ android:layout_marginBottom="24dp">
+
+ <TextView
+ android:layout_width="0dp"
+ android:layout_height="wrap_content"
+ android:layout_weight="1"
+ android:text="🏆 APP USAGE SCOREBOARD"
+ android:textColor="#FFFFFF"
+ android:textSize="26sp"
+ android:textStyle="bold"
+ android:fontFamily="sans-serif-black" />
+
+ <TextView
+ android:id="@+id/total_launches_label"
+ android:layout_width="wrap_content"
+ android:layout_height="wrap_content"
+ android:text="Total: 0 launches"
+ android:textColor="#94A3B8"
+ android:textSize="14sp"
+ android:background="#1E293B"
+ android:paddingStart="12dp"
+ android:paddingEnd="12dp"
+ android:paddingTop="6dp"
+ android:paddingBottom="6dp" />
+ </LinearLayout>
+
+ <!-- Scrollable Leaderboard List -->
+ <ScrollView
+ android:layout_width="match_parent"
+ android:layout_height="0dp"
+ android:layout_weight="1"
+ android:scrollbars="vertical"
+ android:fadeScrollbars="false">
+
+ <LinearLayout
+ android:id="@+id/scoreboard_list"
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:orientation="vertical"
+ android:paddingBottom="24dp" />
+ </ScrollView>
+
+ <!-- Footer hint -->
+ <TextView
+ android:layout_width="match_parent"
+ android:layout_height="wrap_content"
+ android:text="Press [Back] to return to Home"
+ android:textColor="#64748B"
+ android:textSize="12sp"
+ android:gravity="center"
+ android:layout_marginTop="12dp" />
+
+</LinearLayout>
diff --git a/addons/scoreboard/app/src/main/res/values/strings.xml b/addons/scoreboard/app/src/main/res/values/strings.xml
new file mode 100644
index 000000000..51505d3dd
--- /dev/null
+++ b/addons/scoreboard/app/src/main/res/values/strings.xml
@@ -0,0 +1,3 @@
+<resources>
+ <string name="app_name">Scoreboard</string>
+</resources>
diff --git a/addons/scoreboard/app/src/main/res/xml/module_card.xml b/addons/scoreboard/app/src/main/res/xml/module_card.xml
new file mode 100644
index 000000000..9796e29b5
--- /dev/null
+++ b/addons/scoreboard/app/src/main/res/xml/module_card.xml
@@ -0,0 +1 @@
+<card spec="1" label="Scoreboard" caption="App Launches" accent="#E5A93C" />
\ No newline at end of file
diff --git a/addons/scoreboard/build.gradle b/addons/scoreboard/build.gradle
new file mode 100644
index 000000000..48978475f
--- /dev/null
+++ b/addons/scoreboard/build.gradle
@@ -0,0 +1,3 @@
+plugins {
+ id 'com.android.application' version '8.5.2' apply false
+}
diff --git a/addons/scoreboard/gradle.properties b/addons/scoreboard/gradle.properties
new file mode 100644
index 000000000..18825f968
--- /dev/null
+++ b/addons/scoreboard/gradle.properties
@@ -0,0 +1,3 @@
+org.gradle.jvmargs=-Xmx2g -Dfile.encoding=UTF-8
+android.useAndroidX=true
+android.nonTransitiveRClass=true
diff --git a/addons/scoreboard/gradle/wrapper/gradle-wrapper.jar b/addons/scoreboard/gradle/wrapper/gradle-wrapper.jar
new file mode 100644
index 000000000..2c3521197
Binary files /dev/null and b/addons/scoreboard/gradle/wrapper/gradle-wrapper.jar differ
diff --git a/addons/scoreboard/gradle/wrapper/gradle-wrapper.properties b/addons/scoreboard/gradle/wrapper/gradle-wrapper.properties
new file mode 100644
index 000000000..77f5d0ba6
--- /dev/null
+++ b/addons/scoreboard/gradle/wrapper/gradle-wrapper.properties
@@ -0,0 +1,8 @@
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.9-bin.zip
+distributionSha256Sum=d725d707bfabd4dfdc958c624003b3c80accc03f7037b5122c4b1d0ef15cecab
+networkTimeout=10000
+validateDistributionUrl=true
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists
diff --git a/addons/scoreboard/gradlew b/addons/scoreboard/gradlew
new file mode 100755
index 000000000..f5feea6d6
--- /dev/null
+++ b/addons/scoreboard/gradlew
@@ -0,0 +1,252 @@
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+# https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+# SPDX-License-Identifier: Apache-2.0
+#
+
+##############################################################################
+#
+# Gradle start up script for POSIX generated by Gradle.
+#
+# Important for running:
+#
+# (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+# noncompliant, but you have some other compliant shell such as ksh or
+# bash, then to run this script, type that shell name before the whole
+# command line, like:
+#
+# ksh Gradle
+#
+# Busybox and similar reduced shells will NOT work, because this script
+# requires all of these POSIX shell features:
+# * functions;
+# * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+# «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+# * compound commands having a testable exit status, especially «case»;
+# * various built-in commands including «command», «set», and «ulimit».
+#
+# Important for patching:
+#
+# (2) This script targets any POSIX shell, so it avoids extensions provided
+# by Bash, Ksh, etc; in particular arrays are avoided.
+#
+# The "traditional" practice of packing multiple parameters into a
+# space-separated string is a well documented source of bugs and security
+# problems, so this is (mostly) avoided, by progressively accumulating
+# options in "$@", and eventually passing that to Java.
+#
+# Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+# and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+# see the in-line comments for details.
+#
+# There are tweaks for specific operating systems such as AIX, CygWin,
+# Darwin, MinGW, and NonStop.
+#
+# (3) This script is generated from the Groovy template
+# https://github.com/gradle/gradle/blob/HEAD/platforms/jvm/plugins-application/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+# within the Gradle project.
+#
+# You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+ APP_HOME=${app_path%"${app_path##*/}"} # leaves a trailing /; empty if no leading path
+ [ -h "$app_path" ]
+do
+ ls=$( ls -ld "$app_path" )
+ link=${ls#*' -> '}
+ case $link in #(
+ /*) app_path=$link ;; #(
+ *) app_path=$APP_HOME$link ;;
+ esac
+done
+
+# This is normally unused
+# shellcheck disable=SC2034
+APP_BASE_NAME=${0##*/}
+# Discard cd standard output in case $CDPATH is set (https://github.com/gradle/gradle/issues/25036)
+APP_HOME=$( cd -P "${APP_HOME:-./}" > /dev/null && printf '%s
+' "$PWD" ) || exit
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+ echo "$*"
+} >&2
+
+die () {
+ echo
+ echo "$*"
+ echo
+ exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in #(
+ CYGWIN* ) cygwin=true ;; #(
+ Darwin* ) darwin=true ;; #(
+ MSYS* | MINGW* ) msys=true ;; #(
+ NONSTOP* ) nonstop=true ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+ if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+ # IBM's JDK on AIX uses strange locations for the executables
+ JAVACMD=$JAVA_HOME/jre/sh/java
+ else
+ JAVACMD=$JAVA_HOME/bin/java
+ fi
+ if [ ! -x "$JAVACMD" ] ; then
+ die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+else
+ JAVACMD=java
+ if ! command -v java >/dev/null 2>&1
+ then
+ die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+ fi
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+ case $MAX_FD in #(
+ max*)
+ # In POSIX sh, ulimit -H is undefined. That's why the result is checked to see if it worked.
+ # shellcheck disable=SC2039,SC3045
+ MAX_FD=$( ulimit -H -n ) ||
+ warn "Could not query maximum file descriptor limit"
+ esac
+ case $MAX_FD in #(
+ '' | soft) :;; #(
+ *)
+ # In POSIX sh, ulimit -n is undefined. That's why the result is checked to see if it worked.
+ # shellcheck disable=SC2039,SC3045
+ ulimit -n "$MAX_FD" ||
+ warn "Could not set maximum file descriptor limit to $MAX_FD"
+ esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+# * args from the command line
+# * the main class name
+# * -classpath
+# * -D...appname settings
+# * --module-path (only if needed)
+# * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+ APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+ CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+ JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+ # Now convert the arguments - kludge to limit ourselves to /bin/sh
+ for arg do
+ if
+ case $arg in #(
+ -*) false ;; # don't mess with options #(
+ /?*) t=${arg#/} t=/${t%%/*} # looks like a POSIX filepath
+ [ -e "$t" ] ;; #(
+ *) false ;;
+ esac
+ then
+ arg=$( cygpath --path --ignore --mixed "$arg" )
+ fi
+ # Roll the args list around exactly as many times as the number of
+ # args, so each arg winds up back in the position where it started, but
+ # possibly modified.
+ #
+ # NB: a `for` loop captures its iteration list before it begins, so
+ # changing the positional parameters here affects neither the number of
+ # iterations, nor the values presented in `arg`.
+ shift # remove old arg
+ set -- "$@" "$arg" # push replacement arg
+ done
+fi
+
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Collect all arguments for the java command:
+# * DEFAULT_JVM_OPTS, JAVA_OPTS, JAVA_OPTS, and optsEnvironmentVar are not allowed to contain shell fragments,
+# and any embedded shellness will be escaped.
+# * For example: A user cannot expect ${Hostname} to be expanded, as it is an environment variable and will be
+# treated as '${Hostname}' itself on the command line.
+
+set -- \
+ "-Dorg.gradle.appname=$APP_BASE_NAME" \
+ -classpath "$CLASSPATH" \
+ org.gradle.wrapper.GradleWrapperMain \
+ "$@"
+
+# Stop when "xargs" is not available.
+if ! command -v xargs >/dev/null 2>&1
+then
+ die "xargs is not available"
+fi
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+# readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+# set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+ printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+ xargs -n1 |
+ sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+ tr '\n' ' '
+ )" '"$@"'
+
+exec "$JAVACMD" "$@"
diff --git a/addons/scoreboard/gradlew.bat b/addons/scoreboard/gradlew.bat
new file mode 100644
index 000000000..9d21a2183
--- /dev/null
+++ b/addons/scoreboard/gradlew.bat
@@ -0,0 +1,94 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+@rem SPDX-License-Identifier: Apache-2.0
+@rem
+
+@if "%DEBUG%"=="" @echo off
+@rem ##########################################################################
+@rem
+@rem Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%"=="" set DIRNAME=.
+@rem This is normally unused
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if %ERRORLEVEL% equ 0 goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH. 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo. 1>&2
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME% 1>&2
+echo. 1>&2
+echo Please set the JAVA_HOME variable in your environment to match the 1>&2
+echo location of your Java installation. 1>&2
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if %ERRORLEVEL% equ 0 goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+set EXIT_CODE=%ERRORLEVEL%
+if %EXIT_CODE% equ 0 set EXIT_CODE=1
+if not ""=="%GRADLE_EXIT_CONSOLE%" exit %EXIT_CODE%
+exit /b %EXIT_CODE%
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega
diff --git a/addons/scoreboard/screenshot.jpg b/addons/scoreboard/screenshot.jpg
new file mode 100644
index 000000000..d98d9e780
Binary files /dev/null and b/addons/scoreboard/screenshot.jpg differ
diff --git a/addons/scoreboard/settings.gradle b/addons/scoreboard/settings.gradle
new file mode 100644
index 000000000..50855f2f7
--- /dev/null
+++ b/addons/scoreboard/settings.gradle
@@ -0,0 +1,16 @@
+pluginManagement {
+ repositories {
+ google()
+ mavenCentral()
+ gradlePluginPortal()
+ }
+}
+dependencyResolutionManagement {
+ repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
+ repositories {
+ google()
+ mavenCentral()
+ }
+}
+rootProject.name = "scoreboard"
+include ':app'