From 726d172625f03ec347776cd6d591cc1b40b8075f Mon Sep 17 00:00:00 2001
From: CodeDevMLH <145071728+CodeDevMLH@users.noreply.github.com>
Date: Sat, 20 Dec 2025 23:18:13 +0100
Subject: [PATCH] feat: add client compatibility section to README for better
 user guidance

---
 README.md | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

diff --git a/README.md b/README.md
index 4f49810..fae7be3 100644
--- a/README.md
+++ b/README.md
@@ -14,6 +14,7 @@ This plugin is based on my manual mod (see the [legacy branch](https://github.co
   - [Features](#features)
   - [Overview](#overview)
   - [Installation](#installation)
+  - [Client Compatibility](#client-compatibility)
   - [Configuration](#configuration)
   - [Automatic Theme Selection](#automatic-theme-selection)
   - [Theme Settings](#theme-settings)
@@ -87,6 +88,21 @@ To install this plugin, you will first need to add the repository in Jellyfin.
 9.  **Restart your Jellyfin server.**
 10. **You may need to refresh your browser page** (F5 or Ctrl+R) to see the changes. 
 
+## Client Compatibility
+
+Since this plugin relies on modifying the web interface (CSS/JS injection), it only works on clients that use the web wrapper. Native clients that use their own UI rendering engine are not supported.
+
+| Client Platform | Status | Notes |
+| :--- | :---: | :--- |
+| **Web Browsers** (Firefox, Chrome etc.) | ✅ | Direct JS injection |
+| **Jellyfin Media Player** (Windows/Linux/macOS) | ✅ | Uses jellyfin web |
+| **Android App** | ✅ | Uses a web wrapper |
+| **iOS App** | ✅ | Uses a web wrapper |
+| **Android TV / Fire TV** | ❌ | **Not supported.** Uses a native Java/Kotlin UI. |
+| **Roku** | ❌ | **Not supported.** Uses a native UI. |
+| **Swiftfin** (iOS/tvOS) | ❌ | **Not supported.** Uses a native Swift UI. |
+| **Kodi** (via Jellyfin Addon) | ❌ | **Not supported.** Uses Kodi's native skinning engine. |
+
 ## Configuration
 
 After installation and restart: