feat(cdm): add highly configurable CustomRemoteCDM for flexible API support

Add new CustomRemoteCDM class to support custom CDM API providers with maximum configurability through YAML configuration alone. This addresses GitHub issue #26 by enabling integration with third-party CDM APIs.

unshackle/commands/dl.py

@@ -41,7 +41,7 @@ from rich.text import Text
 from rich.tree import Tree
 
 from unshackle.core import binaries
-from unshackle.core.cdm import DecryptLabsRemoteCDM
+from unshackle.core.cdm import CustomRemoteCDM, DecryptLabsRemoteCDM
 from unshackle.core.config import config
 from unshackle.core.console import console
 from unshackle.core.constants import DOWNLOAD_LICENCE_ONLY, AnyTrack, context_settings
@@ -988,7 +988,7 @@ class dl:
                             sys.exit(1)
 
                     if not forced_subs:
-                        title.tracks.select_subtitles(lambda x: not x.forced or is_close_match(x.language, lang))
+                        title.tracks.select_subtitles(lambda x: not x.forced)
 
                 # filter audio tracks
                 # might have no audio tracks if part of the video, e.g. transport stream hls
@@ -2055,8 +2055,9 @@ class dl:
 
         cdm_api = next(iter(x.copy() for x in config.remote_cdm if x["name"] == cdm_name), None)
         if cdm_api:
-            is_decrypt_lab = True if cdm_api.get("type") == "decrypt_labs" else False
-            if is_decrypt_lab:
+            cdm_type = cdm_api.get("type")
+
+            if cdm_type == "decrypt_labs":
                 del cdm_api["name"]
                 del cdm_api["type"]
 
@@ -2071,6 +2072,14 @@ class dl:
 
                 # All DecryptLabs CDMs use DecryptLabsRemoteCDM
                 return DecryptLabsRemoteCDM(service_name=service, vaults=self.vaults, **cdm_api)
+
+            elif cdm_type == "custom_api":
+                del cdm_api["name"]
+                del cdm_api["type"]
+
+                # All Custom API CDMs use CustomRemoteCDM
+                return CustomRemoteCDM(service_name=service, vaults=self.vaults, **cdm_api)
+
             else:
                 return RemoteCdm(
                     device_type=cdm_api['Device Type'],

unshackle/core/cdm/__init__.py

@@ -1,3 +1,4 @@
+from .custom_remote_cdm import CustomRemoteCDM
 from .decrypt_labs_remote_cdm import DecryptLabsRemoteCDM
 
-__all__ = ["DecryptLabsRemoteCDM"]
+__all__ = ["DecryptLabsRemoteCDM", "CustomRemoteCDM"]

unshackle/unshackle-example.yaml

@@ -127,6 +127,74 @@ cdm:
     default: netflix_standard_l3
 
 # Use pywidevine Serve-compliant Remote CDMs
+
+  # Example: Custom CDM API Configuration
+  # This demonstrates the highly configurable custom_api type that can adapt to any CDM API format
+  # - name: "chrome"
+  #   type: "custom_api"
+  #   host: "http://remotecdm.test/"
+  #   timeout: 30
+  #   device:
+  #     name: "ChromeCDM"
+  #     type: "CHROME"
+  #     system_id: 34312
+  #     security_level: 3
+  #   auth:
+  #     type: "header"
+  #     header_name: "x-api-key"
+  #     key: "YOUR_API_KEY_HERE"
+  #     custom_headers:
+  #       User-Agent: "Unshackle/2.0.0"
+  #   endpoints:
+  #     get_request:
+  #       path: "/get-challenge"
+  #       method: "POST"
+  #       timeout: 30
+  #     decrypt_response:
+  #       path: "/get-keys"
+  #       method: "POST"
+  #       timeout: 30
+  #   request_mapping:
+  #     get_request:
+  #       param_names:
+  #         scheme: "device"
+  #         init_data: "init_data"
+  #       static_params:
+  #         scheme: "Widevine"
+  #     decrypt_response:
+  #       param_names:
+  #         scheme: "device"
+  #         license_request: "license_request"
+  #         license_response: "license_response"
+  #       static_params:
+  #         scheme: "Widevine"
+  #   response_mapping:
+  #     get_request:
+  #       fields:
+  #         challenge: "challenge"
+  #         session_id: "session_id"
+  #         message: "message"
+  #         message_type: "message_type"
+  #       response_types:
+  #         - condition: "message_type == 'license-request'"
+  #           type: "license_request"
+  #       success_conditions:
+  #         - "message == 'success'"
+  #     decrypt_response:
+  #       fields:
+  #         keys: "keys"
+  #         message: "message"
+  #       key_fields:
+  #         kid: "kid"
+  #         key: "key"
+  #         type: "type"
+  #       success_conditions:
+  #         - "message == 'success'"
+  #   caching:
+  #     enabled: true
+  #     use_vaults: true
+  #     check_cached_first: true
+
 remote_cdm:
   - name: "chrome"
     device_name: chrome