Add Chromecast-style remote control API (REST + WebSocket) with CEC home-theater volume support

AGENTS.md

@@ -0,0 +1,29 @@
+# AGENTS.md
+
+## Build
+
+### APK Build Command
+```bash
+JAVA_HOME=/usr/lib/jvm/java-17-openjdk ./gradlew :smarttubetv:assembleStstableDebug
+```
+
+### Java Version Fix
+AGP 7.4.2 + Java 21 causes a D8 NPE during dexing (`VideoCardPresenter$2.class`). Must use Java 17:
+```bash
+export JAVA_HOME=/usr/lib/jvm/java-17-openjdk
+```
+
+### Module Compilation (fast check, no APK)
+```bash
+./gradlew :common:compileStstableDebugJavaWithJavac
+```
+
+### Install to TV
+```bash
+adb connect <ip>:<port>
+adb install -r <apk>
+# If signature mismatch: adb uninstall <package> && adb install <apk>
+```
+
+### Package Name
+- `org.smarttube.stable` (stable flavor)

common/build.gradle

@@ -11,7 +11,10 @@ android {
 
     compileSdkVersion project.properties.compileSdkVersion
     buildToolsVersion project.properties.buildToolsVersion
-    testOptions.unitTests.includeAndroidResources = true
+    testOptions {
+        unitTests.includeAndroidResources = true
+        unitTests.returnDefaultValues = true
+    }
 
     defaultConfig {
         minSdkVersion project.properties.minSdkVersion
@@ -57,6 +60,7 @@ dependencies {
     implementation 'androidx.appcompat:appcompat:' + appCompatXVersion
     testImplementation 'junit:junit:' + junitVersion
     testImplementation 'org.robolectric:robolectric:' + robolectricVersion
+    testImplementation 'org.mockito:mockito-core:' + mockitoVersion
 
     implementation project(':sharedutils')
     implementation project(':fragment-1.1.0')
@@ -103,4 +107,7 @@ dependencies {
     implementation project(':appupdatechecker2')
 
     implementation project(':slidableactivity') // https://github.com/r0adkll/Slidr
+
+    implementation 'org.nanohttpd:nanohttpd:2.3.1'
+    implementation 'org.nanohttpd:nanohttpd-websocket:2.3.1'
 }

common/src/main/AndroidManifest.xml

@@ -1,5 +1,7 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
+          xmlns:tools="http://schemas.android.com/tools"
           package="com.liskovsoft.smartyoutubetv2.common">
+    <uses-sdk tools:overrideLibrary="androidx.test.espresso.idling.resource,androidx.test.monitor,androidx.test.core,androidx.test.ext.junit,androidx.test.ext.truth,androidx.test.runner,androidx.test.rules,androidx.test.espresso" />
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE" />
     <!-- Android 14 (API 34) -->
     <!-- <uses-permission android:name="android.permission.FOREGROUND_SERVICE_CONNECTED_DEVICE" /> -->
@@ -19,6 +21,7 @@
     <!-- Starting targetSDK 33+, foreground services require explicit permissions in the manifest. -->
     <!-- NOTE: only works with 'mediaPlayback' type service. Others types will fail. -->
     <uses-permission android:name="android.permission.FOREGROUND_SERVICE_MEDIA_PLAYBACK"/>
+    <uses-permission android:name="android.permission.INTERNET" />
 
     <queries>
         <!-- Android 11+: access package info (works only for specified apps) -->

common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/data/Playlist.java

@@ -16,6 +16,7 @@ public class Playlist {
     private final List<Video> mPlaylist;
     private final List<Video> mSyncedItems;
     private int mCurrentIndex;
+    private volatile int mGeneration;
     private static Playlist sInstance;
 
     private Playlist() {
@@ -39,18 +40,57 @@ public static Playlist instance() {
     public void clear() {
         mPlaylist.clear();
         mCurrentIndex = -1;
+        mGeneration++;
     }
 
     public void clearPosition() {
         mCurrentIndex = -1;
     }
 
+    /**
+     * Shuffles the playlist while keeping the currently-playing item as current.
+     */
+    public void shuffle() {
+        if (mPlaylist.isEmpty()) {
+            return;
+        }
+        Video current = getCurrent();
+        Collections.shuffle(mPlaylist);
+        if (current != null) {
+            int newIndex = mPlaylist.indexOf(current);
+            mCurrentIndex = newIndex >= 0 ? newIndex : 0;
+        } else {
+            mCurrentIndex = 0;
+        }
+        mGeneration++;
+    }
+
+    /**
+     * Reorders one item in the playlist while keeping the current pointer correct.
+     */
+    public void move(int fromIndex, int toIndex) {
+        if (mPlaylist.isEmpty() || fromIndex == toIndex) {
+            return;
+        }
+        if (fromIndex < 0 || fromIndex >= mPlaylist.size() || toIndex < 0 || toIndex >= mPlaylist.size()) {
+            return;
+        }
+        Video current = getCurrent();
+        Video moved = mPlaylist.remove(fromIndex);
+        mPlaylist.add(toIndex, moved);
+        if (current != null) {
+            mCurrentIndex = mPlaylist.indexOf(current);
+        }
+        mGeneration++;
+    }
+
     /**
      * Used to sync list with remotely added items
      */
     public void addAll(List<Video> videos) {
         mPlaylist.removeAll(videos);
         mPlaylist.addAll(videos);
+        mGeneration++;
     }
 
     /**
@@ -87,6 +127,8 @@ public void add(Video video) {
         // In this case remove all next items.
         trimPlaylist();
         stripPrevItem();
+
+        mGeneration++;
     }
 
     public void next(Video video) {
@@ -109,6 +151,8 @@ public void next(Video video) {
         // In this case remove all next items.
         trimPlaylist();
         stripPrevItem();
+
+        mGeneration++;
     }
 
     public void remove(Video video) {
@@ -140,6 +184,8 @@ public void remove(Video video) {
                 mCurrentIndex = mPlaylist.size() - 1;
             }
         }
+
+        mGeneration++;
     }
 
     public boolean contains(Video video) {
@@ -320,6 +366,10 @@ private void replace(Video origin, Video newItem) {
         }
     }
 
+    public int getGeneration() {
+        return mGeneration;
+    }
+
     public void onNewSession() {
         mSyncedItems.clear();
     }

common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/controllers/SuggestionsController.java

@@ -46,7 +46,9 @@ public class SuggestionsController extends BasePlayerController {
     private Video mNextSectionVideo;
     private int mFocusCount;
     private int mNextRetryCount;
-    private List<ChapterItem> mChapters;
+    // Written on the main thread (metadata load), but also read from NanoHTTPD worker
+    // threads via the remote API (RemoteApiBridge.getChapters) — volatile for visibility.
+    private volatile List<ChapterItem> mChapters;
     private final Runnable mChapterHandler = this::startChapterNotificationServiceIfNeededInt;
     private static final int MAX_PLAYLIST_CONTINUATIONS = 20;
     private static final int CHAPTER_NOTIFICATION_Id = 565;
@@ -354,6 +356,9 @@ private void updateSuggestions(MediaItemMetadata mediaItemMetadata, Video video)
 
         // After video suggestions
         callListener(mediaItemMetadata);
+
+        // Notify remote API clients that suggestions have been updated
+        com.liskovsoft.smartyoutubetv2.common.misc.remoteapi.RemoteApiBridge.notifySuggestionsUpdated();
     }
 
     private void appendSuggestions(Video video, MediaItemMetadata mediaItemMetadata) {
@@ -546,6 +551,14 @@ private void startChapterNotificationServiceIfNeededInt() {
         }
     }
 
+    /**
+     * Chapters of the currently playing video (parsed from YouTube metadata),
+     * or null when the video has none / nothing is playing. Used by the remote API.
+     */
+    public List<ChapterItem> getChapters() {
+        return mChapters;
+    }
+
     private void appendChaptersIfNeeded(MediaItemMetadata mediaItemMetadata) {
         mChapters = mediaItemMetadata.getChapters();
 

common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/models/playback/controllers/VideoStateController.java

@@ -613,14 +613,8 @@ private void restoreVolume() {
 
         float newVolume = getPlayerData().getPlayerVolume();
 
-        if (getPlayerTweaksData().isPlayerAutoVolumeEnabled()) {
-            //newVolume *= getVideo().volume;
-            //newVolume = getVideo().volume;
-            if (newVolume < 1f) {
-                newVolume *= getVideo().volume;
-            } else {
-                newVolume = getVideo().volume;
-            }
+        if (getPlayerTweaksData().isPlayerAutoVolumeEnabled() && newVolume < 1f) {
+            newVolume *= getVideo().volume;
         }
 
         if (getVideo().isShorts) {

common/src/main/java/com/liskovsoft/smartyoutubetv2/common/app/presenters/PlaybackPresenter.java

@@ -25,6 +25,7 @@
 import com.liskovsoft.smartyoutubetv2.common.app.presenters.dialogs.menu.VideoMenuPresenter;
 import com.liskovsoft.smartyoutubetv2.common.app.views.PlaybackView;
 import com.liskovsoft.smartyoutubetv2.common.exoplayer.selector.FormatItem;
+import com.liskovsoft.smartyoutubetv2.common.misc.remoteapi.RemoteApiBridge;
 import com.liskovsoft.smartyoutubetv2.common.utils.Utils;
 import com.liskovsoft.smartyoutubetv2.common.utils.Utils.ChainProcessor;
 import com.liskovsoft.smartyoutubetv2.common.utils.Utils.Processor;
@@ -61,6 +62,7 @@ private PlaybackPresenter(Context context) {
         mEventListeners.add(new ErrorFixerController());
         mEventListeners.add(new PlayerUIController());
         mEventListeners.add(new RemoteController(context));
+        RemoteApiBridge.init(this);
         mEventListeners.add(new SponsorBlockController());
         mEventListeners.add(new AutoFrameRateController());
         mEventListeners.add(new HQDialogController());