implement app

.env.sample

@@ -0,0 +1,553 @@
+# ==============================================================================
+#                         ESSENTIAL ADDON SETUP
+# ==============================================================================
+# These are the most important settings you'll need to configure.
+
+# --- Addon Identification ---
+# Descriptive name for your addon instance.
+ADDON_NAME="AIOStreams"
+# Unique identifier for your addon.
+ADDON_ID="aiostreams.viren070.com"
+
+# --- Network Configuration ---
+# The port on which the addon will listen.
+# Default: 3000
+PORT=3000
+
+# The base URL of your addon. Highly recommended for proper functioning.
+# Used for generating installation URLs and identifying self-scraping.
+# Example: https://aiostreams.yourdomain.com
+BASE_URL=
+
+# --- Security ---
+# CRITICAL: Secret key for encrypting addon configuration.
+# MUST be a 64-character hex string.
+# Generate one using:
+#   Linux/macOS: openssl rand -hex 32
+#   Windows (PowerShell): -join ((0..31) | ForEach-Object { '{0:x2}' -f (Get-Random -Minimum 0 -Maximum 255) })
+#   Or: [System.Guid]::NewGuid().ToString("N") + [System.Guid]::NewGuid().ToString("N") (ensure it's 64 chars)
+SECRET_KEY=
+
+# API key to protect your addon installation and usage.
+# Leave empty to disable password protection.
+# Can be any string.
+ADDON_PASSWORD=
+
+# --- Database ---
+# REQUIRED: The database URI for storing addon configuration.
+# Supports SQLite (simplest) or PostgreSQL.
+#
+# SQLite example (stores data in a file):
+#   DATABASE_URI=sqlite://./data/db.sqlite
+#   (You can change './data/db.sqlite' to your preferred path)
+#
+# PostgreSQL example:
+#   DATABASE_URI=postgres://username:password@host:port/database_name
+#   (e.g., postgresql://postgres:password@localhost:5432/aiostreams)
+DATABASE_URI=sqlite://./data/db.sqlite
+
+
+# ==============================================================================
+#                     DEBRID & OTHER SERVICE API KEYS
+# ==============================================================================
+
+# Provide a default TMDB access token to be used for the Title Matching filter if a user does not provide any.
+TMDB_ACCESS_TOKEN=
+
+# Configure API keys for debrid services and others you plan to use.
+# 'DEFAULT_' values are pre-filled in the user's config page.
+# 'FORCED_' values override user settings and hide the option.
+
+# --- Real-Debrid ---
+DEFAULT_REALDEBRID_API_KEY=
+FORCED_REALDEBRID_API_KEY=
+
+# --- AllDebrid ---
+DEFAULT_ALLDEBRID_API_KEY=
+FORCED_ALLDEBRID_API_KEY=
+
+# --- Premiumize ---
+DEFAULT_PREMIUMIZE_API_KEY=
+FORCED_PREMIUMIZE_API_KEY=
+
+# --- Debrid-Link ---
+DEFAULT_DEBRIDLINK_API_KEY=
+FORCED_DEBRIDLINK_API_KEY=
+
+# --- Torbox ---
+DEFAULT_TORBOX_API_KEY=
+FORCED_TORBOX_API_KEY=
+
+# --- OffCloud ---
+DEFAULT_OFFCLOUD_API_KEY=
+FORCED_OFFCLOUD_API_KEY=
+DEFAULT_OFFCLOUD_EMAIL=
+FORCED_OFFCLOUD_EMAIL=
+DEFAULT_OFFCLOUD_PASSWORD=
+FORCED_OFFCLOUD_PASSWORD=
+
+# --- Put.io ---
+DEFAULT_PUTIO_CLIENT_ID=
+FORCED_PUTIO_CLIENT_ID=
+DEFAULT_PUTIO_CLIENT_SECRET=
+FORCED_PUTIO_CLIENT_SECRET=
+
+# --- EasyNews ---
+DEFAULT_EASYNEWS_USERNAME=
+FORCED_EASYNEWS_USERNAME=
+DEFAULT_EASYNEWS_PASSWORD=
+FORCED_EASYNEWS_PASSWORD=
+
+# --- EasyDebrid ---
+DEFAULT_EASYDEBRID_API_KEY=
+FORCED_EASYDEBRID_API_KEY=
+
+# --- PikPak ---
+DEFAULT_PIKPAK_EMAIL=
+FORCED_PIKPAK_EMAIL=
+DEFAULT_PIKPAK_PASSWORD=
+FORCED_PIKPAK_PASSWORD=
+
+# --- Seedr ---
+DEFAULT_SEEDR_ENCODED_TOKEN=
+FORCED_SEEDR_ENCODED_TOKEN=
+
+
+# ==============================================================================
+#                      CUSTOMIZATION & ACCESS CONTROL
+# ==============================================================================
+
+# --- Custom HTML ---
+# Display custom HTML at the top of the addon's configuration page.
+# Example: CUSTOM_HTML="<div>Welcome to my AIOStreams!</div>"
+CUSTOM_HTML=
+
+# --- Trusted Users ---
+# Comma-separated list of trusted UUIDs.
+# Trusted users can access features like regex filters if REGEX_FILTER_ACCESS is 'trusted'.
+# Example: TRUSTED_UUIDS=ae32f456-1234-5678-9012-345678901234,another-uuid-here
+# TRUSTED_UUIDS=
+
+# --- Regex Filter Access ---
+# Controls who can use regex filters.
+# 'none': No one can use regex filters.
+# 'trusted': Only users listed in TRUSTED_UUIDS.
+# 'all': All users (only recommended if ADDON_PASSWORD is set).
+# Default: trusted
+REGEX_FILTER_ACCESS=trusted
+
+# --- Aliased Configurations (Vanity URLs) ---
+# Create shorter, memorable installation URLs.
+# Format: aliasName1:uuid1:encryptedPassword1,aliasName2:uuid2:encryptedPassword2
+# Users can then access the addon via /stremio/u/aliasName/manifest.json
+# ALIASED_CONFIGURATIONS=
+
+# ==============================================================================
+#                           CACHE CONFIGURATION
+# ==============================================================================
+
+# --- Default maximum cache size ----
+# The maximum number of items that can be held in a given cache instance, if not overriden by a specific cache instance
+DEFAULT_MAX_CACHE_SIZE=100000
+
+# --- Proxy IP TTL (StremThru/MediaFlow Proxy)
+# The Time-To-Live (in seconds) of items in the Public IP cache.
+# Set to -1 to disable caching
+PROXY_IP_CACHE_TTL=900
+
+# --- Addon Resource Caching ---
+# Control the Caching of resources fetched from other addons
+# Set to -1 to disable caching.
+MANIFEST_CACHE_TTL=300
+SUBTITLE_CACHE_TTL=300
+STREAM_CACHE_TTL=-1
+CATALOG_CACHE_TTL=300
+META_CACHE_TTL=300
+ADDON_CATALOG_CACHE_TTL=300
+
+
+# --- RPDB API Key Validation Caching ---
+# Control how long a valid API key check is cached for 
+# Default: 7 days
+RPDB_API_KEY_VALIDITY_CACHE_TTL=604800
+
+# ==============================================================================
+#                             FEATURE CONTROL
+# ==============================================================================
+# Enable or disable specific addon features.
+
+# --- Self-Scraping ---
+# Prevent this AIOStreams instance from being added as an addon to itself.
+# Default: true
+DISABLE_SELF_SCRAPING=true
+
+# --- Disabled Hosts ---
+# Prevent certain hostnames from being added as addons.
+# Format: host1:reason1,host2:reason2
+# Example: DISABLED_HOSTS=torrentio.strem.fun:Blocked by Torrentio
+# DISABLED_HOSTS=
+
+# --- Disabled Addons (Marketplace) ---
+# Disable specific addons from appearing in the marketplace.
+# See https://github.com/Viren070/AIOStreams/blob/main/packages/core/src/utils/marketplace.ts for IDs.
+# Format: addonID1:reason1,addonID2:reason2
+# Example: DISABLED_ADDONS=torrentio:Blocked by Torrentio
+# DISABLED_ADDONS=
+
+# --- Disabled Services (Configuration Page) ---
+# Hide certain services (e.g., debrid services) from the configuration page.
+# Format: service1:reason1,service2:reason2
+# Example: DISABLED_SERVICES=realdebrid:Not available on this instance
+# DISABLED_SERVICES=
+
+
+# ==============================================================================
+#                                 LOGGING
+# ==============================================================================
+
+# --- Log Level ---
+# Set the verbosity of logs. Options: "error", "warn", "info", "http", "verbose","debug", "silly"
+# Default: info
+LOG_LEVEL=http
+
+# --- Log Format ---
+# Output logs in "json" or "text" format.
+# Default: text
+LOG_FORMAT=text
+
+# --- Log Sensitive Information ---
+# Whether to include potentially sensitive info (like API keys) in logs.
+# Useful for debugging, but disable for production if concerned.
+# Default: true
+LOG_SENSITIVE_INFO=true
+
+# --- Log Timezone ---
+# Adjust the timezone used for logging
+# e.g. Europe/Paris, America/New_York
+LOG_TIMEZONE=Etc/UTC
+
+
+# ==============================================================================
+#                  PROXY FOR OUTGOING ADDON REQUESTS (Torrentio, etc.)
+# ==============================================================================
+# Configure a proxy for requests made *by* this AIOStreams instance *to* other addons (e.g., Torrentio).
+# Useful if your server's IP is blocked by an upstream service.
+
+# --- Addon Proxy URL ---
+# The proxy URL to use for all requests to upstream addons.
+# Example: ADDON_PROXY=http://warp:1080 (using https://github.com/cmj2002/warp-docker)
+# ADDON_PROXY=
+
+# --- Addon Proxy Configuration ---
+# Optionally, specify which domains to proxy.
+# Comma-separated list of rules: domain_pattern:boolean. Later rules have higher priority.
+# Wildcards (*) can be used.
+# Example: ADDON_PROXY_CONFIG="*:false,*.strem.fun:true" (only proxy *.strem.fun domains)
+# ADDON_PROXY_CONFIG=
+
+
+# ==============================================================================
+#                  DEFAULT/FORCED STREAM PROXY (MediaFlow, StremThru)
+# ==============================================================================
+# Configure how AIOStreams handles stream proxies like MediaFlow or StremThru for playback.
+# 'DEFAULT_' values are pre-filled. 'FORCE_' values override user settings.
+
+# --- Stream Proxy Enabled ---
+# DEFAULT_PROXY_ENABLED=true  # Default state for enabling a stream proxy.
+# FORCE_PROXY_ENABLED=false   # Force stream proxy on/off for all users.
+
+# --- Stream Proxy ID ---
+# 'mediaflow' or 'stremthru'
+DEFAULT_PROXY_ID=mediaflow
+# FORCE_PROXY_ID=
+
+# --- Stream Proxy URL ---
+# URL of your MediaFlow or StremThru instance.
+# DEFAULT_PROXY_URL=
+# FORCE_PROXY_URL=
+
+# --- Stream Proxy Credentials ---
+# Format: username:password
+# DEFAULT_PROXY_CREDENTIALS=
+# FORCE_PROXY_CREDENTIALS=
+
+# --- Stream Proxy Public IP ---
+# Public IP for the proxy, if needed.
+# DEFAULT_PROXY_PUBLIC_IP=
+# FORCE_PROXY_PUBLIC_IP=
+
+# --- Proxied Services ---
+# Comma-separated list of services whose streams should be proxied (e.g., realdebrid,alldebrid).
+# DEFAULT_PROXY_PROXIED_SERVICES=
+# FORCE_PROXY_PROXIED_SERVICES=
+
+# --- Disable Proxied Addons Feature ---
+# If true, it disables the 'Proxied Addons' option.
+FORCE_PROXY_DISABLE_PROXIED_ADDONS=false
+
+# --- Encrypt Streaming URLs ---
+# Encrypt MediaFlow/StremThru URLs for better compatibility with external players.
+ENCRYPT_MEDIAFLOW_URLS=true
+ENCRYPT_STREMTHRU_URLS=true
+
+
+# --- Forced Public proxy URL adjustments ----
+# If you'd like to force some adjustments to be made to the streaming urls generated by either proxy, you can do that here. 
+# This is useful when you want to use a local url for requests but have AIOStreams force the urls to use a specific host, port, and protocol.
+# FORCE_PUBLIC_PROXY_HOST=
+# FORCE_PUBLIC_PROXY_PORT=
+# FORCE_PUBLIC_PROXY_PROTOCOL=
+
+
+# ==============================================================================
+#                       ADVANCED CONFIGURATION & LIMITS
+# ==============================================================================
+
+# --- General Default Timeout ---
+# Default timeout in milliseconds for all requests if not overridden by a specific timeout.
+# Default: 15000 (15 seconds)
+DEFAULT_TIMEOUT=15000
+
+# --- Configuration Limits ---
+# Maximum number of addons allowed per AIOStreams configuration.
+MAX_ADDONS=15
+# Maximum number of groups allowed per AIOStreams configuration
+MAX_GROUPS=20
+# Maximum number of keyword filters per AIOStreams configuration.
+MAX_KEYWORD_FILTERS=30
+# Maximum number of condition filters per AIOStreams configuration
+MAX_CONDITION_FILTERS=30
+# Maximum timeout (ms) an addon can be set to via override.
+MAX_TIMEOUT=50000
+# Minimum timeout (ms) an addon can be set to via override.
+MIN_TIMEOUT=1000
+
+
+# ==============================================================================
+#                           RATE LIMIT CONFIGURATION
+# ==============================================================================
+# Configure rate limits to prevent abuse. Typically, defaults are fine.
+
+# --- Disable Rate Limits ---
+# Set to true to disable all rate limits (NOT RECOMMENDED).
+# Default: false
+DISABLE_RATE_LIMITS=false
+
+# Window and Max requests refer to the maximum number of requests a user can make within a specific timeframe
+
+# --- Static File Serving ---
+STATIC_RATE_LIMIT_WINDOW=5
+STATIC_RATE_LIMIT_MAX_REQUESTS=75
+
+# --- User API ---
+USER_API_RATE_LIMIT_WINDOW=5
+USER_API_RATE_LIMIT_MAX_REQUESTS=5
+
+# --- Stream API ---
+STREAM_API_RATE_LIMIT_WINDOW=5
+STREAM_API_RATE_LIMIT_MAX_REQUESTS=10
+
+# --- Format API ---
+FORMAT_API_RATE_LIMIT_WINDOW=5
+FORMAT_API_RATE_LIMIT_MAX_REQUESTS=30
+
+# --- Catalog API ---
+CATALOG_API_RATE_LIMIT_WINDOW=5
+CATALOG_API_RATE_LIMIT_MAX_REQUESTS=5
+
+# --- Stremio Stream ---
+STREMIO_STREAM_RATE_LIMIT_WINDOW=15
+STREMIO_STREAM_RATE_LIMIT_MAX_REQUESTS=10
+
+# --- Stremio Catalog ---
+STREMIO_CATALOG_RATE_LIMIT_WINDOW=5
+STREMIO_CATALOG_RATE_LIMIT_MAX_REQUESTS=30
+
+# --- Stremio Manifest ---
+STREMIO_MANIFEST_RATE_LIMIT_WINDOW=5
+STREMIO_MANIFEST_RATE_LIMIT_MAX_REQUESTS=5
+
+# --- Stremio Subtitle ---
+STREMIO_SUBTITLE_RATE_LIMIT_WINDOW=5
+STREMIO_SUBTITLE_RATE_LIMIT_MAX_REQUESTS=10
+
+# --- Stremio Meta ---
+STREMIO_META_RATE_LIMIT_WINDOW=5
+STREMIO_META_RATE_LIMIT_MAX_REQUESTS=15
+
+
+# ==============================================================================
+#                         INACTIVE USER PRUNING
+# ==============================================================================
+# Automatically prune (delete) inactive user configurations.
+
+# --- Prune Interval ---
+# How often to check for inactive users, in seconds.
+# Default: 86400 (1 day)
+PRUNE_INTERVAL=86400
+
+# --- Prune Max Inactivity Days ---
+# Maximum days of inactivity before a user's configuration is pruned.
+# Set to -1 to disable
+# Default: -1
+PRUNE_MAX_DAYS=-1
+
+
+# ==============================================================================
+#                      EXTERNAL ADDON SERVICE URLs & TIMEOUTS
+# ==============================================================================
+# URLs and default timeouts for various external Stremio addons that AIOStreams can integrate with.
+# Change these if you use self-hosted versions or if defaults become outdated.
+
+# ----------- COMET ------------
+COMET_URL=https://comet.elfhosted.com/
+# DEFAULT_COMET_TIMEOUT=
+# Advanced: Override Comet hostname/port/protocol if COMET_URL is internal but needs to be public-facing.
+# Only uncomment and set if needed. Usually, leave these commented.
+# FORCE_COMET_HOSTNAME=
+# FORCE_COMET_PORT=
+# FORCE_COMET_PROTOCOL= # e.g., https
+
+# ----------- MEDIAFUSION ------------
+MEDIAFUSION_URL=https://mediafusion.elfhosted.com/
+# DEFAULT_MEDIAFUSION_TIMEOUT=
+MEDIAFUSION_CONFIG_TIMEOUT=5000 # Timeout (ms) for /encrypt-user-data endpoint.
+# API Password for self-hosted MediaFusion (for auto-configuration).
+# MEDIAFUSION_API_PASSWORD=
+
+# ----------- JACKETTIO -------------
+JACKETTIO_URL=https://jackettio.elfhosted.com/
+# DEFAULT_JACKETTIO_TIMEOUT=
+# Default indexers for auto-configuration with Jackettio.
+DEFAULT_JACKETTIO_INDEXERS='["bitsearch", "eztv", "thepiratebay", "therarbg", "yts"]'
+# Default StremThru URL used by Jackettio.
+DEFAULT_JACKETTIO_STREMTHRU_URL=https://stremthru.13377001.xyz
+# Self-hosted StremThru for Jackettio:
+# DEFAULT_JACKETTIO_STREMTHRU_URL=http://stremthru:8080
+# Advanced: Override Jackettio hostname/port/protocol (similar to Comet).
+# FORCE_JACKETTIO_HOSTNAME=
+# FORCE_JACKETTIO_PORT=
+# FORCE_JACKETTIO_PROTOCOL=
+
+# --------- STREMTHRU-STORE ---------
+STREMTHRU_STORE_URL=https://stremthru.elfhosted.com/stremio/store/
+# DEFAULT_STREMTHRU_STORE_TIMEOUT=
+# Advanced: Override StremThru Store  hostname/port/protocol (similar to Comet).
+# FORCE_STREMTHRU_STORE_HOST=
+# FORCE_STREMTHRU_STORE_PORT=
+# FORCE_STREMTHRU_STORE_PROTOCOL=
+# --------- STREMTHRU-TORZ -----
+STREMTHRU_TORZ_URL=https://stremthru.elfhosted.com/stremio/torz/
+# DEFAULT_STREMTHRU_TORZ_TIMEOUT=
+# Advanced: Override StremThru Torz hostname/port/protocol (similar to Comet).
+# FORCE_STREMTHRU_TORZ_HOST=
+# FORCE_STREMTHRU_TORZ_PORT=
+# FORCE_STREMTHRU_TORZ_PROTOCOL=
+
+# --------- EASYNEWS+ ADDON ---------
+EASYNEWS_PLUS_URL=https://b89262c192b0-stremio-easynews-addon.baby-beamup.club/
+# DEFAULT_EASYNEWS_PLUS_TIMEOUT=
+
+# -------- EASYNEWS++ ADDON ---------
+EASYNEWS_PLUS_PLUS_URL=https://easynews-cloudflare-worker.jqrw92fchz.workers.dev/
+# DEFAULT_EASYNEWS_PLUS_PLUS_TIMEOUT=
+
+# --------- STREAMFUSION ---------
+STREAMFUSION_URL=https://stream-fusion.stremiofr.com/
+# DEFAULT_STREAMFUSION_TIMEOUT=
+
+# --------- MARVEL UNIVERSE ---------
+MARVEL_UNIVERSE_URL=https://addon-marvel.onrender.com/
+# DEFAULT_MARVEL_UNIVERSE_TIMEOUT=
+
+# --------- DC UNIVERSE ---------
+DC_UNIVERSE_URL=https://addon-dc-cq85.onrender.com/
+# DEFAULT_DC_UNIVERSE_TIMEOUT=
+
+# --------- STAR WARS UNIVERSE ---------
+STAR_WARS_UNIVERSE_URL=https://addon-star-wars-u9e3.onrender.com/
+# DEFAULT_STAR_WARS_UNIVERSE_TIMEOUT=
+
+# --------- ANIME KITSU ---------
+ANIME_KITSU_URL=https://anime-kitsu.strem.fun/
+# DEFAULT_ANIME_KITSU_TIMEOUT=
+
+# --------- NUVIOSTREAMS ---------
+NUVIOSTREAMS_URL=https://nuviostreams.hayd.uk/
+# DEFAULT_NUVIOSTREAMS_TIMEOUT=
+
+# --------- TMDB COLLECTIONS ---------
+TMDB_COLLECTIONS_URL=https://61ab9c85a149-tmdb-collections.baby-beamup.club/
+# DEFAULT_TMDB_COLLECTIONS_TIMEOUT=
+
+# ----------- TORRENTIO -------------
+TORRENTIO_URL=https://torrentio.strem.fun/
+# DEFAULT_TORRENTIO_TIMEOUT=
+
+# -------- ORION STREMIO ADDON --------
+ORION_STREMIO_ADDON_URL=https://5a0d1888fa64-orion.baby-beamup.club/
+# DEFAULT_ORION_STREMIO_ADDON_TIMEOUT=
+
+# ------------ PEERFLIX --------------
+PEERFLIX_URL=https://peerflix-addon.onrender.com/
+# DEFAULT_PEERFLIX_TIMEOUT=
+
+# -------- TORBOX STREMIO ADDON --------
+TORBOX_STREMIO_URL=https://stremio.torbox.app/
+# DEFAULT_TORBOX_STREMIO_TIMEOUT=
+
+# -------- EASYNEWS ADDON (Standalone) --------
+EASYNEWS_URL=https://ea627ddf0ee7-easynews.baby-beamup.club/
+# DEFAULT_EASYNEWS_TIMEOUT=
+
+# ------------ DEBRIDIO -----------
+DEBRIDIO_URL=https://addon.debridio.com/
+# DEFAULT_DEBRIDIO_TIMEOUT=
+
+# ------------ DEBRIDIO TVDB ------------
+DEBRIDIO_TVDB_URL=https://tvdb-addon.debridio.com/
+# DEFAULT_DEBRIDIO_TVDB_TIMEOUT=
+
+# ------------ DEBRIDIO TMDB ------------
+DEBRIDIO_TMDB_URL=https://tmdb-addon.debridio.com/
+# DEFAULT_DEBRIDIO_TMDB_TIMEOUT=
+
+# ------------ DEBRIDIO TV ------------
+DEBRIDIO_TV_URL=https://tv-addon.debridio.com/
+# DEFAULT_DEBRIDIO_TV_TIMEOUT=
+
+# ------------ DEBRIDIO WATCHTOWER ------------
+DEBRIDIO_WATCHTOWER_URL=https://wt-addon.debridio.com/
+# DEFAULT_DEBRIDIO_WATCHTOWER_TIMEOUT=
+
+# ------------ OPENSUBTITLES V3 ------------
+OPENSUBTITLES_URL=https://opensubtitles-v3.strem.io/
+# DEFAULT_OPENSUBTITLES_TIMEOUT=
+
+# ------------ TORRENT CATALOGS ------------
+TORRENT_CATALOGS_URL=https://torrent-catalogs.strem.fun/
+# DEFAULT_TORRENT_CATALOGS_TIMEOUT=
+
+# ------------ RPDB CATALOGS ------------
+RPDB_CATALOGS_URL=https://1fe84bc728af-rpdb.baby-beamup.club/
+# DEFAULT_RPDB_CATALOGS_TIMEOUT=
+
+# ------------- DMM Cast ----------------
+# DEFAULT_DMM_CAST_TIMEOUT=
+
+# ----------- STREAMING CATALOGS ---------
+STREAMING_CATALOGS_URL=https://7a82163c306e-stremio-netflix-catalog-addon.baby-beamup.club
+# DEFAULT_STREAMING_CATALOGS_TIMEOUT=
+
+# ----------- ANIME CATALOGS -----------
+ANIME_CATALOGS_URL=https://1fe84bc728af-stremio-anime-catalogs.baby-beamup.club
+# DEFAULT_ANIME_CATALOGS_TIMEOUT=
+
+# ----------- DOCTOR WHO UNIVERSE -----------
+DOCTOR_WHO_UNIVERSE_URL=https://new-who.onrender.com
+# DEFAULT_DOCTOR_WHO_UNIVERSE_TIMEOUT=
+
+# ----------- WEBSTREAMR -----------
+WEBSTREAMR_URL=https://webstreamr.hayd.uk
+# DEFAULT_WEBSTREAMR_TIMEOUT=
+# ==============================================================================

.gitattributes

@@ -33,3 +33,5 @@ saved_model/**/* filter=lfs diff=lfs merge=lfs -text
 *.zip filter=lfs diff=lfs merge=lfs -text
 *.zst filter=lfs diff=lfs merge=lfs -text
 *tfevents* filter=lfs diff=lfs merge=lfs -text
+*.png filter=lfs diff=lfs merge=lfs -text
+*.ico filter=lfs diff=lfs merge=lfs -text

.github/FUNDING.yml

@@ -0,0 +1,4 @@
+# These are supported funding model platforms
+
+github: Viren070
+ko_fi: Viren070

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -0,0 +1,107 @@
+name: Bug report
+description: Report a bug you encountered
+title: 'bug: '
+labels:
+  - bug
+body:
+  - type: dropdown
+    id: 'deployment'
+    attributes:
+      label: Deployment Method
+      description: How are you hosting the addon?
+      options:
+        - Public ElfHosted Instance
+        - Private ElfHosted Instance
+        - Cloudflare Workers
+        - VPS
+        - Other, specify at description
+    validations:
+      required: true
+  - type: input
+    id: 'addonVersion'
+    attributes:
+      label: Addon Version
+      description: What version of the addon are you using, or what was the commit that your deployment was built off of?
+      placeholder: v1.13.8
+    validations:
+      required: true
+  - type: dropdown
+    id: 'bugArea'
+    attributes:
+      label: Bug Area
+      description: Select what area of the addon this issue affects
+      options:
+        - Deploying
+        - Configuring
+        - Installing
+        - Obtaining streams.
+        - Playback
+    validations:
+      required: true
+  - type: input
+    id: 'deviceInfo'
+    attributes: 
+      label: Device/Browser/OS/Stremio Version
+      description: Details about the device this issue occurs on. Leave blank if not applicable (e.g. error within addon)
+      placeholder: Windows on Stremio 5 Beta
+  - type: textarea
+    id: 'bugDescription'
+    attributes:
+      label: Bug Description / Steps to Reproduce
+      description: Precisely describe the bug you encountered and the steps to reproduce it. Avoid vague descriptions. Include relevant details - such as if you were using MediaFlow. 
+    validations:
+      required: true
+  - type: textarea
+    id: 'expectedBehaviour'
+    attributes:
+      label: Expected Behavior
+      description: Describe what you expected to happen.
+    validations:
+      required: true
+  - type: textarea
+    id: 'configExport'
+    attributes:
+      label: Configuration Export
+      description: Provide an export of your configuration with credentials excluded (make sure to double check it has nothing sensitive in it like custom addon URLs or overriden URLs etc.
+    validations:
+      required: true
+  - type: textarea
+    id: 'screenshots'
+    attributes:
+      label: Screenshots
+      description: If applicable, add screenshots of the bug and your configuration.
+  - type: checkboxes
+    id: 'debuggingChecklist'
+    attributes:
+      label: Debugging Checklist
+      description: Confirm you have included at least some of the following debugging information. If you haven't, please do so before submitting the issue.
+      options:
+        - label: >-
+            If applicable, I have included server logs 
+          required: false
+        - label: >-
+            If applicable, I have included MediaFlow logs
+          required: false
+  - type: checkboxes
+    id: 'issueChecklist'
+    attributes:
+      label: Issue Checklist
+      description: Confirm that you have understood and followed these requirements
+      options:
+        - label: >-
+            I have written a short but informative title that clearly describes the issue.
+          required: true
+        - label: >- 
+            I have given clear and descriptive steps to reproduce the issue.
+          required: true
+        - label: >- 
+            I have checked open and closed issues and confirmed that this is not a duplicate of another issue.
+          required: true
+        - label: >- 
+            I have filled out all of the requested information adequately. 
+          required: true
+        - label: >- 
+            I am using the [latest version](https://github.com/Viren070/AIOStreams/releases/latest). 
+          required: true
+            
+

.github/ISSUE_TEMPLATE/config.yml

@@ -0,0 +1,6 @@
+blank_issues_enabled: false
+contact_links:
+  - name: AIOStreams Community Support
+    url: https://github.com/Viren070/AIOStreams/discussions/categories/help
+    about: If you need help, create a new post here with your question.
+

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -0,0 +1,39 @@
+name: Feature Request
+description: Suggest an idea for the project
+title: 'feature request: '
+labels:
+  - feature request
+body:
+  - type: checkboxes
+    id: '1'
+    attributes:
+      label: Checklist
+      description: >-
+        Please check the following before submitting a feature request. If you
+        are unable to check all the boxes, please provide more information in the
+        description.
+      options:
+        - label: >-
+            I checked that this feature has not been requested before
+          required: true
+        - label: >-
+            I checked that this feature is not in the "Not planned" list
+          required: true
+        - label: >-
+            This feature will benefit the majority of users
+  - type: textarea
+    id: '2'
+    attributes:
+      label: Problem Description / Use Case
+      description: >-
+        Provide a detailed description of the problem you are facing or the use case you have in mind.
+    validations:
+      required: true
+  - type: textarea
+    id: '3'
+    attributes:
+      label: Proposed Solution
+      description: >-
+        Provide a detailed description of the solution you'd like to see. If you have any ideas on how to implement the feature, please include them here.
+    validations:
+      required: true

.github/workflows/build.yml

@@ -0,0 +1,27 @@
+name: Build Addon
+
+on:
+  pull_request:
+    branches:
+      - main
+    paths:
+      - 'packages/**'
+      - 'package-lock.json'
+      - 'package.json'
+      - 'tsconfig.json'
+      - 'tsconfig.base.json'
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - name: Use Node.js
+        uses: actions/setup-node@v4
+        with:
+          node-version: '22.x'
+
+      - name: Install Dependencies
+        run: npm ci
+      - name: Build Addon
+        run: npm run build

.github/workflows/deploy-docker.yml

@@ -0,0 +1,197 @@
+name: Build and Deploy Docker Images
+
+on:
+  workflow_dispatch:
+    inputs:
+      ref:
+        description: Git Ref
+        required: true
+        type: string
+
+jobs:
+  build:
+    name: build
+    runs-on: ubuntu-latest
+    permissions:
+      packages: write
+      contents: read
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          ref: ${{inputs.ref}}
+          token: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Login to Docker Hub
+        uses: docker/login-action@v3
+        with:
+          username: ${{ secrets.DOCKERHUB_USERNAME }}
+          password: ${{ secrets.DOCKERHUB_TOKEN }}
+
+      - name: Login to GitHub Container Registry
+        uses: docker/login-action@v3
+        with:
+          registry: ghcr.io
+          username: ${{ github.repository_owner }}
+          password: ${{ secrets.GITHUB_TOKEN }}
+
+      - name: Set up QEMU
+        uses: docker/setup-qemu-action@v3
+
+      - name: Set up Buildx
+        uses: docker/setup-buildx-action@v3
+
+      - name: Calculate Image Tags
+        env:
+          INPUT_REF: ${{inputs.ref}}
+        run: |
+          declare TAGS=""
+          case "${INPUT_REF}" in
+          v[0-9]*.[0-9]*.[0-9]*)
+            TAGS="${INPUT_REF}"
+            if [[ "$(git rev-parse origin/main)" = "$(git rev-parse "${INPUT_REF}")" ]]; then
+              TAGS="${TAGS} latest"
+            fi
+            CHANNEL="stable"
+            ;;
+          [0-9]*.[0-9]*.[0-9]*-nightly)
+            TAGS="${INPUT_REF} nightly"
+            CHANNEL="nightly"
+            ;;
+          *)
+            echo "Invalid Input Ref: ${INPUT_REF}"
+            exit 1
+          esac
+
+          if [[ -z "${TAGS}" ]]; then
+            echo "Empty Tags!"
+            exit 1
+          fi
+
+          {
+            echo 'DOCKER_IMAGE_TAGS<<EOF'
+            for tag in ${TAGS}; do
+            echo "viren070/aiostreams:${tag}"
+            echo "ghcr.io/viren070/aiostreams:${tag}"
+            done
+            echo EOF
+          } >> "${GITHUB_ENV}"
+
+          echo "TAGS=${TAGS}" >> "${GITHUB_ENV}"
+
+          echo "CHANNEL=${CHANNEL}" >> "${GITHUB_ENV}"
+
+          cat "${GITHUB_ENV}"
+
+      - name: Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: 20
+
+      - name: Generate metadata
+        run: |
+          node scripts/generateMetadata.js --channel=${{env.CHANNEL}}
+
+      - name: Build & Push
+        uses: docker/build-push-action@v6
+        with:
+          cache-from: type=gha
+          cache-to: type=gha,mode=max
+          platforms: linux/amd64,linux/arm64
+          push: true
+          context: .
+          file: ./Dockerfile
+          tags: ${{env.DOCKER_IMAGE_TAGS}}
+
+      - name: Send Discord Notification
+        env:
+          CHANNEL: ${{env.CHANNEL}}
+          TAGS: ${{env.TAGS}}
+        run: |
+          # Determine role based on channel
+          if [ "$CHANNEL" = "stable" ]; then
+            ROLE_ID="<@&1384627130272452638>"
+            COLOR=5763719  # Green
+            TITLE="🎉 Stable Release"
+          else
+            ROLE_ID="<@&1384627462155272242>"
+            COLOR=15844367  # Orange
+            TITLE="🌙 Nightly Build"
+          fi
+
+          # Format tags for display (each tag on a new line with bullet points)
+          FORMATTED_TAGS=""
+          for tag in $TAGS; do
+            if [ -z "$FORMATTED_TAGS" ]; then
+              FORMATTED_TAGS="• \`$tag\`"
+            else
+              FORMATTED_TAGS="$FORMATTED_TAGS\n• \`$tag\`"
+            fi
+          done
+
+          # Get current timestamp in ISO 8601 format UTC
+          TIMESTAMP=$(date -u +"%Y-%m-%dT%H:%M:%SZ")
+
+          # Create JSON payload file
+          cat << EOF > discord_payload.json
+          {
+            "content": "$ROLE_ID",
+            "embeds": [
+              {
+                "title": "$TITLE - Docker Images Published",
+                "description": "New Docker images have been built and pushed to registries.",
+                "color": $COLOR,
+                "fields": [
+                  {
+                    "name": "📦 Channel",
+                    "value": "• \`$CHANNEL\`",
+                    "inline": true
+                  },
+                  {
+                    "name": "🏷️ Tags Published",
+                    "value": "$FORMATTED_TAGS",
+                    "inline": false
+                  },
+                  {
+                    "name": "📍 View Images",
+                    "value": "[Docker Hub](https://hub.docker.com/r/viren070/aiostreams) · [GHCR](https://github.com/Viren070/AIOStreams/pkgs/container/aiostreams)",
+                    "inline": false
+                  },
+                  {
+                    "name": "🔗 View Build",
+                    "value": "[GitHub Actions](https://github.com/Viren070/aiostreams/actions/runs/${{ github.run_id }})",
+                    "inline": false
+                  }
+                ],
+                "footer": {
+                  "text": "AIOStreams CI",
+                  "icon_url": "https://github.com/Viren070.png"
+                },
+                "timestamp": "$TIMESTAMP"
+              }
+            ]
+          }
+          EOF
+
+          echo "Sending to Discord:"
+          cat discord_payload.json
+
+          # Send payload to Discord and capture response and status code
+          http_response=$(curl -s -w "\n%{http_code}" -H "Content-Type: application/json" \
+            -X POST \
+            -d @discord_payload.json \
+            "${{ secrets.DISCORD_WEBHOOK_URL }}")
+
+          http_body=$(echo "$http_response" | sed '$d')
+          http_code=$(echo "$http_response" | tail -n1)
+
+          echo "HTTP Status Code: $http_code"
+          echo "Discord Response Body: $http_body"
+
+          if [ "$http_code" != "204" ]; then
+            echo "Error sending to Discord webhook."
+            exit 1
+          fi
+
+          echo "Message sent successfully!"

.github/workflows/nightly.yml

@@ -0,0 +1,64 @@
+name: Nightly Builds
+
+on:
+  push:
+    branches: [main]
+    paths:
+      - 'packages/**'
+      - 'package-lock.json'
+      - 'package.json'
+      - 'tsconfig.json'
+      - 'tsconfig.base.json'
+      - 'Dockerfile'
+
+jobs:
+  release:
+    name: release
+    if: ${{ github.ref == 'refs/heads/main' }}
+    runs-on: ubuntu-latest
+    permissions:
+      actions: write
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Generate timestamp tag
+        id: gen_tag
+        run: |
+          TIMESTAMP=$(date '+%Y.%m.%d.%H%M-nightly')
+          echo "tag_name=$TIMESTAMP" >> $GITHUB_OUTPUT
+
+      - name: Create git tag
+        env:
+          TAG_NAME: ${{ steps.gen_tag.outputs.tag_name }}
+        run: |
+          git config user.name "github-actions[bot]"
+          git config user.email "github-actions[bot]@users.noreply.github.com"
+          git tag $TAG_NAME
+          git push origin $TAG_NAME
+
+      - name: Get commit message
+        id: commit_msg
+        run: |
+          COMMIT_MSG=$(git log -1 --pretty=%B)
+          echo "commit_msg<<EOF" >> $GITHUB_OUTPUT
+          echo "$COMMIT_MSG" >> $GITHUB_OUTPUT
+          echo "EOF" >> $GITHUB_OUTPUT
+
+      - name: Create GitHub prerelease
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh release create "${{ steps.gen_tag.outputs.tag_name }}" \
+            --repo "${GITHUB_REPOSITORY}" \
+            --title "${{ steps.gen_tag.outputs.tag_name }}" \
+            --notes "${{ steps.commit_msg.outputs.commit_msg }}" \
+            --prerelease
+
+      - name: Trigger Docker Image Publish
+        env:
+          GH_TOKEN: ${{ github.token }}
+        run: |
+          gh workflow run --repo ${GITHUB_REPOSITORY} deploy-docker.yml -f ref=${{ steps.gen_tag.outputs.tag_name }}

.github/workflows/release.yml

@@ -0,0 +1,31 @@
+name: Release
+
+on:
+  push:
+    branches: [main]
+  pull_request:
+    branches: [main]
+
+jobs:
+  release:
+    name: release
+    if: ${{ github.ref == 'refs/heads/main' }}
+    runs-on: ubuntu-latest
+    permissions:
+      actions: write
+      contents: write
+      pull-requests: write
+    steps:
+      - name: Release
+        id: release
+        uses: google-github-actions/release-please-action@v4
+        with:
+          token: ${{ secrets.RELEASE_PLEASE_TOKEN }}
+
+      - name: Trigger Docker Image Publish
+        if: ${{ steps.release.outputs['release_created'] }}
+        env:
+          GH_TOKEN: ${{ github.token }}
+          TAG_NAME: ${{ steps.release.outputs.tag_name }}
+        run: |
+          gh workflow run --repo ${GITHUB_REPOSITORY} deploy-docker.yml -f ref=${TAG_NAME}

.gitignore

@@ -0,0 +1,10 @@
+node_modules/
+dist/
+*.tsbuildinfo
+out/
+.next/
+next-env.d.ts
+.wrangler/
+.env
+metadata.json
+data/

.prettierrc

@@ -0,0 +1,7 @@
+{
+  "semi": true,
+  "singleQuote": true,
+  "tabWidth": 2,
+  "trailingComma": "es5",
+  "endOfLine": "lf"
+}

.release-please-manifest.json

@@ -0,0 +1,3 @@
+{
+  ".": "2.4.2"
+}

.vscode/launch.json

@@ -0,0 +1,16 @@
+{
+  "version": "0.2.0",
+  "configurations": [
+    {
+      "name": "debug addon",
+      "type": "node",
+      "request": "launch",
+      "program": "src/server.ts",
+      "localRoot": "${workspaceFolder}/packages/addon",
+      "runtimeExecutable": "tsx",
+      "console": "integratedTerminal",
+      "internalConsoleOptions": "neverOpen",
+      "skipFiles": ["<node_internals>/**", "${workspaceFolder}/node_modules/**"]
+    }
+  ]
+}

.vscode/settings.json

@@ -0,0 +1,4 @@
+{
+  "editor.formatOnSave": true,
+  "editor.defaultFormatter": "esbenp.prettier-vscode"
+}

CHANGELOG.md

@@ -0,0 +1,665 @@
+# Changelog
+
+## [2.4.2](https://github.com/Viren070/AIOStreams/compare/v2.4.1...v2.4.2) (2025-06-27)
+
+
+### Bug Fixes
+
+* **debridio:** add Italy option ([7774310](https://github.com/Viren070/AIOStreams/commit/77743105de53e5de76ef4f4224883d57cc559bee))
+
+## [2.4.1](https://github.com/Viren070/AIOStreams/compare/v2.4.0...v2.4.1) (2025-06-27)
+
+
+### Bug Fixes
+
+* add 'Clip' as valid type for Trailer ([025f622](https://github.com/Viren070/AIOStreams/commit/025f622002c1409ed6d0e997ac4ee3d857bf10ba))
+* adjust defaults ([78d4d60](https://github.com/Viren070/AIOStreams/commit/78d4d604ca732d4f96ba9927724c7935e9a956d8))
+
+## [2.4.0](https://github.com/Viren070/AIOStreams/compare/v2.3.2...v2.4.0) (2025-06-27)
+
+
+### Features
+
+* add always precache option ([d4ff4a2](https://github.com/Viren070/AIOStreams/commit/d4ff4a2c0c913e7c6e3754ecb9fd72b45b1f864d))
+* add slice function to stream expression ([321b325](https://github.com/Viren070/AIOStreams/commit/321b32584014d20d8e78f66b4cef313d0cd22f0c))
+* add USA TV and Argentina TV ([e29800a](https://github.com/Viren070/AIOStreams/commit/e29800a0ab159940cafa11f0d69d4bc3f46c918c))
+* allow disabling user agent ([305ebd8](https://github.com/Viren070/AIOStreams/commit/305ebd84c8040866fc45fe1879921e3a7bb93997))
+
+
+### Bug Fixes
+
+* apply filters and precomputation to streams after each group fetch ([78144d0](https://github.com/Viren070/AIOStreams/commit/78144d02135072681237eae8bd5b11bf8fc3f991))
+* fix filtering ([32b1c3c](https://github.com/Viren070/AIOStreams/commit/32b1c3c3b384fad4109520c5730e8076cb2c6ebc))
+* include headers in logs ([4b9f268](https://github.com/Viren070/AIOStreams/commit/4b9f268b8f399a30f47d2140ecd9afd2856f284a))
+* pass specified services in DebridioPreset ([e264db6](https://github.com/Viren070/AIOStreams/commit/e264db6fc57ce58da476deadef5b3684228eba73))
+* set excludeUncached to false during pre-caching ([62aed42](https://github.com/Viren070/AIOStreams/commit/62aed42b07adf24c42cd5ac6c3a43d323e210890))
+* skip failed addons on manifest fetch ([cada0de](https://github.com/Viren070/AIOStreams/commit/cada0de63ac8602adabd2af2b04015f87697668e))
+* **streamfusion:** remove service requirement, enable torrent providers, lower limits ([3d856a2](https://github.com/Viren070/AIOStreams/commit/3d856a252dd77d27c81d4539ad848af95f1ca0dd))
+
+## [2.3.2](https://github.com/Viren070/AIOStreams/compare/v2.3.1...v2.3.2) (2025-06-24)
+
+
+### Bug Fixes
+
+* only show warning when no idPrefixes are given ([832deae](https://github.com/Viren070/AIOStreams/commit/832deaed64ea977d493d3815a58f7528aa7b03e1))
+* remove folderSize from downloadable streams ([baf4c46](https://github.com/Viren070/AIOStreams/commit/baf4c461682fae5dd30e809897498f5d5a62482b))
+* remove length requirement for string properties in ManifestSchema ([b009511](https://github.com/Viren070/AIOStreams/commit/b00951144925f174a30b0e2858f963c6cbee3837))
+
+## [2.3.1](https://github.com/Viren070/AIOStreams/compare/v2.3.0...v2.3.1) (2025-06-24)
+
+
+### Bug Fixes
+
+* set idPrefixes to undefined for new resources too ([97894be](https://github.com/Viren070/AIOStreams/commit/97894be562ef28a4ddd3887093481f60d4e6b3f1))
+
+## [2.3.0](https://github.com/Viren070/AIOStreams/compare/v2.2.1...v2.3.0) (2025-06-24)
+
+
+### Features
+
+* add `EXPOSE_USER_COUNT` set to false by default ([3e9820b](https://github.com/Viren070/AIOStreams/commit/3e9820bc3de6bca391259026523a07d63e8c90e7))
+* add more fields to bingeGroup ([f53c8ca](https://github.com/Viren070/AIOStreams/commit/f53c8cab1f3465ebf639e035824b7b3c2e069203))
+* add tmdb addon ([96bf1de](https://github.com/Viren070/AIOStreams/commit/96bf1de8bd5a44b10bc3ada6dd8e1cd5c11b1d2e))
+* add torrentsdb ([aebef33](https://github.com/Viren070/AIOStreams/commit/aebef33432d9d21c5c90577da73fc21803432b83))
+* improve parsing for debridio tv ([320dbb2](https://github.com/Viren070/AIOStreams/commit/320dbb29020cc499c4d806f904feb0f4d45730d3))
+
+
+### Bug Fixes
+
+* add discovery+ option to streaming catalogs ([3b47339](https://github.com/Viren070/AIOStreams/commit/3b473393e201c32afbe5301a1d5ff9026b1f5718))
+* make sorting in deduplicator consistent ([b15efd5](https://github.com/Viren070/AIOStreams/commit/b15efd5529d1246e538b25797930bcbab874b73b))
+* only extract folder size if difference is large enough ([3d7808b](https://github.com/Viren070/AIOStreams/commit/3d7808b92cde840dac242ad8f52fd671a02199fb))
+* set idPrefixes to undefined when an addon for that resource doesn't provide it ([f3ff7c5](https://github.com/Viren070/AIOStreams/commit/f3ff7c53d2ad4d6c809c1f27d5be3177969f4841))
+
+## [2.2.1](https://github.com/Viren070/AIOStreams/compare/v2.2.0...v2.2.1) (2025-06-22)
+
+
+### Bug Fixes
+
+* add catalog and meta resources to mediafusion preset ([ee492e2](https://github.com/Viren070/AIOStreams/commit/ee492e2b218bbad813426368ec7f30ecedc79e59))
+* add min and max constraints validation for options in config ([675eaf0](https://github.com/Viren070/AIOStreams/commit/675eaf0b6340ed52b2d0267442a24448048b04cb))
+* allow null values in options array for manifest extras ([99d66e8](https://github.com/Viren070/AIOStreams/commit/99d66e835c421af0ad6c86500dc38f93b8d85ca3))
+* correct property name from 'seeders' to 'seeder' in includedReasons ([912fa49](https://github.com/Viren070/AIOStreams/commit/912fa4910e097c2ec1424ac360482d56b51e6022))
+* **frontend:** add sensible steps and remove min max constraint in NumberInput for TemplateOption ([1119721](https://github.com/Viren070/AIOStreams/commit/1119721054d77cf7729ed27cf7b4593237bc3675))
+
+## [2.2.0](https://github.com/Viren070/AIOStreams/compare/v2.1.0...v2.2.0) (2025-06-22)
+
+
+### Features
+
+* add 'not' function to BaseConditionParser for filtering streams ([44d2c4c](https://github.com/Viren070/AIOStreams/commit/44d2c4c8708dae8c07370b16d6ca5e7750369ddb))
+* add logging for include details/reasons during filtering ([9de901d](https://github.com/Viren070/AIOStreams/commit/9de901d22b6e3c8ae515f41fccb63447283492b8))
+* add merge function in BaseConditionParser ([f223368](https://github.com/Viren070/AIOStreams/commit/f22336800ae952b6f3e703006075b4360da94524))
+* add regexMatchedInRange function to BaseConditionParser ([cc2f5f7](https://github.com/Viren070/AIOStreams/commit/cc2f5f7608f8dbd3f9d52031e0e6da377d9031b0))
+* add support for required and preferred filter conditions ([d9281bd](https://github.com/Viren070/AIOStreams/commit/d9281bd978f186a50f04ead98c6fcca41bb32bfb))
+* adjust wording and naming of expression/condition parser ([a06aea9](https://github.com/Viren070/AIOStreams/commit/a06aea923cdad1540d2edb858ce1de1412d5dd11))
+* apply filter conditions last ([41d507a](https://github.com/Viren070/AIOStreams/commit/41d507a679af598fbfb4e9391688f1dc70613a5c))
+* enable addition and subtraction in base Parser ([c4e65f8](https://github.com/Viren070/AIOStreams/commit/c4e65f83b3a0157ec87b775d8967017bfd425ee8))
+* handle missing debridio api key for clear errors ([ad4a51c](https://github.com/Viren070/AIOStreams/commit/ad4a51caa11c4447cff59ce6f07cf2a870d8f297))
+* improve condition parser functions to support multiple parameters ([110146c](https://github.com/Viren070/AIOStreams/commit/110146c088ceebc1472eb8f5442d966faabb0278))
+* loop through optionMetas to ensure new options are validated too and ignore individual errors from presets when necessary ([2ffc82c](https://github.com/Viren070/AIOStreams/commit/2ffc82c864878e0d212bbfa6582044555ba6fc78))
+* support multiple regex names in regexMatched function ([455f430](https://github.com/Viren070/AIOStreams/commit/455f4307fdee14098c9b3766322dd47682e7d270))
+* use title modifier for title in light gdrive formatter ([e542989](https://github.com/Viren070/AIOStreams/commit/e542989038ad253a098cce41e9480a2927c7514a))
+
+
+### Bug Fixes
+
+* actually use the streams after applying filter conditions ([4bc0259](https://github.com/Viren070/AIOStreams/commit/4bc0259dad92d636f338aae4b0b4af0cb0666d2a))
+* allow empty regex names in ParsedStreamSchema and AIOStream ([cf39cdf](https://github.com/Viren070/AIOStreams/commit/cf39cdfee14d41bb67e9a8bff2d720e7d33cffc5))
+* **debridio:** update preset to support new version ([#213](https://github.com/Viren070/AIOStreams/issues/213)) ([23e8078](https://github.com/Viren070/AIOStreams/commit/23e8078b3f5aaa7554857e3fefd0a49ba4d2f6b7))
+* ensure comparison checks for deduplications are carried out when needed ([c7bb0c8](https://github.com/Viren070/AIOStreams/commit/c7bb0c8bee69b82688f08e005985b3a8e6436048))
+* extract streamExpressionMatched from AIOStream parser ([7e65738](https://github.com/Viren070/AIOStreams/commit/7e657380d7f0c2cfd01b3367e9bd876465a710d8))
+* fallback to parent get filename method when filename not found in description for mediafusion ([cfb5977](https://github.com/Viren070/AIOStreams/commit/cfb59771fc9bc23b3b982bfbfce75436ca4f37fa))
+* fallback to using parsed properties from folder when undefined in file and correctly merge array properties ([8eb9b7a](https://github.com/Viren070/AIOStreams/commit/8eb9b7a92efbbf76991d532b828ab48070f13b6d))
+* filter out uuid in filtered export ([bd21b36](https://github.com/Viren070/AIOStreams/commit/bd21b364d27cbcc72a464c14eb372ffbd8e33a51))
+* **formatters:** make title modifier return consistent cases with each word titled ([3e6b45a](https://github.com/Viren070/AIOStreams/commit/3e6b45a554bdc15c473e64bc22cee5d0b8c7de7f))
+* handle invalid addon password error separately for catalog API to be more clear ([a2275cc](https://github.com/Viren070/AIOStreams/commit/a2275cce1bcdf37ba7dd65016a544b222e8ee3a4))
+* ignore port in host check ([e73be92](https://github.com/Viren070/AIOStreams/commit/e73be9298d82dbb2a9b492cb636c5bd5d82fd1e0))
+* normalize case sensitivity in condition parser filters for resolutions, qualities, encodes, types, visualTags, audioTags, audioChannels, and languages ([87d2ffb](https://github.com/Viren070/AIOStreams/commit/87d2ffba7f8b8fc3e7ce70372e4f4932aa86bbc5))
+* only form keyword patterns when length of array is greater than 0 ([9136694](https://github.com/Viren070/AIOStreams/commit/91366943bb813fd99cd6c4775952c8bc5af9d54f))
+* rename 'not' function to 'negate' to avoid conflicts ([8477584](https://github.com/Viren070/AIOStreams/commit/8477584f9e65aae796c7aa432ffdbc36212f3260))
+* update credentials field to allow empty strings ([c006321](https://github.com/Viren070/AIOStreams/commit/c00632146d4980ec5a640b54eeb3bbd63f999189))
+
+## [2.1.0](https://github.com/Viren070/AIOStreams/compare/v2.0.1...v2.1.0) (2025-06-20)
+
+
+### Features
+
+* allow disabling pruning and disable it by default ([85c0ec1](https://github.com/Viren070/AIOStreams/commit/85c0ec1b5436af1115f97149f87b41aba41fe3ff))
+* allow specifying providers in torrentio ([8e5f4b5](https://github.com/Viren070/AIOStreams/commit/8e5f4b520cbcf472598a955039dc33bdda676bd5))
+* enable conditional operators in parser, allowing ternary statements in filter conditions ([eb6edfc](https://github.com/Viren070/AIOStreams/commit/eb6edfc3f1cb1c6a79400d2311cbe8811f1d284c))
+* extract folder size for stremthru torz ([e775562](https://github.com/Viren070/AIOStreams/commit/e775562e3c736fb4d652a161a7e29f3fcd28be1f))
+* improve cache stats logging ([d47eee0](https://github.com/Viren070/AIOStreams/commit/d47eee002112f6330d1b74920199bface0105eed))
+* improve save install page ([a115e59](https://github.com/Viren070/AIOStreams/commit/a115e5906f568b630425276cf321a931b37aadf1))
+* only add foldername if different and parse info from both folder and filename ([6eed23f](https://github.com/Viren070/AIOStreams/commit/6eed23f445d017ae6d18e9874978a8874350d006))
+
+
+### Bug Fixes
+
+* add enableCollectionFromMovie option to TMDB Collections ([71d9fe0](https://github.com/Viren070/AIOStreams/commit/71d9fe093cad1566172206d0a87662358bd446a6)), closes [#194](https://github.com/Viren070/AIOStreams/issues/194)
+* add stream as supported resource for TMDB Collections ([d2ef215](https://github.com/Viren070/AIOStreams/commit/d2ef2154fda902900751c47527ff52390506bd54))
+* add validation to pruneUsers method to ensure negative maxDays input is not used ([6b597b3](https://github.com/Viren070/AIOStreams/commit/6b597b31306fbe42d4104a71f9f330db32d9cda5))
+* adjust idPrefixes handling to improve compatibility in most cases ([7fa8ba7](https://github.com/Viren070/AIOStreams/commit/7fa8ba71fbb682d077fb5c8ccfbadfb0050bea80))
+* change all debrid service name to AllDebrid ([a89cdca](https://github.com/Viren070/AIOStreams/commit/a89cdca583e50c3bf66432bbb721797954323ba6)), closes [#208](https://github.com/Viren070/AIOStreams/issues/208)
+* convert live types to http for webstreamr ([64977ca](https://github.com/Viren070/AIOStreams/commit/64977caeffe2cb6b95714916c14bfa006502c386))
+* don't pass encoded_user_data header if URL is overriden ([ed2c0f5](https://github.com/Viren070/AIOStreams/commit/ed2c0f5800592c6bf140dc1f9ea8bdb9057d1d55))
+* exit auto prune when max days is less than 0 ([ee1ddc0](https://github.com/Viren070/AIOStreams/commit/ee1ddc07389d01b382f19fa46e434ca93f41d3e8))
+* explicitly check for unknown in version and default to 0.0.0 for manifest response ([8664e00](https://github.com/Viren070/AIOStreams/commit/8664e004e2553ffb675131488a4c4eab70ede7b3)), closes [#198](https://github.com/Viren070/AIOStreams/issues/198)
+* extract size for nuviostreams ([ebbd7ec](https://github.com/Viren070/AIOStreams/commit/ebbd7ec3b24d11abc2806e9edbd2aeaee45faa09))
+* fix error handling in config modal ([5182a07](https://github.com/Viren070/AIOStreams/commit/5182a07ac49d1aa79f515d72c71c7494a27866dd))
+* **frontend:** filter out proxy credentials and url in export when exclude credentials is true ([3c31939](https://github.com/Viren070/AIOStreams/commit/3c319391b86e6efa530aab5b8cd04ad9341867d1))
+* handle empty addon name in stream results and update description for addon name field ([5612140](https://github.com/Viren070/AIOStreams/commit/5612140ffee8b8e8804d36efdfd22e6f110b32ef))
+* handle pikpak credentials for mediafusion ([eee444f](https://github.com/Viren070/AIOStreams/commit/eee444f376136ed04257187c4bb1ddc05f05a3f5))
+* include addon name in error messages for invalid manifest URLs ([abf99c1](https://github.com/Viren070/AIOStreams/commit/abf99c1768f3cf86d6f58ec256705ae235f9d8f9))
+* make types optional in ManifestSchema ([5281756](https://github.com/Viren070/AIOStreams/commit/5281756c78e362d3c48cc4469c07c17df9350d9c))
+* make types required and provide array based on resources object array ([01cf37f](https://github.com/Viren070/AIOStreams/commit/01cf37f8340a9fd130ecb19c93dc7a9863eab012))
+* manually override type to http for watchtower and nuviostreams ([1fb00a4](https://github.com/Viren070/AIOStreams/commit/1fb00a4317605ee9a5d0da73a4b363bf08b9bf6f))
+* map defaultProviders to their values in TorrentioPreset configuration ([9b04403](https://github.com/Viren070/AIOStreams/commit/9b044037d38b46270e23172914d1e35f72f51e1f))
+* normalize version check ([#206](https://github.com/Viren070/AIOStreams/issues/206)) ([05cc116](https://github.com/Viren070/AIOStreams/commit/05cc116fafc9ba6d0f40b7e10938e2505085ea10))
+* only add to idPrefixes if not null ([6fb5f7b](https://github.com/Viren070/AIOStreams/commit/6fb5f7b841872b0261023766c2472c7f5201be95))
+* overlapping snippets modal ([#202](https://github.com/Viren070/AIOStreams/issues/202)) ([195da69](https://github.com/Viren070/AIOStreams/commit/195da69f19ca8e15acd000420c1187fd4116de1f))
+* prevent title from being parsed for info ([f8b2e2d](https://github.com/Viren070/AIOStreams/commit/f8b2e2d66ce07ae4342db974ed6f169c0474d1d2))
+* remove idPrefixes from top level manifest ([908b4ff](https://github.com/Viren070/AIOStreams/commit/908b4ffa399439ab3f9428357b30a6ae7bc0f29d))
+* remove outdated decoding of credentials causing issues with some credentials ([609931e](https://github.com/Viren070/AIOStreams/commit/609931e5318c8b6d782cc04cf6a6691269bba287))
+* remove timestamp from cache stats ([509e3bd](https://github.com/Viren070/AIOStreams/commit/509e3bd2098f10d041a2a776d9b4099567fe4370))
+* remove unused method handler for unsupported HTTP methods ([7405d27](https://github.com/Viren070/AIOStreams/commit/7405d272ab79321d8b1e97ee4bcd1a2b2f8c12a5))
+* rename web_dl to webdl in stremthru store ([3fb57c5](https://github.com/Viren070/AIOStreams/commit/3fb57c5d04e23585e71a5e9f0643735f675671c7))
+* simplify and fix configuration generation for services and providers in TorrentioPreset ([cfafeec](https://github.com/Viren070/AIOStreams/commit/cfafeecda3591c342d5f2aeb756fde4adc536024))
+* try explicitly setting idPrefixes to an empty array ([c16060f](https://github.com/Viren070/AIOStreams/commit/c16060f7a5ffa5b5142fe5a0753046748f682f0a))
+* try removing types ([10c4e2d](https://github.com/Viren070/AIOStreams/commit/10c4e2d51f7a0ba05d6214da1c848b66ec9237ca))
+* try setting idPrefixes to null ([a5f32df](https://github.com/Viren070/AIOStreams/commit/a5f32df451c7ba73438322c217ffa431e9a84125))
+* update descriptions for filtering options in menu component to clarify behavior ([67bb204](https://github.com/Viren070/AIOStreams/commit/67bb204362951ef3998c690ba1c0055c1a4cc12b))
+* use password type where necessary ([0a12d33](https://github.com/Viren070/AIOStreams/commit/0a12d335c34b8181c9ac849bed623ea77b43a84c))
+
+## [2.0.1](https://github.com/Viren070/AIOStreams/compare/v2.0.0...v2.0.1) (2025-06-19)
+
+
+### Bug Fixes
+
+* add audio channel to skipReasons ([ef1763c](https://github.com/Viren070/AIOStreams/commit/ef1763cbe60fe5c279138a152e1a8d677f30f0ce))
+* correctly handle overriding URL for mediafusion ([9bf3838](https://github.com/Viren070/AIOStreams/commit/9bf3838732542c5cac1ef189cd5afefc13fe0204))
+* ensure instances is defined ([7e00e32](https://github.com/Viren070/AIOStreams/commit/7e00e32bbe93a5610d4f94bc3d78a78e48d32c6b))
+
+## [2.0.0](https://github.com/Viren070/AIOStreams/compare/v1.22.0...v2.0.0) (2025-06-18)
+
+### 🚀 The Big Upgrades in v2 🚀
+
+- **Beyond Just Streams:** AIOStreams v2 now supports more than just stream addons! You can integrate **any supported Stremio addon type**, including **Catalog addons, Subtitle addons, and even Addon Catalog addons** into your single AIOStreams setup. Now it truly can do _everything_!
+- **100% Addon Compatibility:** That's right! AIOStreams v2 is designed to work with **100% of existing Stremio addons** that adhere to the Stremio addon SDK.
+- **Sleek New UI**: The entire interface has been redesigned for a more modern, intuitive, and frankly, beautiful configuration experience.
+
+_This new configuration page was only possible thanks to [Seanime](https://seanime.rahim.app), a beautiful application for anime_
+
+---
+
+### ✨ Feature Deep Dive - Get Ready for Control! ✨
+
+This rewrite has paved the way for a TON of new features and enhancements. Here’s a rundown:
+
+**🛠️ Configuration Heaven & Built-in Marketplace:**
+
+- The configuration page now features a **built-in marketplace for addons**. This makes it super easy to discover and add new addons, displaying their supported resources (streams, catalogs, subtitles, etc.), Debrid services they integrate with, and stream types (torrent, http, usenet, live etc.).
+- You can now **quickly enable or disable individual addons** within your AIOStreams setup without fully removing them. This is particularly useful because tools like StremThru Sidekick wouldn't be able to detect or manage the individual addons _inside_ your AIOStreams bundle, but with AIOStreams' own UI, you have that fine-grained control.
+- Remember, the marketplace is just there for convenience. You can still add any addon you want using the 'Custom' addon at the top of the marketplace and use an addons manifest URL to add it to AIOStreams.
+
+**📚 Supercharged Catalog Management:**
+
+- **Total Catalog Control:** Reorder your catalogs exactly how you want them, **regardless of which addon they originate from!** Mix and match to your heart's content.
+- **Granular Management:** Enable/disable specific catalogs, apply **shuffling** to individual catalogs - and control how long a shuffle lasts, **rename catalogs** for a personalized touch, and you can even **disable certain catalogs from appearing on your Stremio home page**, having them only show up in the Discover section for a cleaner look!
+- **Universal RPDB Posters:** Ever wanted those sleek posters with ratings on _any_ catalog? Now you can! Apply **RPDB posters (with ratings) to any addon that uses a supported ID type (like IMDB or TMDB ID), even if the original addon doesn't support RPDB itself.** Yes, this means you could add RPDB posters to Cinemeta if you wanted!
+- **Why not just use other tools like StremThru Sidekick or the Addon Manager for catalogs?**
+  - **Broader Compatibility:** Both StremThru Sidekick and Addon Manager are primarily limited to managing addons _for Stremio itself_. AIOStreams’ catalog features can be utilized by _any application_ that supports Stremio addons, not just Stremio.
+  - **True Internal Reordering:** Neither of those tools supports reordering catalogs _within an addon itself_. Since AIOStreams presents all its combined catalogs as coming from _one addon_, those tools wouldn't be able to reorder the catalogs _inside_ your AIOStreams setup. AIOStreams gives you that crucial internal control.
+  - **Safety:** AIOStreams does **not** make use of the Stremio API for its core functionality. This means it operates independently and **cannot break your Stremio account** or interfere with its settings.
+
+**🌐 Expanded Addon Ecosystem:**
+
+- The built-in marketplace comes packed with **many more addons than before**.
+- Some notable new stream addons include: **StremThru Torz, Nuvio Streams, Debridio Watchtower, StreamFusion**, and even built-in support for **wrapping AIOStreams within AIOStreams** (AIOception!).
+
+**💎 Revolutionary Grouping Feature:**
+
+- This is a big one! I've implemented a **new grouping feature** that allows you to group your addons and apply highly customizable conditions.
+- Streams from addons in Group 1 are always fetched. Then, you can set conditions for subsequent groups. For example, for Group 2, you could set a condition like `count(previousStreams) < 5`. This means addons in Group 2 will only be queried if the total number of streams found by Group 1 is less than 5. This means you can tell AIOStreams, for instance, to only tap into your backup/slower addon group if your main, preferred addons don't find enough streams first – super efficient!
+- This allows for incredibly optimized and tailored stream fetching. (For more advanced setups and details, I highly recommend checking out the **[Wiki](https://github.com/Viren070/AIOStreams/wiki/Groups)**).
+
+**🔎 Next-Level Filtering System:**
+
+- The filtering system has been completely revamped. Previously, you could mainly exclude or prefer. Now, for _every_ filter criteria, you can set **four different filter types**:
+  - **Include:** If matched, this item won't be excluded by other exclude/required filters for _any other exclude/required filter_.
+  - **Required:** Exclude the stream if this criteria is _not_ detected.
+  - **Exclude:** Exclude the stream if this criteria _is_ detected.
+  - **Preferred:** This is used for ranking when you use that filter as a sort criteria.
+- **New Filters Added:**
+  - **Conditions Filter:** This incredibly flexible filter uses the same powerful condition parser as the "Groups" feature. You can now enter **multiple filter conditions**, and any stream that matches _any_ of the conditions you define will be filtered out. This allows for an almost infinite number of ways to combine and exclude streams with surgical precision! For example, a condition like `addon(type(streams, 'debrid'), 'TorBox')` would exclude all Debrid-type streams _only_ from the "TorBox" addon, leaving its Usenet streams untouched.
+  - **Matching:** This powerful filter helps ensure you get the right content. It includes:
+    - **Title Matching:** Filter out results that don't match the requested title. You can choose between an "exact match" mode or a "contains" mode for flexibility. **You can optionally also match the year too.**
+    - **Season/Episode Matching:** Specifically for series, this mode filters out results with incorrect season or episode numbers, ensuring accuracy. This can be granularly applied to only specific addons or request types.
+  - **Audio Channels:** This was previously part of the Audio Tag filter but is now its own dedicated filter for more precise control (e.g., filter for 5.1, 7.1).
+  - **Seeders:** Define include/required/exclude ranges for seeders. Finally, you can set a **minimum seeder count** and automatically exclude results below that threshold!
+- **Adjusted & Enhanced Filters:**
+  - **Cache:** Get fine-grained control over cached/uncached content. You can now exclude uncached/cached content from specific Debrid services or addons, and even for specific stream types. For example, you could filter out all uncached _torrents_ but still allow uncached _Usenet_ results.
+  - **Clean Results (now "Deduplicator"):** This is now far more customizable! You can modify what attributes are used to identify duplicates (e.g., infohash, filename) and how duplicates are removed for each stream type. For instance, for cached results, you might want one result from each of your Debrid services, while for uncached results, you might only want the single best result from your highest priority service.
+  - **Size:** You can now set **individual file size ranges for each resolution** (e.g., 1-2GB for 720p, 3-5GB for 1080p, etc.).
+
+**📺 Smarter Sorting & Display:**
+
+- Define **different sorting priorities for cached vs. uncached media**, and also **different sorting for movies vs. series.**
+- **New "Light GDrive" Formatter:** For those who prefer a cleaner look but still need key information from the filename, this formatter only shows the title, year, and season/episode info (e.g., "Movie Title (2023) S01E01"), making sure you don't potentially choose an incorrect result while still keeping the text to a minimal level.
+  - And of course, you can always join our Discord server to discover custom display formats shared by the community and easily use them with AIOStreams' custom formatter feature!
+
+**✨ Quality of Life Enhancements:**
+
+- **Import/Export Configurations:** You can now easily **export your entire AIOStreams configuration into a file.** This file can then be imported into any AIOStreams instance at any time – perfect for backups or migrating to a new setup.
+  - **Shareable Templates:** There's an "Exclude Credentials" option when exporting, making it easy to share template configurations with others!
+  - **⚠️ Important Warning:** While the "Exclude Credentials" feature removes sensitive information you enter _directly_ into AIOStreams (like API keys), it **does not** modify or exclude URLs you provide for "Custom" addons or when you override an addon's default URL. These URLs can potentially contain sensitive tokens or identifiers, so please review them carefully before sharing a configuration file.
+- **External Downloads:** For added convenience, AIOStreams v2 now adds an "External Download" link below each stream result. Clicking this will open the direct download link for that stream in your browser, making it easy to grab a copy of the content if needed.
+- **Hide Errors:** Optionally hide error messages, and you can even specify this for particular resources (e.g., hide errors only for stream fetching, but show them for catalog fetching).
+- **Precache Next Episode:** When you're watching a series, AIOStreams can automatically request results for the _next_ episode in the background. If it finds that all available results are uncached, it can **ping the first uncached result for your preferred Debrid service to start downloading it.** The goal? By the time you finish your current episode, the next one might already be cached and ready to stream instantly!
+
+**A Note on Options:** AIOStreams v2 offers a vast array of configuration options, especially within the filtering system. While this provides incredible power and flexibility for advanced users, please remember that **most users won't need to dive deep into every setting.** The default configurations are designed to be sensible and provide a great experience out-of-the-box! For a detailed explanation of every option and how to fine-tune your setup, the **[AIOStreams v2 Configuration Guide](https://guides.viren070.me/stremio/addons/aiostreams)** has been fully updated and is your best resource.
+
+---
+
+### 💾 Under The Hood: The New Database Foundation 💾
+
+- **Database-Driven:** AIOStreams is now database-based! This means your configurations are stored securely. When you create a configuration, it's assigned a **unique UUID** that you'll use to access it in Stremio.
+- **Password Protected:** You'll protect your configurations with a **password**. Without it, no one else can access your configuration.
+- **Seamless Updates (Mostly!):** A huge benefit of being database-driven is that for most setting changes, there’s **no longer a need to reinstall the addon in Stremio!** Just update your configuration, and the changes apply automatically.
+  - **Note:** The only exception is if you make changes to your catalogs that affect their order or which addons provide them (e.g., reordering addons in the list, adding/removing catalog-providing addons). In this specific case, a reinstall of the AIOStreams addon in Stremio is needed for Stremio to pick up the new catalog structure.
+
+---
+
+### ⚠️ Important Notes & Caveats for v2 ⚠️
+
+- **Migration Requires Reconfiguration:** Due to the extensive changes and the new database system, existing AIOStreams users will need to **reconfigure their setups for v2.** Think of it as a fresh start with a much more powerful system! The **[v1 to v2 Migration Guide](https://github.com/Viren070/AIOStreams/wiki/Migrate-to-V2)** on the Wiki can help. For a deep dive into all the new settings, refer to the comprehensive **[AIOStreams v2 Configuration Guide](https://guides.viren070.me/stremio/addons/aiostreams)**. **If you use custom formatters, you should also check the migration guide for minor syntax adjustments.**
+- **Torrentio support (on public instance)?** Torrentio, the most popular addon, was disabled for most of v1's history due to the way it works (multiple requests appear to come from one IP, which is problematic for public instances). Torrentio remains **disabled on the public instance**, and this will not change. Self-hosted instances will have Torrentio enabled by default. The developer of Torrentio has personally stated that he does not want ElfHosted's public instances scraping Torrentio.
+- **Cloudflare Worker Support Dropped:** Maintaining compatibility with Cloudflare Workers alongside the new database requirements and feature set became infeasible. It was essentially like writing and maintaining two different versions of the addon. As such, direct Cloudflare Worker support has been dropped.
+- **Free Hosting Challenges:** AIOStreams v2 now **requires a database** for storing configurations. Many free hosting services do not provide persistent database storage (or have very limited free tiers), which can lead to your configurations being wiped when the instance restarts.
+  - For example, **Hugging Face Spaces** requires a paid tier for persistent storage.
+  - **Koyeb's** free tier does not offer persistent file storage for the SQLite database, however, Koyeb _does_ provide a free PostgreSQL database instance which AIOStreams v2 can use, offering a viable free hosting path if configured correctly.
+    I recommend looking for hosting solutions that offer persistent storage or a compatible free database tier if you plan to self-host on a free platform.
+
+---
+
+### 🔧 Self-Hosting AIOStreams & Self-Hosting Guides 🔧
+
+For those of you who like to have full control over your setup, **AIOStreams v2 is, of course, _still_ self-hostable!**
+
+If you're migrating your instance from v1 to v2, read the [Migration](https://github.com/Viren070/AIOStreams/wiki/Migrate-to-V2) page on the Wiki to ensure nothing unexpected happens.
+
+A few months back, I started out knowing very little about self-hosting (I was using Hugging Face to host my personal AIOStreams instance back then) and I've since decided to dive into self-hosting.
+
+As a result, I've put together a **set of comprehensive self-hosting guides** that I'm excited to share with the community. My goal with these guides is to take you **from scratch to hosting all sorts of addons and applications**, including AIOStreams, without spending a dime or needing any hardware other than a laptop/computer. (Some of you may even be able to set this all up just using your phone/tablet)
+
+The guides cover:
+
+- Securing a **free Oracle Cloud VPS** (yes, free!).
+- Installing **Docker** and getting comfortable with its basics.
+- Utilizing my **highly flexible and detailed template compose project.** This Docker Compose setup is designed to be a launchpad for your self-hosting adventures and includes configurations for **countless apps, with AIOStreams v2 ready to go!**
+
+If you've ever been curious about self-hosting but didn't know where to start, I believe these guides can help you get up and running with a powerful, remote, and secure setup.
+
+- **https://guides.viren070.me/selfhosting**
+
+---
+
+### 💬 Join the AIOStreams Community on Discord! 💬
+
+AIOStreams v2 wouldn't be where it is today without the feedback, bug reports, and ideas from our community. A Massive **THANK YOU** to everyone on Discord who took part in testing, shared suggestions, and patiently helped polish every feature. Your involvement genuinely shaped this release!
+
+To celebrate the launch, I'm running a **1-year Real-Debrid giveaway (with 2 winners)** exclusively in the Discord server! Just join the server for your chance to win.
+
+Outside of the giveaway, you can also join our server for:
+
+- Questions about and support for AIOStreams
+- Receive help with self hosting
+- Discover setups shared by the community like formats, regexes, group filters, condition filters etc. (and possibly even share your own!)
+- Staying updated on the latest AIOStreams developments
+
+Join our server using the link below:
+
+- **https://discord.viren070.me**
+
+---
+
+### ❤️ Support AIOStreams Development ❤️
+
+AIOStreams is a passion project that I develop solo in my free time. Countless hours have gone into this v2 rewrite, and I'm committed to making it the best it can be.
+
+If you find AIOStreams useful and want to support its continued development, please consider donating. Any amount is hugely appreciated and helps me dedicate more time to new features, bug fixes, and support.
+
+- **[Sponsor me on GitHub](https://github.com/sponsors/Viren070)**
+- **[Buy me a coffee on Ko-fi](https://ko-fi.com/viren070)**
+
+---
+
+### 🚀 Get Started with AIOStreams v2! 🚀
+
+I'm incredibly excited for you all to try out AIOStreams v2! I believe it's a massive step forward. Please give it a go, explore the new features, and share your feedback.
+
+Here’s how you can jump in:
+
+**1. Try the Public Instance (Easiest Way!)**
+
+- **ElfHosted (Official Public Instance):** Generously hosted and maintained.
+  - **Link:** **https://aiostreams.elfhosted.com/**
+
+**2. Self-Host AIOStreams v2**
+
+- **For New Self-Hosters:** If you know what you're doing - follow the [Deployment Wiki](https://github.com/Viren070/AIOStreams/wiki/Deployment). Otherwise, check out my comprehensive **[Self-Hosting Guides](https://guides.viren070.me/selfhosting)** to get started from scratch.
+- **Migrating from v1?** If you're currently self-hosting v1, ensure your setup supports persistent storage and then follow the **[v1 to v2 Migration Guide](https://github.com/Viren070/AIOStreams/wiki/Migrate-to-V2)**.
+
+**3. Managed Private Instance via ElfHosted (Support AIOStreams Development!)**
+
+- Want AIOStreams without the self-hosting hassle? ElfHosted offers private, managed instances.
+- ✨ **Support My Work:** If you sign up using my referral link, **33% of your subscription fee directly supports AIOStreams development!**
+  - **Get your ElfHosted AIOStreams Instance:** **https://store.elfhosted.com/product/aiostreams/elf/viren070**
+
+This release marks a new chapter for AIOStreams, and I can't wait to see how you all use it to enhance your Stremio experience.
+
+Cheers,
+
+Viren.
+
+See the commit breakdown below:
+
+### Features
+
+- add 'onlyOnDiscover' catalog modifier ([4024c01](https://github.com/Viren070/AIOStreams/commit/4024c01b0a55cdd18023cf4d9328f38d3b5c29d0))
+- add alert and socials options to schema, implement SocialIcon component, and update TemplateOption to render new option types ([a0a3c82](https://github.com/Viren070/AIOStreams/commit/a0a3c8231ae77cd379eb39ba68ef437b15b0a4e5))
+- add alert option to DebridioTmdbPreset and TmdbCollectionsPreset for language selector clarification ([093f90a](https://github.com/Viren070/AIOStreams/commit/093f90a3eeafb540aaf28638557ad75a8f1e44d9))
+- add aliased configuration support ([5df60d7](https://github.com/Viren070/AIOStreams/commit/5df60d7085a0b5f938c8f135c93c29286aed566b))
+- add anime catalogs ([5968685](https://github.com/Viren070/AIOStreams/commit/59686852d3b7c2e3f0f8e204bcf8b765aadb29f7))
+- add anime specific sorting and add help box to sort menu ([77ee7b4](https://github.com/Viren070/AIOStreams/commit/77ee7b48c465d67e2e105d1c134d88cd96b27093))
+- add api key field and handle encrypted values correctly. ([6a5759d](https://github.com/Viren070/AIOStreams/commit/6a5759d60e27ec83101a3f1b02284ad8242faea9))
+- add asthetic startup logs ([fdbd282](https://github.com/Viren070/AIOStreams/commit/fdbd2821101bd8de0f9ffc4030a6b4938c43ec70))
+- add audio channel filter and fix unknown filtering not working in some cases ([df546d3](https://github.com/Viren070/AIOStreams/commit/df546d3a0c9ca39e772a64980a6aa582a4e9c81a))
+- add built-in torrentio format ([6fa1b2b](https://github.com/Viren070/AIOStreams/commit/6fa1b2b0c0cb45e9344163989009238d528d330b))
+- add configurable URL modifications for Stremthru Store and Torz ([3ce9dd0](https://github.com/Viren070/AIOStreams/commit/3ce9dd0ff5e5b7e9298bef87b3c5abe12c96afc9))
+- add delete icon to preferred list, only load valid values, fix password requirement check for new logins, fix spellings and add types ([d845c0c](https://github.com/Viren070/AIOStreams/commit/d845c0ce8bfb040c800355e97ea552758ad3c719))
+- add doctor who universe ([048c612](https://github.com/Viren070/AIOStreams/commit/048c612896723acffe908459c381dd1ee6f63784))
+- add donation modal button at top of about menu ([0170267](https://github.com/Viren070/AIOStreams/commit/01702671d59d7b924f4693e30b4f8fb1efaeaa15))
+- add external download streams option ([952a050](https://github.com/Viren070/AIOStreams/commit/952a05057cfbd9446f19ea4e7c71e26ae8acee89)), closes [#191](https://github.com/Viren070/AIOStreams/issues/191)
+- add folder size, add smart detect deduplicator, parse folder size for mediafusion, improve size parsing ([52fb3bb](https://github.com/Viren070/AIOStreams/commit/52fb3bb41c9b59433e00695c61fd643724c1bff4))
+- add health check to dockerfile ([8c68051](https://github.com/Viren070/AIOStreams/commit/8c680511edb2c5936bebdab5931bd32a968bcc9e))
+- add infohash extractor in base stream parser ([4b1f45d](https://github.com/Viren070/AIOStreams/commit/4b1f45da3a8c3eff9b9a2d675332267cbedf6722))
+- add keepOpenOnSelect prop to Combobox for customizable popover behavior and set it to true by default ([f32a1a1](https://github.com/Viren070/AIOStreams/commit/f32a1a1002937023cb50a9b5d230950f9981aaba))
+- add link to wiki in groups and link to predefined formatter definitions ([7f4405e](https://github.com/Viren070/AIOStreams/commit/7f4405e3574cdd230cc2112125163408738d2685))
+- add more addons and fix stuff ([51f6bd6](https://github.com/Viren070/AIOStreams/commit/51f6bd606c1d4db184b7e9c497f8e63aaf3c03cc))
+- add nuviostreams and anime kitsu ([34ed384](https://github.com/Viren070/AIOStreams/commit/34ed3846da218065ad89f840e739ec541109158a))
+- add opensubtitles v3 ([b4f6927](https://github.com/Viren070/AIOStreams/commit/b4f69273a4de6572dafcd5b121910048da3cb3aa))
+- add P2P option and enhance service handling in StremthruTorzPreset ([6390995](https://github.com/Viren070/AIOStreams/commit/6390995eebbd96ab524c3980b103500ecc8300ad))
+- add predefined format definitions for torbox, gdrive, and light gdrive ([e3294eb](https://github.com/Viren070/AIOStreams/commit/e3294eb7e9403e457d622e848bbf81534e92c9e6))
+- add public ip option and load forced/default value to proxy menu ([3c2c59e](https://github.com/Viren070/AIOStreams/commit/3c2c59e676144dba70ba9c3675f3767eab4991ea))
+- add regex functions to condition parser ([731c1d0](https://github.com/Viren070/AIOStreams/commit/731c1d002cb2fa2bce79f7b20df27f4e6e726e2b))
+- add season/episode matching ([4cd6522](https://github.com/Viren070/AIOStreams/commit/4cd6522417bb15eb37d23a39b6556ff8aa41838e))
+- add seeders filters ([653b306](https://github.com/Viren070/AIOStreams/commit/653b30632154c31c1036b76bc84e013253539a47))
+- add sensible built-in limits and configurable limits, remove unused variables from Env ([37259d9](https://github.com/Viren070/AIOStreams/commit/37259d90f133e57571a896929aa9c023027fad6e))
+- add shuffle persistence setting and improve shuffling ([e6286bc](https://github.com/Viren070/AIOStreams/commit/e6286bcf9bdbf509722e68879803485cc7926c62))
+- add size filters, allowing resolution specific limit ([fcec2b9](https://github.com/Viren070/AIOStreams/commit/fcec2b9ed850a852c4254306421c91b82c8a6c54))
+- add social options to various presets ([ea02be9](https://github.com/Viren070/AIOStreams/commit/ea02be99a714e03687b603848f4157e1150aa817))
+- add source addon name to catalog and improve ui/ux ([878cd7c](https://github.com/Viren070/AIOStreams/commit/878cd7c71fd648072dc9ec2c8de53428eb79a93c))
+- add stream passthrough option, orion, jackettio, dmm cast, marvel, peerflix, ([0383671](https://github.com/Viren070/AIOStreams/commit/038367126eb4e9fa327101163a12b4ef6dc9b7e6))
+- add stream type exclusions for cached and uncached results ([18e034f](https://github.com/Viren070/AIOStreams/commit/18e034f7bfb092c053405244a6f972aff44cf1d1))
+- add StreamFusion ([8b34be3](https://github.com/Viren070/AIOStreams/commit/8b34be3845a86bddf0b95d9aab43607cf9223a92))
+- add streaming catalogs ([4ce36f1](https://github.com/Viren070/AIOStreams/commit/4ce36f1ba0a8b3149cb9823b7499d625e0e285dd))
+- add strict title matching ([c4991c6](https://github.com/Viren070/AIOStreams/commit/c4991c678db0333587e57a632e68f26a650ea24a))
+- add support for converting ISO 639_2 to languages and prevent languages being detected as indexer in Easynews++ ([938323f](https://github.com/Viren070/AIOStreams/commit/938323f1dd5a4a333275c506afa1c85a8c9af361))
+- add support for includes modifier for array ([90432ae](https://github.com/Viren070/AIOStreams/commit/90432ae9c8b93b7bc1ba4a7a677f7a576b946cd7))
+- add webstreamr, improve parsing of nuviostream results, validate tmdb access token, always check for languages ([dc50c6c](https://github.com/Viren070/AIOStreams/commit/dc50c6c70b94df7cc0124bbc8b2f96df01011b38))
+- adjust addons menu ([6d0a088](https://github.com/Viren070/AIOStreams/commit/6d0a088c395aacb7123a66c12d01df1547733f37))
+- adjust default user data ([dea5950](https://github.com/Viren070/AIOStreams/commit/dea595055a1cb5ce07f26b64faa209bbaa71dd7a))
+- adjust handling of meta requests by trying multiple supported addons until one succeeds ([9fab116](https://github.com/Viren070/AIOStreams/commit/9fab1162c004fa7c5f4b73b522527ec0ed142b8a))
+- adjustments and proxy menu ([0c5479c](https://github.com/Viren070/AIOStreams/commit/0c5479c12997dc755b34897a4ed1814c2140dacb))
+- allow editing catalog type ([d99a29f](https://github.com/Viren070/AIOStreams/commit/d99a29fd6e97b010d41047d61522ce49a7084ade))
+- allow passing flags through ([bec91a8](https://github.com/Viren070/AIOStreams/commit/bec91a8a5835b340003381d99ebd5b02596dca4b))
+- cache RPDB API Key validation ([63622e0](https://github.com/Viren070/AIOStreams/commit/63622e0a07c64b45a228a1f3f653449744ec96e4))
+- changes ([e8c61a9](https://github.com/Viren070/AIOStreams/commit/e8c61a986066e1bdd06f00c5e3a4ff215ae5f968))
+- changes ([13a20a7](https://github.com/Viren070/AIOStreams/commit/13a20a7b610da0f41b40ccaf454a31805b445e9e))
+- clean up env vars and add rate limit to catalog api ([20fc37c](https://github.com/Viren070/AIOStreams/commit/20fc37cc123bacf729c57ae0718d6e85d02d4bb9))
+- **conditions:** add support for multiple groupings, and add type constant ([2a525b2](https://github.com/Viren070/AIOStreams/commit/2a525b292ef98a8e5a6697f967474714d0ceec23))
+- enhance language detection in MediaFusionStreamParser to parse languages from stream descriptions ([50db0e2](https://github.com/Viren070/AIOStreams/commit/50db0e2714f5f040660f47efa3012b41ae8da55d))
+- enhance stream parsing to prefer folder titles when available ([4001fae](https://github.com/Viren070/AIOStreams/commit/4001faede127a5712c3112ea334726bd18717c7d))
+- enhance strict title matching with configuration options for request types and addons ([3378851](https://github.com/Viren070/AIOStreams/commit/3378851ff8048216529a9d1a6715d3b9d1439d39))
+- enhance title matching by adding year matching option and updating metadata handling ([62752ef](https://github.com/Viren070/AIOStreams/commit/62752ef98c75741e59e70a08ce811b1e032dc8a9))
+- expand cache system and add rate limiting to all routes, attempt to block recursive requests ([c9356db](https://github.com/Viren070/AIOStreams/commit/c9356db83ab311261c001702ea5a31193a4b0432))
+- filter out invalid items in wrapper repsponses, rather than failing whole request. add message parsing for torbox ([da7dc3a](https://github.com/Viren070/AIOStreams/commit/da7dc3a935d29ec66c9c7509313268c16c3e4f1a))
+- fix condition parsing for unknown values and separate cached into cached and uncached function for simplicity ([3d26421](https://github.com/Viren070/AIOStreams/commit/3d26421b6878cf21edd6c648f5b61f125bf6cb4d))
+- **frontend:** add customization options for addon name and logo in AboutMenu ([47cc8f6](https://github.com/Viren070/AIOStreams/commit/47cc8f6dd6287d214ba34b0413fee784adbc52a7))
+- **frontend:** add descriptions to addons and catalog cards ([98c5b71](https://github.com/Viren070/AIOStreams/commit/98c5b71f1e364dc2eb9d97448c2cf5d2bf42b12a))
+- **frontend:** add shuffle indicator to catalog item ([edd1e4f](https://github.com/Viren070/AIOStreams/commit/edd1e4f8093a9cbb24278f4470d05ff6732acd15))
+- **frontend:** add tooltip for full service name in service tags for addon card ([5b8ec4d](https://github.com/Viren070/AIOStreams/commit/5b8ec4d9e75822d3ec39e55d5ae503d5f7c5a51f))
+- **frontend:** add valid formatter snippets and add valid descriptions for proxy services ([12b3f42](https://github.com/Viren070/AIOStreams/commit/12b3f423c0fd1706b9014996978e737d246fcac1))
+- **frontend:** enhance nightly version display with clickable commit link ([84d53cb](https://github.com/Viren070/AIOStreams/commit/84d53cbdcf835d797312245dc9377da71b0b54d7))
+- **frontend:** hide menu control button text on smaller screens ([2361e5c](https://github.com/Viren070/AIOStreams/commit/2361e5c373253db928027c2da0ca0eaa54f35579))
+- **frontend:** improve addons menu, preserve existing catalog settings ([2c5c642](https://github.com/Viren070/AIOStreams/commit/2c5c642b022601e3a41ed74934bd29538eec9d71))
+- **frontend:** improve services page ([384bdc3](https://github.com/Viren070/AIOStreams/commit/384bdc3a52d67bc85b33f2338b0076d7bd165fc1))
+- **frontend:** make catalog card title consistent with other cards ([5197331](https://github.com/Viren070/AIOStreams/commit/5197331a79093065f8de326f76bfb2add9c0050a))
+- **frontend:** services page, parse markdown, toast when duplicate addon ([3bc2538](https://github.com/Viren070/AIOStreams/commit/3bc25387f521792d5a2455a600d459176767497e))
+- **frontend:** update addon item layout for improved readability ([589e639](https://github.com/Viren070/AIOStreams/commit/589e639870fe9618dcee6e7e221750b1d8a9e17c))
+- **frontend:** use NumberInput component ([77edb07](https://github.com/Viren070/AIOStreams/commit/77edb07831ac6c4daf628e044fd369534fb58fcc))
+- **frontend:** use queue and default regex matched to undefined ([2c97ec0](https://github.com/Viren070/AIOStreams/commit/2c97ec04cde252ffdeafac25ecbe5c02148b4385))
+- identify casted streams from DMM cast as library streams and include full message ([6fd5f5b](https://github.com/Viren070/AIOStreams/commit/6fd5f5b9c03e46667255c9949b3c98b176724ebd))
+- implement advanced stream filtering with excluded conditions ([302b4cb](https://github.com/Viren070/AIOStreams/commit/302b4cb5c99fe00f21b5b775ef2187f4088717a9)), closes [#57](https://github.com/Viren070/AIOStreams/issues/57)
+- implement cache statistics logging and configurable interval ([8594ca0](https://github.com/Viren070/AIOStreams/commit/8594ca0374be534cb89dbbee427805202cc08ce6))
+- implement config validation and addon error handling ([f7b14cd](https://github.com/Viren070/AIOStreams/commit/f7b14cd1dbe54d714fe41881ff9993107746b895))
+- implement detailed statistics tracking and reporting for stream deduplication process ([89eac41](https://github.com/Viren070/AIOStreams/commit/89eac415a422189d80a3c3c66cde26762bd7f437))
+- implement disjoint set union (DSU) for stream deduplication, ensuring multiple detection methods are handled correctly ([b0cc718](https://github.com/Viren070/AIOStreams/commit/b0cc718a094f22b4c0cec870e5b06e2ec9e1e7e9))
+- implement import functionality via modal for JSON files and URLs in TextInputs component ([32b5a5b](https://github.com/Viren070/AIOStreams/commit/32b5a5b7bdfc9b2b27e15eddf060555e6b9c0596))
+- implement MAX_ADDONS and fix error returning ([ae74926](https://github.com/Viren070/AIOStreams/commit/ae74926ce2e04710771a7166e946f87166985188))
+- implement pre-caching of the next episode ([980682c](https://github.com/Viren070/AIOStreams/commit/980682cd28e40f84caf1c8f1072fd79ec49ac62b))
+- implement timeout constraints in preset options using MAX_TIMEOUT and MIN_TIMEOUT ([e415a70](https://github.com/Viren070/AIOStreams/commit/e415a70485fdd33bf5d9b1379d3ede633ea60475))
+- implement user pruning functionality with configurable intervals and maximum inactivity days ([0bf6fcb](https://github.com/Viren070/AIOStreams/commit/0bf6fcbe9c484c4df6582d76d3bd8fd10567f34b))
+- improve config handling, define all skip reasons, add env vars to disable addons/hosts/services, ([a301002](https://github.com/Viren070/AIOStreams/commit/a301002ba49fce87e40a28a650e411e5078f769b))
+- improve formatting of zod errors when using unions ([9c2a970](https://github.com/Viren070/AIOStreams/commit/9c2a970c7d612c9432db70a011663f3f241072ca))
+- improve French language regex to include common indicators ([163352a](https://github.com/Viren070/AIOStreams/commit/163352a1909faf4e4b45b56222ba08afa023fd7e))
+- improve handling of unsupport meta id and type ([3779ea0](https://github.com/Viren070/AIOStreams/commit/3779ea09d392ffb3f14b7efcba989ec7cc44bf89))
+- improve preset/parser system and add mediafusion, comet, stremthru torz, torbox, debridio, en, en+, en+ ([b70a763](https://github.com/Viren070/AIOStreams/commit/b70a763e8b6dc9cfbaf865c8526dd078e1965cb8))
+- include preset id in formatter ([6053855](https://github.com/Viren070/AIOStreams/commit/6053855f9a3dc5b32bcd8296161ef8ac6df18df8))
+- make `BASE_URL` required and disable self scraping by default ([d572c04](https://github.com/Viren070/AIOStreams/commit/d572c047e9da4d3cf5be645fd2125b3781b80898))
+- make caching more configurable and add to sample .env ([1e65fd9](https://github.com/Viren070/AIOStreams/commit/1e65fd9e7dddfe3a0bb9bcf07d77d03fbadf846a))
+- match years for series too, but don't filter out episode results without a year ([8394f09](https://github.com/Viren070/AIOStreams/commit/8394f0969da665b31074c8e6b9fc15bf9e731b2a))
+- move 'custom' preset to the beginning ([0b85ff3](https://github.com/Viren070/AIOStreams/commit/0b85ff35e7eba5f62579e117621b212122fd8eca))
+- **parser:** add support for additional video quality resolutions (144p, 180p, 240p, 360p, 576p) in regex parser ([59d86ff](https://github.com/Viren070/AIOStreams/commit/59d86ffcbfe4d576c49903cdeb8adf197b811963))
+- prefer results with higher seeders when deduping ([aed775c](https://github.com/Viren070/AIOStreams/commit/aed775c6d5a2b983dc04adbd15b7409a8b11a3a0))
+- proxy fixes and log adjustments ([091394b](https://github.com/Viren070/AIOStreams/commit/091394b837565f59815bb968dea13fdc356b6160))
+- remove duplicated info from download streams ([4901745](https://github.com/Viren070/AIOStreams/commit/49017450b9958eabc5a04a098401f2a2561a8e26))
+- remove useMultipleInstances and debridDownloader options for simplicity and force multiple instances. ([8c0622e](https://github.com/Viren070/AIOStreams/commit/8c0622ea984082dc8c8f678c12d8c962967a70c1))
+- rename API Key to Addon Password and update related help text in save-install component ([b63813c](https://github.com/Viren070/AIOStreams/commit/b63813c29db53b5a3fbf83c6c042ee10fdda739d))
+- rename cache to cached in condition parser ([db68a5c](https://github.com/Viren070/AIOStreams/commit/db68a5c0266a5aa05068c4bcbc0c0f0532cd6097))
+- replace custom HTML div with SettingsCard component for consistent styling ([8611523](https://github.com/Viren070/AIOStreams/commit/86115230bfd5958374294896adc59c83f28d3fee))
+- revert 89eac415a422189d80a3c3c66cde26762bd7f437 ([34b57c9](https://github.com/Viren070/AIOStreams/commit/34b57c9883901722736cb5d52e0911f6434ddfe3))
+- service cred env vars, better validation, handling of encrypted values ([61e21cd](https://github.com/Viren070/AIOStreams/commit/61e21cd803981899b4e445c5058fb546db79096d))
+- start ([3517218](https://github.com/Viren070/AIOStreams/commit/35172188081b688011031439ec26b11e428dd02d))
+- stuff ([0c9c86c](https://github.com/Viren070/AIOStreams/commit/0c9c86c218c5754e62ff94c0d26d398f32da92a1))
+- switch to different arrow icons and use built-in hideTextOnSmallScreen prop ([8d307a0](https://github.com/Viren070/AIOStreams/commit/8d307a0c2f755b16074e1a7262204e635853ddfd))
+- ui improvements ([7e031e5](https://github.com/Viren070/AIOStreams/commit/7e031e51b12cd1fa09e1ed70b90467e8a6bd956e))
+- ui improvements, check for anime type using kitsu id, loosen schema definitions ([9668a15](https://github.com/Viren070/AIOStreams/commit/9668a152fd116ed9fa9657e935b3b0ed711ce06d))
+- ui improvments ([39b1e84](https://github.com/Viren070/AIOStreams/commit/39b1e84d87ea4422ebbdab2495d242aeee231562))
+- update About component with new guide URLs and enhance Getting Started section ([5232e38](https://github.com/Viren070/AIOStreams/commit/5232e3847b4aeb812c44ad0e153b95189ceda607))
+- update static file serving rate limiting and refactor file path handling ([010b63c](https://github.com/Viren070/AIOStreams/commit/010b63c8725bfb3968c6678b2615675b393fb449))
+- update TMDB access token input to password type with placeholder ([2378869](https://github.com/Viren070/AIOStreams/commit/23788695e2cedad3a1491c78f17f7e900aa77aeb))
+- use `API_KEY` as fallback for `ADDON_PASSWORD` to maintain backwards compatability ([5424490](https://github.com/Viren070/AIOStreams/commit/5424490a284aa74e98071a36f3848706f81f5033))
+- use button for log in/out ([62911ad](https://github.com/Viren070/AIOStreams/commit/62911adfacde25c9f9e7b3551c277c4a7a6340db))
+- use shorter function names in condition parser ([3bd2751](https://github.com/Viren070/AIOStreams/commit/3bd27519fdfa8cbf9435a48b49f3aeb2992aae42))
+- use sliders for seeder ranges and fix some options not being multi-option ([915187a](https://github.com/Viren070/AIOStreams/commit/915187a6120dff969dcfe9d4bf9e473673f8ebf0))
+- validate regexes on config validation ([dd0f45c](https://github.com/Viren070/AIOStreams/commit/dd0f45c731938c37575fb376a981d3c0d2c7a45a))
+
+### Bug Fixes
+
+- (mediafusion) increase max streams per resolution limit to 500 ([322b4f3](https://github.com/Viren070/AIOStreams/commit/322b4f375ebbd1047f3e457cf48d75ac9b610d15))
+- adapt queries for PostgreSQL and SQLite ([e2834d5](https://github.com/Viren070/AIOStreams/commit/e2834d571c709cc9ca3db541da6c1374fb201490))
+- adapt query for SQLite dialect in DB class ([a7bb898](https://github.com/Viren070/AIOStreams/commit/a7bb8983de03d5f1fb044636133c6f01aaeebf1f))
+- add back library marker to LightGDriveFormatter ([871f54e](https://github.com/Viren070/AIOStreams/commit/871f54e896a4315f197e6a15b779d4b2a957e8a4))
+- add back logo.png to v1 path for backwards compatability ([ce5a5b9](https://github.com/Viren070/AIOStreams/commit/ce5a5b99059cd2902d60c9e865503d995ed46df9))
+- add back y flag ([0e0a18b](https://github.com/Viren070/AIOStreams/commit/0e0a18b9c1f7e65f84af762aab785aa7a79e1222))
+- add block scope for array modifier handling in BaseFormatter ([02a2885](https://github.com/Viren070/AIOStreams/commit/02a2885d33dfbe355203d4f561408eb82355d939))
+- add description for stremthru torz ([6e7c142](https://github.com/Viren070/AIOStreams/commit/6e7c14224e5fe90d56dbda7f6ac91d5b87091444))
+- add extras to cache key for catalog shuffling ([1cdfc6e](https://github.com/Viren070/AIOStreams/commit/1cdfc6e0e3a44f983ac43f1c210257c63c0a78a9))
+- add France option to DebridioTvPreset language selection ([bd19d01](https://github.com/Viren070/AIOStreams/commit/bd19d01b5434070384ac69278fbc8e21a65bafe9))
+- add missing audio tags to constant ([fda5ffe](https://github.com/Viren070/AIOStreams/commit/fda5ffe2062f1e6953380c4904c174b81b3b07ef))
+- add missing braces in parseConnectionURI function for sqlite and postgres cases ([807b681](https://github.com/Viren070/AIOStreams/commit/807b6810ea2b29900408a96e15f934d49b4407d9))
+- add timeout to fetch requests in TMDBMetadata class to prevent hanging requests ([1a0d57a](https://github.com/Viren070/AIOStreams/commit/1a0d57af43efd68d41a623e2a81b23cb217011da))
+- add validation for encrypted data format in decryptString function ([843b535](https://github.com/Viren070/AIOStreams/commit/843b535d7ca47c362e254669d0a3f149abe9ffc2))
+- add verbose logging for resources and fix addon catalog support ([4daa644](https://github.com/Viren070/AIOStreams/commit/4daa6441eede8aa630108c21f8760fa7c19a3745))
+- adjust cache stat logging behaviour ([d921070](https://github.com/Viren070/AIOStreams/commit/d921070192a4e07e3702b521a7b3819f42da3529))
+- adjust default rate limit values ([aa98e7b](https://github.com/Viren070/AIOStreams/commit/aa98e7b491a1f7ab9360af8d69490c39bbfd8268))
+- adjust grid layout in AddonFilterPopover ([632fbf9](https://github.com/Viren070/AIOStreams/commit/632fbf9206dcf5d9532557ca69df42683b5f7ffd))
+- adjust grouping in season presence check logic ([d89e796](https://github.com/Viren070/AIOStreams/commit/d89e796cb07e534691401e307d28fc89f4176dad))
+- adjust option name to keep backwards compatability with older configs ([eb651b5](https://github.com/Viren070/AIOStreams/commit/eb651b517db2bf8b91e3c60488f5336049a6bb69))
+- adjust spacing in predefined formatters and add p2p marker to torbox format ([d8f5d1a](https://github.com/Viren070/AIOStreams/commit/d8f5d1a2d152d2930c0cb03c533748f81f742869))
+- allow empty strings for formatter definitions ([dba54f5](https://github.com/Viren070/AIOStreams/commit/dba54f5c426e8b0391d3f2b2979b473574968036))
+- allow null for released in MetaVideoSchema ([ca8d744](https://github.com/Viren070/AIOStreams/commit/ca8d74448ac2479c948a1cc8509cee8a76db0042))
+- allow null value for description in MetaPreview ([0f16575](https://github.com/Viren070/AIOStreams/commit/0f165752db011c5d525c59bb915edda43afea718))
+- allow null value in MetaVideoSchema ([73b4d0b](https://github.com/Viren070/AIOStreams/commit/73b4d0b99fc587f7f82515553d92bf7c69647157))
+- always apply seeder ranges, defaulting seeders to 0 ([0f5dd76](https://github.com/Viren070/AIOStreams/commit/0f5dd764d9577944c587a75423db5256942b583b))
+- apply negativity to all addon and encode sorting ([411ae7c](https://github.com/Viren070/AIOStreams/commit/411ae7cee234ec8fefe08bf3d844d4711dc37645))
+- assign unique IDs to each stream to allow consistent comparison ([673ecb2](https://github.com/Viren070/AIOStreams/commit/673ecb2133d3dc5435db7be23cf116b2a6ad34c3))
+- await precomputation of sort regexes ([56994ef](https://github.com/Viren070/AIOStreams/commit/56994ef9e83248d49e890af99181943c7715d9bb))
+- call await on all compileRegex calls ([8e87004](https://github.com/Viren070/AIOStreams/commit/8e87004a07a8b5612356f5d346b4b1140a866b64))
+- carry out regex check for new users too ([1555199](https://github.com/Viren070/AIOStreams/commit/155519951bd5422da9d9fc112e1eca89c4d1fb51))
+- change image class from object-cover to object-contain in AddonCard component ([734bd88](https://github.com/Viren070/AIOStreams/commit/734bd88d34ba84267934862117a846c8c246e96e))
+- check if title matching is enabled before attempting to fetch titles ([fd03112](https://github.com/Viren070/AIOStreams/commit/fd03112288bdf00504a6e614993a50170bd7fb43))
+- coerce runtime to string type in MetaSchema for improved validation ([cc6eea7](https://github.com/Viren070/AIOStreams/commit/cc6eea7e52cc7604806f04459439c7256e1b5aee))
+- coerce year field to string type in ParsedFileSchema for consistent data handling ([10bef68](https://github.com/Viren070/AIOStreams/commit/10bef68c3625b855a473406dbd9bc4e852fe3cb2))
+- **comet:** don't make service required for comet ([826edae](https://github.com/Viren070/AIOStreams/commit/826edae8030627bb94591a07c6343ee64e0108f9))
+- **constants:** add back Dual Audio, Dubbed, and Multi ([7c10930](https://github.com/Viren070/AIOStreams/commit/7c109304ffdf035532514284c021171e91c0fe93))
+- **core:** actually apply exclude uncached/cached filters ([413a29d](https://github.com/Viren070/AIOStreams/commit/413a29d2d85b50b62042c26f9bed665c7822d11d))
+- correct handling of year matching and improved normalisation ([bd53adc](https://github.com/Viren070/AIOStreams/commit/bd53adc8f7538243caf121c9b3583cd257dc9181))
+- correct library marker usage in LightGDriveFormatter ([2470ae9](https://github.com/Viren070/AIOStreams/commit/2470ae94ec2f52f869e3c2edf904500095502b27))
+- correct spelling of 'committed' in UserRepository class ([551335b](https://github.com/Viren070/AIOStreams/commit/551335bcbaef570a6c6b81d023c1985f6fd19cd2))
+- correctly handle negate flag ([a65ef19](https://github.com/Viren070/AIOStreams/commit/a65ef19f555d34103cd68e8c021707a61e54cdde))
+- correctly handle overriden URLs for mediafusion ([46e7e67](https://github.com/Viren070/AIOStreams/commit/46e7e6748e461ec77575efb5ebec4dc7ee50eba7))
+- correctly handle required filters and remove HDR+DV as a tag after filtering/sorting ([113c150](https://github.com/Viren070/AIOStreams/commit/113c150e143b65eeea5dc2e5e1d74df6c096b8be))
+- correctly handle undefined parsed file ([8b85a53](https://github.com/Viren070/AIOStreams/commit/8b85a5332d2b33fb6d79139fb6e771d6446b7957))
+- correctly handle usenet results during deduping ([153366b](https://github.com/Viren070/AIOStreams/commit/153366b41a6b8a08cff8a4cd29ab10dfc1c7d3ac))
+- correctly import/export FeatureControl ([654b1bc](https://github.com/Viren070/AIOStreams/commit/654b1bc0585d3403836159ac2efde495f4cd44d4))
+- **custom:** replace 'stremio://' with 'https://' in manifest URL ([0a4a761](https://github.com/Viren070/AIOStreams/commit/0a4a76187d78e924222512f1ca971292463270b7))
+- **custom:** update manifest URL option to use 'manifestUrl' ([6370ac7](https://github.com/Viren070/AIOStreams/commit/6370ac7d00a75bd626cad67fa448dcaaa9b0a6ba))
+- decode data before attempting validation ([bdf9a91](https://github.com/Viren070/AIOStreams/commit/bdf9a9198f06e550e0fb3681936e6bfacf483731))
+- decrypt values for catalog fetching ([6cf8436](https://github.com/Viren070/AIOStreams/commit/6cf843666f97dedc247e52cf6946842d66c50229))
+- default seeders to 0 for included seeder range ([b0aea2d](https://github.com/Viren070/AIOStreams/commit/b0aea2ddec56da2428f515615251712313138cec))
+- default seeders to 0 in condition parser too ([53123a3](https://github.com/Viren070/AIOStreams/commit/53123a314c45d39c9d482e5105f47de712fcc7fc))
+- default value to mediaflow if neither forced or proxy is defined and remove fallback from select value ([61781b7](https://github.com/Viren070/AIOStreams/commit/61781b7e0650713777c7475416e1fc8b837c13fa))
+- default version to 0.0.0 when not defined ([f031f1a](https://github.com/Viren070/AIOStreams/commit/f031f1a50eabad7d122021ce9b6556694c49af76))
+- don't fail on invalid external api keys when skip errors is true ([c2db243](https://github.com/Viren070/AIOStreams/commit/c2db243b5798032b75843faf7254969d63ff14b6))
+- don't make base_url required ([3d7b0da](https://github.com/Viren070/AIOStreams/commit/3d7b0da93fb1add0c6f1d4523411fc0e9512a2b9))
+- don't make name required in MetaPreview schema ([062247a](https://github.com/Viren070/AIOStreams/commit/062247a89a38d3fad1129a8965a92b6245d5e08e))
+- don't pass idPrefixes in manifest response ([35ceb87](https://github.com/Viren070/AIOStreams/commit/35ceb87ff325960fc035db735ac8009ab636e09d))
+- don't validate user data on retrieval within UserRepository ([17873bb](https://github.com/Viren070/AIOStreams/commit/17873bb476d280e6f533cd7cabf8bb8e3e91d518))
+- enable passthrough on all stremio response schemas ([377d215](https://github.com/Viren070/AIOStreams/commit/377d215c0f5801ff93ec1b0065d0c64ce1fd8217))
+- encrypt forced proxy URL and credentials before assignment ([e741de3](https://github.com/Viren070/AIOStreams/commit/e741de378775baecd00ee9a8838f3f9fc6ca2bb1))
+- enhance Japanese language regex to include 'jpn' as an abbreviation ([7a02f12](https://github.com/Viren070/AIOStreams/commit/7a02f12818f64971971bc49b3ec80de594c4a1fe))
+- ensure debridDownloader defaults to an empty string when no serviceIds are present in StreamFusionPreset ([886a8cb](https://github.com/Viren070/AIOStreams/commit/886a8cb98190fb0e6b4b3d2358103485c9cc6f47))
+- ensure early return on error handling in catalog route ([6cc20e1](https://github.com/Viren070/AIOStreams/commit/6cc20e124dfe751051f61a700eb4765e8083310e))
+- ensure tmdb access token, rpdb api key, and password options are filtered out when exclude credentials is on ([299a6d5](https://github.com/Viren070/AIOStreams/commit/299a6d578cef763528095cb80b2337c44d1994e0))
+- ensure transaction rollback only occurs if not committed in deleteUser method ([67b188e](https://github.com/Viren070/AIOStreams/commit/67b188e7d76b6d0a424f5b86360c2b8a20ddc3b9))
+- ensure uniqueness of preset instanceIds and disallow dots in instanceId ([3a9be38](https://github.com/Viren070/AIOStreams/commit/3a9be38c77bb7a1b4b991c46902241a6e265b327))
+- export formatZodError ([af90131](https://github.com/Viren070/AIOStreams/commit/af90131787616a091373e69bf6f8de67e06f1e78))
+- fallback to undefined when both default and forced value are undefined for proxy id ([efb57bf](https://github.com/Viren070/AIOStreams/commit/efb57bfc3e1a2819712e54c03aee78f967427837))
+- **formatters:** add message to light gdrive and remove unecessary spacing ([5cb1b0a](https://github.com/Viren070/AIOStreams/commit/5cb1b0a21ed6b29dccf1a56e59434c28da39d1be))
+- **frontend:** encode password when loading config ([e8971df](https://github.com/Viren070/AIOStreams/commit/e8971df66d8ed79dec7d93bbc790c3de13f54a01))
+- **frontend:** load existing overriden type in newType ([caeb282](https://github.com/Viren070/AIOStreams/commit/caeb282438edfa8c731b32775840cc5f71c3ec36))
+- **frontend:** pass seeder info through to formatter ([2ec06a6](https://github.com/Viren070/AIOStreams/commit/2ec06a6f9905c7e1f9c32cc0a5ef56e96872933b))
+- **frontend:** set default presetInstanceId to 'custom' to pass length check ([ec7a19a](https://github.com/Viren070/AIOStreams/commit/ec7a19a92d2ffc2b06046ab0176f02a4f5b2014e))
+- **frontend:** try and make dnd better on touchscreen devices ([6aa1130](https://github.com/Viren070/AIOStreams/commit/6aa11301a5dc06eb8674cfb6a834bf181a41eeee))
+- **frontend:** update filter options to use textValue to correctly show addon name when selected ([6a87480](https://github.com/Viren070/AIOStreams/commit/6a874806b893dbd6382082563f2c45c274e2650b))
+- give more descriptive errors when no service is provded ([c0b6fd3](https://github.com/Viren070/AIOStreams/commit/c0b6fd3e7dac933b7fd0f10d999a48850c70244e))
+- handle when drag ends outside drag context ([7a8655d](https://github.com/Viren070/AIOStreams/commit/7a8655dd4326821f2445b1055a819a87a2c3270b))
+- handle when item doesn't exist in preferred list ([d728bb6](https://github.com/Viren070/AIOStreams/commit/d728bb67bdd872b2d812e3fa0ce1e5352860dff4))
+- ignore language flags in Torrentio streams if Multi Subs is present ([6d08d7c](https://github.com/Viren070/AIOStreams/commit/6d08d7c0336366c185ad43a89657cbe94dc30278))
+- ignore recursion checks for certain requests ([d266026](https://github.com/Viren070/AIOStreams/commit/d26602631e030f59ef0f0098633b7f4909db87bc))
+- improve error handling in TMDBMetadata by including response status and status text ([2f37187](https://github.com/Viren070/AIOStreams/commit/2f371876c151a9b4b0b7db3a4cf1fa14868d4db6))
+- improve filename sanitization in StreamParser by using Emoji_Presentation to keep numbers and removing identifiers ([714fedb](https://github.com/Viren070/AIOStreams/commit/714fedb2c318a115836faa939c5f888c7785b34c))
+- include overrideType in catalog modification check ([db473f3](https://github.com/Viren070/AIOStreams/commit/db473f3a32788bb34ed9cede11a24be45979d040))
+- increase recursion threshold limit and window for improved request handling ([cc2acde](https://github.com/Viren070/AIOStreams/commit/cc2acdeb7ab7dcfdaadc767450065dc8df520f57))
+- log errors in more cases, correctly handle partial proxy configuration, correctly handle undefined value in tryDecrypt, only decrypt when defined ([56734f0](https://github.com/Viren070/AIOStreams/commit/56734f0956b38998ea802d23e312e0dda2379c88))
+- make adjustments to how internal addon IDs are determined and fix some things ([a6515de](https://github.com/Viren070/AIOStreams/commit/a6515de2718138cefdad5c4c53617a745ff044c5))
+- make behaviorHints optional in manifest schema ([313c6bc](https://github.com/Viren070/AIOStreams/commit/313c6bc14e119d62c65bd2cea61eca23af4f4463))
+- make keyword pattern case insensitive ([795adb3](https://github.com/Viren070/AIOStreams/commit/795adb3e2521a766c92889cc0701e1a8b0d68d96))
+- make object validation less strict for parsed streams ([e39e690](https://github.com/Viren070/AIOStreams/commit/e39e6900b452b565c6f4c6ed7de151eceb54d38d))
+- **mediaflow:** add api_password query param when getting public IP ([00e305f](https://github.com/Viren070/AIOStreams/commit/00e305f4f31d9c78741fb0d8d2585b8478d732ea))
+- **mediaflow:** include api_password in public IP endpoint URL only ([279ff00](https://github.com/Viren070/AIOStreams/commit/279ff003be87febed59ac6f8edb3f0d0d439659a))
+- **mediafusion:** correctly return encoded user data, and fix parsing ([c6a6350](https://github.com/Viren070/AIOStreams/commit/c6a63502b6049fd403816114547be42e5f44b305))
+- only add addons that support the type only when idPrefixes is undefined ([d7355cb](https://github.com/Viren070/AIOStreams/commit/d7355cb5983202d08c5d6f863cf5f2f742a6ad97))
+- only allow p2p on its own addon in StremThruTorzPreset ([510c086](https://github.com/Viren070/AIOStreams/commit/510c086ab0dfbedd089e06ec063837f9e465695f))
+- only carry out missing title check after checking addons and request types ([eff8d50](https://github.com/Viren070/AIOStreams/commit/eff8d50006d3814af7a4140b0ad9f599eea6bddc))
+- only exclude a file with excludedLanguages if all its languages are excluded ([2dfb718](https://github.com/Viren070/AIOStreams/commit/2dfb718fa1bca8ae188c5ff55b2f7b1bf7fbbb10))
+- only filter out resources using specified resources when length greater than 0 ([cd78ead](https://github.com/Viren070/AIOStreams/commit/cd78ead297b8641d4f45ca224d5455ec649ee429))
+- only use the movie/series specific cached/uncached sort criteria if defined ([049f65b](https://github.com/Viren070/AIOStreams/commit/049f65b18069a0b8c8b8ae7d34e5981cfa34244e))
+- override stream parser for torz to remove indexer ([f0a448b](https://github.com/Viren070/AIOStreams/commit/f0a448b489585e22af6bcfffbc3ff0a383e35085))
+- **parser:** match against stream.description and apply fallback logic to stream.title ([a1d2fc9](https://github.com/Viren070/AIOStreams/commit/a1d2fc9981c967254dcb91d1779310c2fd1f8fba))
+- **parser:** safely access parsedFile properties to handle potential undefined values ([e995f97](https://github.com/Viren070/AIOStreams/commit/e995f97e2f43063f7e69b179237279d5aaba51e8))
+- pass user provided TMDB access token to TMDBMetadata ([d2f4dc1](https://github.com/Viren070/AIOStreams/commit/d2f4dc1b8dbe17c17e80ac4698398af5a3757cc9))
+- potentially fix regex sorting ([9771c7b](https://github.com/Viren070/AIOStreams/commit/9771c7be7f8e19c25cebac4439c42a7ae6766459))
+- potentially fix sorting ([887d285](https://github.com/Viren070/AIOStreams/commit/887d2850f23e883734f2b56d4545e546c07a5694))
+- prefix addon instance ID to ensure uniquenes of stream id ([009d7d1](https://github.com/Viren070/AIOStreams/commit/009d7d1cf40a1e4041690d5c217b34003f7d51a2))
+- prevent fetching from aiostreams instance of the same user ([963a3f7](https://github.com/Viren070/AIOStreams/commit/963a3f7064abf0387d0ce49ffb7773659ea88577))
+- prevent mutating options object in OrionPreset ([f8b08b3](https://github.com/Viren070/AIOStreams/commit/f8b08b3093e49e50acd52aed439ed3e5c7a0674b))
+- prevent pushing errors for general type support to avoid blocking requests to other addons ([b390534](https://github.com/Viren070/AIOStreams/commit/b390534dae906235836c3fc4a43b3db27dee8324))
+- reduce timeout duration for resetting values in AddonModal to ensure new modals properly keep their initial values ([9213d78](https://github.com/Viren070/AIOStreams/commit/9213d781d176101f8e7826cc187e44188cf346c4))
+- refine year matching logic in title filtering for movies ([21f1d3e](https://github.com/Viren070/AIOStreams/commit/21f1d3e0210c84936d2c06b238ede488715d0165))
+- remove check of non-existent url option in OpenSubtitlesPreset ([dbd5dd6](https://github.com/Viren070/AIOStreams/commit/dbd5dd6bd73abf26ad4c408c17af653dae6ed949))
+- remove debug logging in getServiceCredentialDefault ([27932a5](https://github.com/Viren070/AIOStreams/commit/27932a54ff683faa01052e5cec1cf450ec5d8603))
+- remove emojis from filename ([b8bbb17](https://github.com/Viren070/AIOStreams/commit/b8bbb178a8c66eaad6fc5b1637492b1358f12645))
+- remove log pollution ([5b72292](https://github.com/Viren070/AIOStreams/commit/5b7229299e0f0dfd80a57ed4367a554574b8a9d8))
+- remove max connections limit from PostgreSQL pool configuration ([bff13dc](https://github.com/Viren070/AIOStreams/commit/bff13dc22c59bb358926867bceefceca1c36574d))
+- remove unecessary formatBytes function and display actual max size ([5c9406f](https://github.com/Viren070/AIOStreams/commit/5c9406f88e13e538e3683b82c8045899498ec185))
+- remove unnecessary UUID assignment in UserRepository class ([c8224bc](https://github.com/Viren070/AIOStreams/commit/c8224bc21e496686971e99176d48eb1c859d675e))
+- remove unused regex environment variables from status route ([2fd0522](https://github.com/Viren070/AIOStreams/commit/2fd05220a480bd70fca5d383d7477be6e7eb5fb2))
+- remove unused regex fields from StatusResponseSchema ([dfef789](https://github.com/Viren070/AIOStreams/commit/dfef7895b2ad0c2c0b879ad0ce7e1d4410431eeb))
+- replace crypto random UUID generation with a simple counter for unique ID assignment in StreamParser ([11b2204](https://github.com/Viren070/AIOStreams/commit/11b220443c67c22de475ab22d32ced033e083740))
+- replace hardcoded SUPPORTED_RESOURCES with supportedResources in NuvioStreamsPreset ([4eeeb59](https://github.com/Viren070/AIOStreams/commit/4eeeb59186668ad1b2d7975e21ea7b90b501bfa7))
+- replace incorrect hardcoded SUPPORTED_RESOURCES with supportedResources in DebridioPreset ([ed73f5d](https://github.com/Viren070/AIOStreams/commit/ed73f5de6c66ef408f513f54cafee8d2a22e6965))
+- restore TMDBMetadata import in main.ts and enable metadata export in index.ts ([2cd7d4d](https://github.com/Viren070/AIOStreams/commit/2cd7d4dfd1ada052dad8b21f79a2ffd24eafc178))
+- return original URL when no modifications are made in CometStreamParser ([cbfb4b7](https://github.com/Viren070/AIOStreams/commit/cbfb4b7838f5a91a401ce7f4d5b5c1a566b222ee))
+- return url when no modifications are needed in JackettioStreamParser ([4791f36](https://github.com/Viren070/AIOStreams/commit/4791f360da880758ab5d227d2ada8f27ad2f9c64))
+- **rpdbCatalogs:** correct spelling of 'movies' to 'movie' ([9e1960a](https://github.com/Viren070/AIOStreams/commit/9e1960a6ddd19e6ad705cab30539d6f2c2107321))
+- **rpdb:** improve id parsing logic and include type for tmdb ([18621ca](https://github.com/Viren070/AIOStreams/commit/18621ca646bb3765963849fd10e25866b253759d))
+- safely access catalogs options and default to false for streamfusion ([9c48fad](https://github.com/Viren070/AIOStreams/commit/9c48fad6a620e30730b9da9a8074daf016e24105))
+- save preferred values when adjusting from select menu ([2b329fe](https://github.com/Viren070/AIOStreams/commit/2b329fe6feabdcefcb4c4603a772ec8cf8791a0b))
+- set default sizeK value to 1024 in StreamParser and remove overridden method in TorrentioParser ([a09dcea](https://github.com/Viren070/AIOStreams/commit/a09dcead9bc6107b25dd8829c66d0b49d1dc49e8))
+- set public IP to undefined when empty ([32f90fb](https://github.com/Viren070/AIOStreams/commit/32f90fb0f3e5a067ba8f3486bfeb366387b28f01))
+- simplify and improve validation checks ([dde5af0](https://github.com/Viren070/AIOStreams/commit/dde5af02d9dab1634a2c7cd9e9346b4707011848))
+- simplify duration formatting in getTimeTakenSincePoint function ([f1afe5f](https://github.com/Viren070/AIOStreams/commit/f1afe5f5a26024b6fbc860abbba902da201996d7))
+- truncate addon name and update modal value states to handle changes in props ([14f56d1](https://github.com/Viren070/AIOStreams/commit/14f56d12479580033123bbbd312b5bc4ff67f4df))
+- update addon name formatting in AIOStreamsStreamParser to prefix aiostreams addon name ([eefa184](https://github.com/Viren070/AIOStreams/commit/eefa184b7c0e8e3a2f7779360da94254858f6e6f))
+- update AIOStream schema export and enhance AIOStreamsStreamParser with validation ([edc310f](https://github.com/Viren070/AIOStreams/commit/edc310fe5f213b4e03976aeb815fd51c81be7976))
+- update Bengali regex to not match ben the men ([90980c7](https://github.com/Viren070/AIOStreams/commit/90980c76363abdec3d1f53ad2b27eb4181bd8131))
+- update cached sorting to prefer all streams that are not explicitly marked as uncached ([b16f36d](https://github.com/Viren070/AIOStreams/commit/b16f36d4ea80d4a842281814239aaa23430c5c65))
+- update default apply mode for cached and uncached filters from 'and' to 'or' ([3fe5027](https://github.com/Viren070/AIOStreams/commit/3fe50274dcfdfaea68103f6477cbc30563327f65))
+- update default value for ADDON_PASSWORD and SECRET_KEY ([65a4c91](https://github.com/Viren070/AIOStreams/commit/65a4c9177cc8da04990c82fbde939fa4c5452637))
+- update Dockerfile to use default port fallback for healthcheck and expose ([0ffca95](https://github.com/Viren070/AIOStreams/commit/0ffca9560460a640b763c2a4cabdd3c4a420b6ca))
+- update duration state to use milliseconds and adjust input handling ([3d43673](https://github.com/Viren070/AIOStreams/commit/3d43673a66f695a1a7547d95a1ef36cd45d27864))
+- update error handling in OrionStreamParser to throw an error instead of returning an error stream for partial success ([bb30b4a](https://github.com/Viren070/AIOStreams/commit/bb30b4a19a66c6eb8c3b408e64eea33d927bd8ea))
+- update error message for missing addons to suggest reinstallation ([78a0d7f](https://github.com/Viren070/AIOStreams/commit/78a0d7f788aaa4ea10e2e69ccbd5d79c72bb17d1))
+- update formatter preview ([f3d84bc](https://github.com/Viren070/AIOStreams/commit/f3d84bc9778a345e837a698c68c2e28ea71752a4))
+- update GDriveFormatter to use 'inLibrary' instead of 'personal' ([f6ef47f](https://github.com/Viren070/AIOStreams/commit/f6ef47f3a8f7c781a084ffb3d5ba26615edf77fa))
+- update handling of default/forced values ([c60ef6f](https://github.com/Viren070/AIOStreams/commit/c60ef6fde9c0de6abc98f2cb2de2a7e981719f3e))
+- update help text to include selected proxy name rather than mediaflow only ([af24d67](https://github.com/Viren070/AIOStreams/commit/af24d674d1c265f9fe9a37f4528548b25790638e))
+- update MediaFlowProxy to conditionally include api_password in proxy URL for /proxy/ip endpoint ([d0faecc](https://github.com/Viren070/AIOStreams/commit/d0faecc563cd7d2c9ed52310ce658b13ee3fc076))
+- update MediaFusion logo URL ([3648f94](https://github.com/Viren070/AIOStreams/commit/3648f94d0acdebfde842818335f473fb4564d0e7))
+- update NameableRegex schema to allow empty name and remove useless regex check ([96d355f](https://github.com/Viren070/AIOStreams/commit/96d355ffdabeb4a308b0f99a9f9a198b8a7d8733))
+- update Peerflix logo URL ([ab1c216](https://github.com/Viren070/AIOStreams/commit/ab1c21695e596d8fb482f299d31bf44f51ba78fa))
+- update seeder condition in TorrentioFormatter to allow zero seeders ([c890671](https://github.com/Viren070/AIOStreams/commit/c890671a444f6d82e48d9fdce1308913779d7123))
+- update service links ([fea2675](https://github.com/Viren070/AIOStreams/commit/fea26752ac521415bf8f23ae022d4ecad7b7e731))
+- update size filter constraints to allow zero values ([4a8e9c3](https://github.com/Viren070/AIOStreams/commit/4a8e9c3f7d2d463c0e800e542ef63ad0dab813b7))
+- update social link from Buy Me a Coffee to Ko-fi in DcUniversePreset ([671567c](https://github.com/Viren070/AIOStreams/commit/671567cb433a4912e472d02cf975a1f8037ff223))
+- update table schema ([f3b4088](https://github.com/Viren070/AIOStreams/commit/f3b4088397a7a09bfc0199bcbf769262a0cb1f75))
+- update user data merging logic in configuration import ([5ebb539](https://github.com/Viren070/AIOStreams/commit/5ebb539a3e2e5d623a3682dfeeb626781bb2dde0))
+- update user data reset logic ([9bd9810](https://github.com/Viren070/AIOStreams/commit/9bd9810a7a11132c814024e5182229135e23b42f))
+- use correct input change handlers ([6f3013c](https://github.com/Viren070/AIOStreams/commit/6f3013cdc2883ef9214538bb9cafba475f692604))
+- use nullish coalescing for seeder info in formatter to allow values of 0 ([3e5d581](https://github.com/Viren070/AIOStreams/commit/3e5d581cb0861bfd09a26dbb4bfc318abb579d9a))
+- use structuredClone for config decryption to ensure immutability ([a67603d](https://github.com/Viren070/AIOStreams/commit/a67603d669439465756809b3e1ee9c2637a7bcc5))
+- wrap handling for join case in block ([85a7775](https://github.com/Viren070/AIOStreams/commit/85a777544593b9a76d7cb8930db8e0321e6511fa))
+- wrap switch cases in blocks ([16b208b](https://github.com/Viren070/AIOStreams/commit/16b208b05b2450771834954cd54a193af79fdc2d))
+- **wrapper:** allow empty arrays as valid input in wrapper class ([c64a4f4](https://github.com/Viren070/AIOStreams/commit/c64a4f43ceb1b1eb85658a919ce3759df81556a9))
+- **wrapper:** enhance error logging for manifest and resource parsing by using formatZodError ([ffc974e](https://github.com/Viren070/AIOStreams/commit/ffc974ede622e970fc5f7396d4f1d1658726228a))
+
+## [1.22.0](https://github.com/Viren070/AIOStreams/compare/v1.21.1...v1.22.0) (2025-05-22)
+
+### Features
+
+- pass `baseUrl` in Easynews++ config and add optional `EASYNEWS_PLUS_PLUS_PUBLIC_URL`. ([b41e210](https://github.com/Viren070/AIOStreams/commit/b41e210c04777b349629dc98f28982bfb2e54886))
+- stremthru improvements ([#172](https://github.com/Viren070/AIOStreams/issues/172)) ([72b5ab6](https://github.com/Viren070/AIOStreams/commit/72b5ab648e511220d7ff8b4bf453db94bb952b30))

CONFIGURING.md

@@ -0,0 +1,45 @@
+> [!NOTE]
+> This table may be outdated, please look at [settings.ts](https://github.com/Viren070/AIOStreams/blob/main/packages/utils/src/settings.ts) for the full list of environment variables you can set.
+
+| Environment Variable               | Default Value                                          | Description                                                                                 |
+|------------------------------------|------------------------------------------------------|---------------------------------------------------------------------------------------------|
+| `ADDON_NAME`                       | `AIOStreams`                                         | The name of the addon.                                                                      |
+| `ADDON_ID`                         | `aiostreams.viren070.com`                            | The unique identifier for the addon.                                                       |
+| `PORT`                             | `3000`                                               | The port on which the server runs.                                                         |
+| `BRANDING`                         | `undefined`    | Custom branding for the addon, displayed at the top of the configuration page. **This is a BUILD TIME environment variable.** |
+| `SECRET_KEY`                       | Empty string (`''`)                                  | The secret key used for encryption or sensitive operations.  `openssl rand -hex 32` or `[System.Guid]::NewGuid().ToString("N").Substring(0, 32) + [System.Guid]::NewGuid().ToString("N").Substring(0, 32)` can be used to generate a new secret key for Linux/MacoS and Windows respectively.                         |
+| `CUSTOM_CONFIGS`                   | Empty string (`''`)                                  | Custom configurations in JSON format, using the alias as the key, and the encoded/encrypted string as the value. e.g. {"default": "eyJyZXNvbHV0....", "rd": "E-affedc...}. <br/><br/>In this case, using /default/manifest.json would use the configuration stored at the `default` key.<br/><br/>To easily generate the value for this environment variable, head to /custom-config-generator on your instance to find a tool that outputs the necessary value based on your configurations.                                                |
+| `DISABLE_CUSTOM_CONFIG_GENERATOR_ROUTE` | `false` | Whether to disable the /custom-config-generator route |
+| `COMET_URL`                        | `https://comet.elfhosted.com/`                       | The URL for the Comet addon. You can replace this with your self-hosted instance of Comet.                                                             |
+| `MEDIAFUSION_URL`                  | `https://mediafusion.elfhosted.com/`                 | The URL for the MediaFusion addon                                                      |
+| `MEDIAFUSION_API_PASSWORD`         | Empty string (`''`)                                  | The API_PASSWORD variable you set for your self-hosted MediaFusion instance. This is required if you want AIOStreams to generate configurations for MediaFusion based on the services you entered. If you provide the override url option for MediaFusion, this environment variable isn't required                                                     |
+| `TORRENTIO_URL`                    | `https://torrentio.strem.fun/`                       | The URL for the Torrentio addon.                                                         |
+| `TORBOX_STREMIO_URL`               | `https://stremio.torbox.app/`                        | The URL for the Torbox Stremio addon.                                                    |
+| `EASYNEWS_URL`                     | `https://ea627ddf0ee7-easynews.baby-beamup.club/`    | The URL for the Easynews addon.                                                          |
+| `EASYNEWS_PLUS_URL`                | `https://b89262c192b0-stremio-easynews-addon.baby-beamup.club/` | The URL for the Easynews Plus addon. This can be replaced with your self-hosted instance                                               |
+| `ADDON_PROXY`                      | Empty string (`''`)                                  | You can run the requests AIOStreams makes to other addons through a proxy such as https://github.com/cmj2002/warp-docker                                                                  |
+| `DEFAULT_MEDIAFLOW_URL`            | Empty string (`''`)                                  | You can set a default MediaFlow URL. All configurations made at an instance with this enabled will use this MediaFlow URL if it is not overriden by a user-set URL at the configure page                                                              |
+| `DEFAULT_MEDIAFLOW_API_PASSWORD`   | Empty string (`''`)                                  | The API password for the default MediaFlow URL.                                          |
+| `DEFAULT_MEDIAFLOW_PUBLIC_IP`      | Empty string (`''`)                                  | Public IP for the default MediaFlow instance. This IP is forwarded to other addons                                            |
+| `MAX_ADDONS`                       | `15`                                                 | Maximum number of addons allowed.                                                          |
+| `CACHE_STREAM_RESULTS`             | `true`                                               | Whether to cache the responses from addons for a specific requests. Only useful when the exact same request with the same debrid service configuration is repeated within a small timeframe. This can end up overwriting the MediaFlow public IPs depending on how many users are using the instance | 
+| `CACHE_STREAM_RESULTS_TTL`         | `600`                                                | The time to live (TTL) for cached stream responses in seconds. Cache that becomes older than this time is discarded | 
+| `CACHE_MEDIAFLOW_IP_TTL`           | `900`                                                | The time to live (TTL) for cached public IPs for the same MediaFlow URL and password. | 
+| `MAX_CACHE_SIZE`                   | `1024`                                               | Maximum number of items the memory cache can hold. The cache stores streams from addon responses (for 10 minutes) and MediaFlow Public IPs (for 5 minutes).   | 
+| `MAX_KEYWORD_FILTERS`              | `30`                                                 | The maximum number of individual filters that you are allowed to enter for all keyword filters | 
+| `MAX_MOVIE_SIZE`                   | `161061273600` (150 GiB)                             | The maximum movie size that the user can set with the slider at the configuration page                                                      |
+| `MAX_EPISODE_SIZE`                 | `16106127360` (15 GiB)                               | The maximum episode size that the user can set with the slider at the configuration page                                               |
+| `MAX_TIMEOUT`                      | `50000`                                              | Maximum timeout that can be entered by the user in the configuration options                                    |
+| `MIN_TIMEOUT`                      | `1000`                                               | Minimum timeout that can be entered by the user in the configuration options                                      |
+| `MEDIAFLOW_IP_TIMEOUT`             | `30000`                                              | The timeout for public IP requests to MediaFlow. When AIOStreams fails to get the IP, it will not make the request to the addon.
+| `DEFAULT_TIMEOUT`                  | `15000`                                              | The value of this environment variable applies to all addon requests by default, unless overriden by an addon specific environment variable. <br/><br/>What this means is that this value essentially controls the time you wait for AIOStreams to response. As AIOStreams barely takes any time for its post-sorting and filtering. If all timeouts are set to 5000ms, the addon is forced to respond within 5 seconds, as all addon requests are carried out concurrently.                                       |
+| `DEFAULT_TORRENTIO_TIMEOUT`        | `5000`                                               | Default timeout for Torrentio requests (in milliseconds).                                |
+| `DEFAULT_TORBOX_TIMEOUT`           | `15000`                                              | Default timeout for Torbox requests (in milliseconds).                                   |
+| `DEFAULT_COMET_TIMEOUT`            | `15000`                                              | Default timeout for Comet requests (in milliseconds).                                    |
+| `DEFAULT_MEDIAFUSION_TIMEOUT`      | `15000`                                              | Default timeout for MediaFusion requests (in milliseconds).                              |
+| `DEFAULT_EASYNEWS_TIMEMOUT`        | `15000`                                              | Default timeout for Easynews requests (in milliseconds).                                 |
+| `DEFAULT_EASYNEWS_PLUS_TIMEMOUT`   | `15000`                                              | Default timeout for Easynews Plus requests (in milliseconds).                            |
+| `SHOW_DIE`                         | `true`                                               | Whether to display the die emoji in AIOStreams results                                                          |
+| `LOG_SENSITIVE_INFO`               | `false`                                              | Whether to log sensitive information.                                                      |
+| `DISABLE_TORRENTIO`                | `false`                                              | Whether to disable adding Torrentio as an addon, through override URLs, custom addons, or through the public ElfHosted instance of StremThru | 
+| `DISABLE_TORRENTIO_MESSAGE`        | `''The Torrentio addon has been disabled, please remove it to use this addon.'`| The message shown when `DISABLE_TORRENTIO` is `true` and Torrentio is present in the configuration |

Dockerfile

@@ -0,0 +1,58 @@
+FROM node:22-alpine AS builder
+
+WORKDIR /build
+
+# Copy LICENSE file.
+COPY LICENSE ./
+
+# Copy the relevant package.json and package-lock.json files.
+COPY package*.json ./
+COPY packages/server/package*.json ./packages/server/
+COPY packages/core/package*.json ./packages/core/
+COPY packages/frontend/package*.json ./packages/frontend/
+
+# Install dependencies.
+RUN npm install
+
+# Copy source files.
+COPY tsconfig.*json ./
+
+COPY packages/server ./packages/server
+COPY packages/core ./packages/core
+COPY packages/frontend ./packages/frontend
+COPY scripts ./scripts
+COPY resources ./resources
+
+
+# Build the project.
+RUN npm run build
+
+# Remove development dependencies.
+RUN npm --workspaces prune --omit=dev
+
+FROM node:22-alpine AS final
+
+WORKDIR /app
+
+# Copy the built files from the builder.
+# The package.json files must be copied as well for NPM workspace symlinks between local packages to work.
+COPY --from=builder /build/package*.json /build/LICENSE ./
+
+COPY --from=builder /build/packages/core/package.*json ./packages/core/
+COPY --from=builder /build/packages/frontend/package.*json ./packages/frontend/
+COPY --from=builder /build/packages/server/package.*json ./packages/server/
+
+COPY --from=builder /build/packages/core/dist ./packages/core/dist
+COPY --from=builder /build/packages/frontend/out ./packages/frontend/out
+COPY --from=builder /build/packages/server/dist ./packages/server/dist
+
+COPY --from=builder /build/resources ./resources
+
+COPY --from=builder /build/node_modules ./node_modules
+
+HEALTHCHECK --interval=30s --timeout=5s --start-period=5s --retries=3 \
+  CMD wget --no-verbose --tries=1 --spider http://localhost:${PORT:-3000}/api/v1/status || exit 1
+
+EXPOSE ${PORT:-3000}
+
+ENTRYPOINT ["npm", "run", "start"]

LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Viren070
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

README.md

@@ -1,12 +1,158 @@
+<p align="center">
+  <img src="https://raw.githubusercontent.com/Viren070/AIOStreams/main/packages/frontend/public/assets/logo.png" alt="AIOStreams Logo" width="200"/>
+</p>
+
+<h1 align="center">AIOStreams</h1>
+
+<p align="center">
+  <strong>One addon to rule them all.</strong>
+  <br />
+  AIOStreams consolidates multiple Stremio addons and debrid services into a single, highly customisable super-addon.
+</p>
+
+<p align="center">
+    <a href="https://github.com/Viren070/AIOStreams/actions/workflows/deploy-docker.yml"> 
+        <img src="https://img.shields.io/github/actions/workflow/status/viren070/aiostreams/deploy-docker.yml?style=for-the-badge&logo=github" alt="Build Status">
+    </a>
+    <a href="https://github.com/Viren070/AIOStreams/releases/latest">
+        <img src="https://img.shields.io/github/v/release/viren070/aiostreams?style=for-the-badge&logo=github" alt="Latest Release">
+    </a>
+    <a href="https://github.com/Viren070/AIOStreams/stargazers">
+        <img src="https://img.shields.io/github/stars/Viren070/AIOStreams?style=for-the-badge&logo=github" alt="GitHub Stars">
+    </a>
+    <a href="https://hub.docker.com/r/viren070/aiostreams">
+        <img src="https://img.shields.io/docker/pulls/viren070/aiostreams?style=for-the-badge&logo=docker" alt="Docker Pulls">
+    </a>
+    <a href="https://discord.gg/aiostreams">
+        <img src="https://img.shields.io/badge/Discord-Join_Chat-7289DA?logo=discord&logoColor=white&style=for-the-badge" alt="Discord Server">
+    </a>
+</p>
+
+---
+
+## ✨ What is AIOStreams?
+
+AIOStreams was created to give users ultimate control over their Stremio experience. Instead of juggling multiple addons with different configurations and limitations, AIOStreams acts as a central hub. It fetches results from all your favorite sources, then filters, sorts, and formats them according to *your* rules before presenting them in a single, clean list.
+
+Whether you're a casual user who wants a simple, unified stream list or a power user who wants to fine-tune every aspect of your results, AIOStreams has you covered.
+
+
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/6179efdb-abc9-4e0c-ae11-fb0e3ca9606a" alt="AIOStreams in action"  width="750" />
+</p>
+
+## 🚀 Key Features
+
+### 🔌 All Your Addons, One Interface
+- **Unified Results**: Aggregate streams from multiple addons into one consistently sorted and formatted list.
+- **Simplified Addon Management**: AIOStreams features a built-in addon marketplace. Many addons require you to install them multiple times to support different debrid services. AIOStreams handles this automatically. Just enable an addon from the marketplace, and AIOStreams dynamically applies your debrid keys, so you only have to configure it once.
+- **Automatic Updates**: Because addon manifests are generated dynamically, you get the latest updates and fixes without ever needing to reconfigure or reinstall.
+- **Custom Addon Support**: Add *any* Stremio addon by providing its configured URL. If it works in Stremio, it works here.
+- **Full Stremio Support**: AIOStreams doesn't just manage streams; it supports all Stremio resources, including catalogs, metadata, and even addon catalogs.
+
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/eb47063c-7519-4619-804f-ad84a34d6591" alt="Addon Configuration" width="750"/>
+</p>
+
+### 🔬 Advanced Filtering & Sorting Engine
+Because all addons are routed through AIOStreams, you only have to **configure your filters and sorting rules once**. This powerful, centralized engine offers far more options and flexibility than any individual addon.
+
+- **Granular Filtering**: Define `include` (prevents filtering), `required`, or `excluded` rules for a huge range of properties:
+    - **Video/Audio**: Resolution, quality, encodes, visual tags (`HDR`, `DV`), audio tags (`Atmos`), and channels.
+    - **Source**: Stream type (`Debrid`, `Usenet`, `P2P`), language, seeder ranges, and cached/uncached status (can be applied to specific addons/services).
+- **Preferred Lists**: Manually define and order a list of preferred properties to prioritize certain results, for example, always showing `HDR` streams first.
+- **Keyword & Regex Filtering**: Filter by simple keywords or complex regex patterns matched against filenames, indexers and release groups for ultimate precision.
+- **Accurate Title Matching**: Leverages the TMDB API to precisely match titles, years, and season/episode numbers, ensuring you always get the right content. This can be granularly applied to specific addons or content types.
+- **Powerful Conditional Engine**: Create dynamic rules with a simple yet powerful expression language.
+    - *Example*: Only exclude 720p streams if more than five 1080p streams are available: `count(resolution(streams, '1080p')) > 5 ? resolution(streams, '720p') : false`.
+    - Check the wiki for a [full function reference](https://github.com/Viren070/AIOStreams/wiki/Stream-Expression-Language).
+- **Customisable Deduplication**: Choose how duplicate streams are detected: by filename, infohash, and a unique "smart detect" hash generated from certain file attributes.
+- **Sophisticated Sorting**:
+    - Build your perfect sort order using any combination of criteria.
+    - Define separate sorting logic for movies, series, anime, and even for cached vs. uncached results.
+    - The sorting system automatically uses the rankings from your "Preferred Lists".
+
+### 🗂️ Unified Catalog Management
+Take control of your Stremio home page. AIOStreams lets you manage catalogs from all your addons in one place.
+- **Rename**: Rename both the name and the type of the catalog to whatever you want. (e.g. Changing Cinemeta's `Popular - Movies` to `Popular - 📺`)
+- **Reorder & Disable**: Arrange catalogs in your preferred order or hide the ones you don't use.
+- **Shuffle Catalogs**: Discover new content by shuffling the results of any catalog. You can even persist the shuffle for a set period.
+- **Enhanced Posters**: Automatically apply high-quality posters from [RPDB](https://rpdb.net/) to catalogs that provide a supported metadata source, even if the original addon doesn't support it.
+
+<p align="center">
+
+  <img src="https://github.com/user-attachments/assets/12c26705-a373-42b4-9164-0c23b9e9cbe6" alt="Filtering and Sorting Rules" width="750"/>
+</p>
+
+### 🎨 Total Customization
+- **Custom Stream Formatting**: Design exactly how stream information is displayed using a powerful templating system.
+- **Live Preview**: See your custom format changes in real-time as you build them.
+- **Predefined Formats**: Get started quickly with built-in formats, some created by me and others inspired by other popular addons like Torrentio and the TorBox Stremio Addon.
+- **[Custom Formatter Wiki](https://github.com/Viren070/AIOStreams/wiki/Custom-Formatter)**: Dive deep into the documentation to create your perfect stream title.
+
+
+<p align="center">
+  <img src="https://github.com/user-attachments/assets/906cc3fc-16d1-4702-99c7-425b2445387b" alt="Custom Formatter UI" width="750"/>
+</p>
+
+<p align="center">
+  <sub>
+    This format was created by one of our community members in the 
+    <a href="https://discord.gg/aiostreams">Discord Server</a>
+  </sub>
+</p>
+
+
+### 🛡️ Proxy & Performance
+- **Proxy Integration**: Seamlessly proxy streams through **[MediaFlow Proxy](https://github.com/mhdzumair/mediaflow-proxy)** or **[StremThru](https://github.com/MunifTanjim/stremthru)**.
+- **Bypass IP Restrictions**: Essential for services that limit simultaneous connections from different IP addresses.
+- **Improve Compatibility**: Fixes playback issues with certain players (like Infuse) and addons.
+
+And much much more...
+
+## 🚀 Getting Started
+
+Setting up AIOStreams is simple.
+
+1.  **Choose a Hosting Method**
+    - **🔓 Public Instance**: Use the **[Community Instance (Hosted by ElfHosted)](https://aiostreams.elfhosted.com/configure)**. It's free, but rate-limited and has Torrentio disabled.
+    - **🛠️ Self-Host / Paid Hosting**: For full control and no rate limits, host it yourself (Docker) or use a paid service like **[ElfHosted](https://store.elfhosted.com/product/aiostreams/elf/viren070/)** (using this link supports the project!).
+
+2.  **Configure Your Addon**
+    - Open the `/stremio/configure` page of your AIOStreams instance in a web browser.
+    - Enable the addons you use, add your debrid API keys, and set up your filtering, sorting, and formatting rules.
+
+3.  **Install**
+    - Click the "Install" button. This will open your Stremio addon compatible app and add your newly configured AIOStreams addon.
+
+For detailed instructions, check out the Wiki:
+- **[Deployment Guide](https://github.com/Viren070/AIOStreams/wiki/Deployment)**
+- **[Configuration Guide](https://github.com/Viren070/AIOStreams/wiki/Configuration)**
+
 ---
-title: Monkastremio
-emoji: 😻
-colorFrom: gray
-colorTo: yellow
-sdk: docker
-pinned: false
-license: mit
-short_description: streams for monkaS
+
+## ❤️ Support the Project
+
+AIOStreams is a passion project developed and maintained for free. If you find it useful, please consider supporting its development.
+
+- ⭐ **Star the Repository** on [GitHub](https://github.com/Viren070/AIOStreams).
+- ⭐ **Star the Addon** in the [Stremio Community Catalog](https://beta.stremio-addons.net/addons/aiostreams).
+- 🤝 **Contribute**: Report issues, suggest features, or submit pull requests.
+- ☕ **Donate**:
+  - **[Ko-fi](https://ko-fi.com/viren070)**
+  - **[GitHub Sponsors](https://github.com/sponsors/Viren070)**
+
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+## ⚠️ Disclaimer
+
+AIOStreams is a tool for aggregating and managing data from other Stremio addons. It does not host, store, or distribute any content. The developer does not endorse or promote access to copyrighted content. Users are solely responsible for complying with all applicable laws and the terms of service for any addons or services they use with AIOStreams.
+
+## 🙏 Credits
+
+This project wouldn't be possible without the foundational work of many others in the community, especially those who develop the addons that AIOStreams integrates. Special thanks to the developers of all the integrated addons, the creators of [mhdzumair/mediaflow-proxy](https://github.com/mhdzumair/mediaflow-proxy) and [MunifTanjim/stremthru](https://github.com/MunifTanjim/stremthru), and the open-source projects that inspired parts of AIOStreams' design:
+
+* UI Components and issue templates adapted with permission from [5rahim/seanime](https://github.com/5rahim/seanime) (which any anime enthusiast should definitely check out!)
+* [sleeyax/stremio-easynews-addon](https://github.com/sleeyax/stremio-easynews-addon) for the projects initial structure
+* Custom formatter system inspired by and adapted from [diced/zipline](https://github.com/diced/zipline).
+* Condition engine powered by [expr-eval](https://github.com/silentmatt/expr-eval)

compose.yaml

@@ -0,0 +1,17 @@
+services:
+  aiostreams:
+    image: ghcr.io/viren070/aiostreams:latest
+    container_name: aiostreams
+    restart: unless-stopped
+    ports:
+      - 3000:3000
+    env_file:
+      - .env
+    volumes:
+      - ./data:/app/data
+    healthcheck:
+      test: wget -qO- http://localhost:3000/api/v1/status
+      interval: 1m
+      timeout: 10s
+      retries: 5
+      start_period: 10s

fetch-proxy.js

@@ -0,0 +1,103 @@
+const express = require('express');
+const cors = require('cors');
+const fetch = require('node-fetch');
+
+const app = express();
+app.use(cors());
+app.use(express.json());
+
+// Handle GET requests to /fetch?url=... (for Cloudflare Worker)
+app.get('/fetch', async (req, res) => {
+    try {
+        const { url, method = 'GET' } = req.query;
+
+        if (!url) {
+            return res.status(400).json({ error: 'URL parameter is required' });
+        }
+
+        console.log(`GET /fetch - Proxying request to: ${url}`);
+
+        const response = await fetch(url, {
+            method: method.toUpperCase(),
+            headers: {
+                'User-Agent': 'AIOStreams-Proxy/1.0',
+                'Accept': '*/*',
+            },
+        });
+
+        const data = await response.text();
+
+        // Forward the status code and content
+        res.status(response.status);
+
+        // Forward important headers
+        const contentType = response.headers.get('content-type');
+        if (contentType) {
+            res.set('Content-Type', contentType);
+        }
+
+        res.send(data);
+    } catch (error) {
+        console.error('GET Proxy error:', error);
+        res.status(500).json({ error: error.message });
+    }
+});
+
+// Handle POST requests to / (existing functionality)
+app.post('/', async (req, res) => {
+    try {
+        const { url, method = 'GET', headers = {}, body } = req.body;
+
+        if (!url) {
+            return res.status(400).json({ error: 'URL is required in request body' });
+        }
+
+        console.log(`POST / - Proxying request to: ${url}`);
+
+        const response = await fetch(url, {
+            method,
+            headers: {
+                'User-Agent': 'AIOStreams-Proxy/1.0',
+                ...headers,
+            },
+            body: body ? JSON.stringify(body) : undefined,
+        });
+
+        const data = await response.text();
+
+        res.status(response.status).send(data);
+    } catch (error) {
+        console.error('POST Proxy error:', error);
+        res.status(500).json({ error: error.message });
+    }
+});
+
+// Health check endpoint
+app.get('/health', (req, res) => {
+    res.json({ status: 'ok', timestamp: new Date().toISOString() });
+});
+
+// Root endpoint with usage info
+app.get('/', (req, res) => {
+    res.json({
+        message: 'AIOStreams Fetch Proxy',
+        endpoints: {
+            'GET /fetch?url=<url>': 'Proxy a GET request to the specified URL',
+            'POST /': 'Proxy a request with full control (url, method, headers, body in JSON)',
+            'GET /health': 'Health check'
+        },
+        examples: {
+            get: '/fetch?url=https://example.com',
+            post: 'POST / with {"url": "https://example.com", "method": "GET"}'
+        }
+    });
+});
+
+const PORT = process.env.PORT || 3128;
+app.listen(PORT, () => {
+    console.log(`Fetch proxy running on port ${PORT}`);
+    console.log(`Endpoints:`);
+    console.log(`  GET /fetch?url=<url> - Simple proxy for GET requests`);
+    console.log(`  POST / - Full proxy with method/headers/body control`);
+    console.log(`  GET /health - Health check`);
+}); 

nginx.conf

@@ -0,0 +1,234 @@
+# ===================================================================
+# nginx.conf (or a file under /etc/nginx/conf.d/aiostreams.conf)
+# ===================================================================
+#
+# This config listens on port 443 for aiostreams.bolabaden.org (HTTPS),
+# and proxies all requests to one of three upstreams:
+#   - aiostreams-cf.bolabaden.org
+#   - aiostreams-koyeb.bolabaden.org
+#   - aiostreams.bolabaden.duckdns.org
+#
+# If any one of the three backends becomes unreachable (TCP error, 5xx, etc.),
+# NGINX will mark it “down” for a short period and continue sending new requests
+# to the remaining healthy backends.  When it recovers, NGINX will automatically
+# send traffic to it again.
+#
+# We use “ip_hash” so that each client IP tends to hit the same backend (session affinity).
+# If that backend dies, NGINX will transparently route the next request to another healthy
+# backend.  No DNS‐level trickery is used here—NGINX does all proxying at L7.
+#
+# Replace the SSL certificate/key paths below with your actual .crt/.key files.
+
+################################################################################
+# 1) GLOBAL CONTEXT / EVENTS
+################################################################################
+
+user   nginx;
+worker_processes  auto;
+error_log  /var/log/nginx/error.log  notice;
+pid        /var/run/nginx.pid;
+
+events {
+    worker_connections 1024;
+}
+
+
+################################################################################
+# 2) HTTP CONTEXT
+################################################################################
+
+http {
+    # mime types, log format, etc. can be inherited from defaults.
+    include       /etc/nginx/mime.types;
+    default_type  application/octet-stream;
+
+    # Tuning timeouts for proxy connections:
+    send_timeout        30s;
+    keepalive_timeout   65s;
+    client_max_body_size  10m;
+
+    # ------------------------------------------------------------------------
+    # 2.a) Define the upstream block with all three backends
+    #     “ip_hash” ensures session‐affinity by client IP.  If that server fails,
+    #     NGINX (passively) marks it down (max_fails + fail_timeout) and sends
+    #     to the next available IP.
+    #
+    #     Note: We are proxying to each backend over HTTPS (port 443),
+    #     so we append “:443 ssl” to each server line.  NGINX by default will
+    #     initiate an SSL hand‐shake to the upstream.
+    # ------------------------------------------------------------------------
+
+    upstream aiostreams_pool {
+        # Use ip_hash for basic session affinity (same client IP → same backend):
+        ip_hash;
+
+        # Primary backends.  max_fails=3 means that if 3 consecutive attempts
+        # to connect or pass data to a given backend fail within “fail_timeout”
+        # (30s), that backend is marked as unavailable for 30s.
+        server aiostreams-cf.bolabaden.org:443   max_fails=3 fail_timeout=30s;
+        server aiostreams-koyeb.bolabaden.org:443 max_fails=3 fail_timeout=30s;
+        server aiostreams.bolabaden.duckdns.org:443 max_fails=3 fail_timeout=30s;
+    }
+
+
+    # ------------------------------------------------------------------------
+    # 2.b) Redirect all HTTP (port 80) → HTTPS (port 443).
+    #     This ensures clients typing “http://…” get automatically sent
+    #     to the secure endpoint.
+    # ------------------------------------------------------------------------
+    server {
+        listen       80;
+        listen       [::]:80;
+        server_name  aiostreams.bolabaden.org;
+
+        # Redirect every request to https://... preserving URI:
+        return 301 https://$host$request_uri;
+    }
+
+
+    # ------------------------------------------------------------------------
+    # 2.c) Main HTTPS server block for aiostreams.bolabaden.org
+    # ------------------------------------------------------------------------
+    server {
+        listen              443 ssl http2;
+        listen              [::]:443 ssl http2;
+        server_name         aiostreams.bolabaden.org;
+
+        # --------------------------------------------------------------------
+        # SSL Certificate / Key
+        # --------------------------------------------------------------------
+        #
+        # You must replace these with the actual paths to your certificate
+        # and private key (e.g. from Let’s Encrypt or another CA).
+        #
+        ssl_certificate     /etc/letsencrypt/live/aiostreams.bolabaden.org/fullchain.pem;
+        ssl_certificate_key /etc/letsencrypt/live/aiostreams.bolabaden.org/privkey.pem;
+
+        # (Optional but recommended) 
+        # Tune SSL protocols/ciphers for security.  Example:
+        ssl_protocols       TLSv1.2 TLSv1.3;
+        ssl_ciphers         HIGH:!aNULL:!MD5;
+        ssl_prefer_server_ciphers on;
+
+        # --------------------------------------------------------------------
+        # Access and Error Logs (optional, but recommended for debugging)
+        # --------------------------------------------------------------------
+        access_log  /var/log/nginx/aiostreams.access.log  combined;
+        error_log   /var/log/nginx/aiostreams.error.log   warn;
+
+        # --------------------------------------------------------------------
+        # Proxy Buffering / Timeouts (adjust to suit your app’s needs)
+        # --------------------------------------------------------------------
+        proxy_buffer_size          16k;
+        proxy_buffers              4 32k;
+        proxy_busy_buffers_size    64k;
+        proxy_connect_timeout      5s;
+        proxy_send_timeout         30s;
+        proxy_read_timeout         30s;
+        proxy_buffering            on;
+        proxy_buffering           off;   # ← turn OFF if your app does streaming / WebSockets
+
+        # --------------------------------------------------------------------
+        # Main Location: proxy everything (/) to the upstream pool
+        # --------------------------------------------------------------------
+        location / {
+            # Pass requests to our upstream group:
+            proxy_pass https://aiostreams_pool;
+
+            # Preserve the original Host header so the backends see “aiostreams.bolabaden.org”
+            # (if your backends require the Host to match their TLS certificate, you can also
+            # use “proxy_ssl_name aiostreams-cf.bolabaden.org;” per-backend via “proxy_set_header Host …”)
+            proxy_set_header Host               $host;
+            proxy_set_header X-Real-IP          $remote_addr;
+            proxy_set_header X-Forwarded-For    $proxy_add_x_forwarded_for;
+            proxy_set_header X-Forwarded-Proto  $scheme;
+
+            # If a backend fails with certain HTTP status codes or connection errors,
+            # retry on the next available upstream.  Here we retry on: timeout, HTTP 500, 502, 503, 504.
+            proxy_next_upstream error timeout http_502 http_503 http_504;
+
+            # Number of retries before giving up:
+            proxy_next_upstream_tries 3;
+
+            # When proxying to an HTTPS upstream, ensure the upstream’s TLS name matches:
+            proxy_ssl_server_name on;
+
+            # (Optional) If your backends use self-signed certs, disable verification:
+            # proxy_ssl_verify off;
+            #
+            # Otherwise (recommended), keep verification ON and trust the system’s ca‐bundle:
+            proxy_ssl_verify on;
+            proxy_ssl_trusted_certificate /etc/ssl/certs/ca-bundle.crt;
+        }
+
+        # --------------------------------------------------------------------
+        # (Optional) Handle ACME (Let’s Encrypt) HTTP-01 challenges if you
+        # want to auto-provision certificates.  Skip if you manage certificates manually.
+        # --------------------------------------------------------------------
+        # location /.well-known/acme-challenge/ {
+        #     root /var/www/letsencrypt;
+        #     allow all;
+        # }
+
+        # --------------------------------------------------------------------
+        # (Optional) Return 404 for anything else:
+        # --------------------------------------------------------------------
+        error_page 404 /404.html;
+        location = /404.html {
+            internal;
+            root /usr/share/nginx/html;
+        }
+    }
+
+    # ------------------------------------------------------------------------
+    # 2.d) (Optional) Upstream health check—passive only (built-in):
+    #     NGINX will automatically mark a backend “down” after max_fails,
+    #     and retry only after fail_timeout.  If you need active health checks,
+    #     you’d install the nginx‐upstream‐healthcheck module (third-party).
+    # ------------------------------------------------------------------------
+}
+
+
+################################################################################
+# 3) NOTES ON HOW THIS WORKS
+################################################################################
+
+# 1) ip_hash
+#    - Guarantees “session affinity” by hashing the client’s IP and sending it
+#      to the same backend each time (so long as that backend is up).
+#    - If the chosen backend becomes unavailable (because of max_fails/fail_timeout),
+#      NGINX transparently sends the next request to a healthy backend.
+#    - No DNS changes are ever made; clients always talk to https://aiostreams.bolabaden.org,
+#      and NGINX does the upstream routing.
+
+# 2) max_fails / fail_timeout
+#    - “max_fails=3 fail_timeout=30s” means:
+#         • If 3 consecutive attempts to connect (or receive a response) to that backend
+#           fail within 30s, that backend is marked “unhealthy” and is skipped for the
+#           next 30 seconds.
+#         • After 30s passes, NGINX will retry the backend on a new request.
+#    - This is a passive health check—based on traffic failures.
+
+# 3) proxy_next_upstream
+#    - If NGINX sees a connection error, a timeout, or one of the configured status codes
+#      (5xx, 502, 503, 504), it immediately retries the request on the next healthy backend.
+#    - Use “proxy_next_upstream_tries 3;” to limit retries.
+
+# 4) proxy_ssl_server_name
+#    - When proxying via HTTPS, NGINX by default will send “Host”=IP to the upstream,
+#      which may not match the certificate on the backend.  “proxy_ssl_server_name on;”
+#      causes NGINX to send SNI = the hostname in the “proxy_pass” URL (e.g. aiostreams-cf.bolabaden.org).
+
+# 5) If you require faster health checks (active probes), you could compile or install
+#    the “nginx_upstream_check_module” (third party).  But the above passive checks
+#    are sufficient for most “any one of three must be up” scenarios.
+
+# 6) SSL Certificates
+#    - This example assumes you store Let’s Encrypt certificates under /etc/letsencrypt/…
+#    - If you haven’t yet obtained a certificate for aiostreams.bolabaden.org, do:
+#         certbot certonly --webroot -w /var/www/html -d aiostreams.bolabaden.org
+#      then update the “ssl_certificate” paths above accordingly.
+
+################################################################################
+# END OF CONFIG
+################################################################################

package.json

@@ -0,0 +1,35 @@
+{
+  "name": "aiostreams",
+  "version": "2.4.2",
+  "description": "AIOStreams consolidates multiple Stremio addons and debrid services into a single, easily configurable addon. It allows highly customisable filtering, sorting, and formatting of results and supports proxying all your streams through MediaFlow Proxy or StremThru for improved compatibility and IP restriction bypassing.",
+  "main": "dist/index.js",
+  "scripts": {
+    "test": "npm run test --workspaces",
+    "release": "commit-and-tag-version",
+    "format": "prettier --write .",
+    "metadata": "node scripts/generateMetadata.js",
+    "build": "npm -w packages/core run build && npm -w packages/server run build && npm -w packages/frontend run build",
+    "build:watch": "tsc --build --watch",
+    "start": "node packages/server/dist/server",
+    "start:addon": "npm run start",
+    "start:dev": "cross-env NODE_ENV=development tsx watch packages/server/src/server.ts",
+    "start:addon:dev": "npm run start:dev",
+    "start:frontend:dev": "npm -w packages/frontend run dev"
+  },
+  "author": "Viren070",
+  "license": "MIT",
+  "workspaces": [
+    "packages/*"
+  ],
+  "devDependencies": {
+    "cross-env": "^7.0.3",
+    "prettier": "^3.3.2",
+    "tsx": "^4.16.2",
+    "typescript": "^5.5.3",
+    "vitest": "^2.1.5",
+    "ts-node": "^10.9.2"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  }
+}

packages/addon/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@aiostreams/addon",
+  "version": "1.21.1",
+  "main": "dist/index.js",
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest watch",
+    "build": "tsc",
+    "prepublish": "npm run build",
+    "start": "node dist/server.js",
+    "start:dev": "cross-env NODE_ENV=dev tsx watch src/server.ts"
+  },
+  "description": "Combine all your streams into one addon and display them with consistent formatting, sorting, and filtering.",
+  "dependencies": {
+    "@aiostreams/formatters": "^1.0.0",
+    "@aiostreams/types": "^1.0.0",
+    "@aiostreams/utils": "^1.0.0",
+    "@aiostreams/wrappers": "^1.0.0",
+    "dotenv": "^16.4.7",
+    "express": "^4.21.2"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0"
+  }
+}

packages/addon/src/addon.ts

@@ -0,0 +1,1416 @@
+import {
+  BaseWrapper,
+  getCometStreams,
+  getDebridioStreams,
+  getDMMCastStreams,
+  getEasynewsPlusPlusStreams,
+  getEasynewsPlusStreams,
+  getEasynewsStreams,
+  getJackettioStreams,
+  getMediafusionStreams,
+  getOrionStreams,
+  getPeerflixStreams,
+  getStremioJackettStreams,
+  getStremThruStoreStreams,
+  getTorboxStreams,
+  getTorrentioStreams,
+} from '@aiostreams/wrappers';
+import {
+  Stream,
+  ParsedStream,
+  StreamRequest,
+  Config,
+  ErrorStream,
+} from '@aiostreams/types';
+import {
+  gdriveFormat,
+  torrentioFormat,
+  torboxFormat,
+  imposterFormat,
+  customFormat,
+} from '@aiostreams/formatters';
+import {
+  addonDetails,
+  getMediaFlowConfig,
+  getMediaFlowPublicIp,
+  getTimeTakenSincePoint,
+  Settings,
+  createLogger,
+  generateMediaFlowStreams,
+  getStremThruConfig,
+  getStremThruPublicIp,
+  generateStremThruStreams,
+  safeRegexTest,
+  compileRegex,
+  formRegexFromKeywords,
+} from '@aiostreams/utils';
+import { errorStream } from './responses';
+import { isMatch } from 'super-regex';
+
+const logger = createLogger('addon');
+
+export class AIOStreams {
+  private config: Config;
+
+  constructor(config: any) {
+    this.config = config;
+  }
+
+  private async retryGetIp<T>(
+    getter: () => Promise<T | null>,
+    label: string,
+    maxRetries: number = 3
+  ): Promise<T> {
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+      const result = await getter();
+      if (result) {
+        return result;
+      }
+      logger.warn(
+        `Failed to get ${label}, retrying... (${attempt}/${maxRetries})`
+      );
+    }
+    throw new Error(`Failed to get ${label} after ${maxRetries} attempts`);
+  }
+
+  private async getRequestingIp() {
+    let userIp = this.config.requestingIp;
+    const PRIVATE_IP_REGEX =
+      /^(::1|::ffff:(10|127|192|172)\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})|10\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})|127\.(\d{1,3})\.(\d{1,3})\.(\d{1,3})|192\.168\.(\d{1,3})\.(\d{1,3})|172\.(1[6-9]|2[0-9]|3[0-1])\.(\d{1,3})\.(\d{1,3}))$/;
+
+    if (userIp && PRIVATE_IP_REGEX.test(userIp)) {
+      userIp = undefined;
+    }
+    const mediaflowConfig = getMediaFlowConfig(this.config);
+    const stremThruConfig = getStremThruConfig(this.config);
+    if (mediaflowConfig.mediaFlowEnabled) {
+      userIp = await this.retryGetIp(
+        () => getMediaFlowPublicIp(mediaflowConfig),
+        'MediaFlow public IP'
+      );
+    } else if (stremThruConfig.stremThruEnabled) {
+      userIp = await this.retryGetIp(
+        () => getStremThruPublicIp(stremThruConfig),
+        'StremThru public IP'
+      );
+    }
+    return userIp;
+  }
+
+  public async getStreams(streamRequest: StreamRequest): Promise<Stream[]> {
+    const streams: Stream[] = [];
+    const startTime = new Date().getTime();
+
+    try {
+      this.config.requestingIp = await this.getRequestingIp();
+    } catch (error) {
+      logger.error(error);
+      return [errorStream(`Failed to get Proxy IP`)];
+    }
+
+    const { parsedStreams, errorStreams } =
+      await this.getParsedStreams(streamRequest);
+
+    const skipReasons = {
+      excludeLanguages: 0,
+      excludeResolutions: 0,
+      excludeQualities: 0,
+      excludeEncodes: 0,
+      excludeAudioTags: 0,
+      excludeVisualTags: 0,
+      excludeStreamTypes: 0,
+      excludeUncached: 0,
+      sizeFilters: 0,
+      duplicateStreams: 0,
+      streamLimiters: 0,
+      excludeRegex: 0,
+      requiredRegex: 0,
+    };
+
+    logger.info(
+      `Got ${parsedStreams.length} parsed streams and ${errorStreams.length} error streams in ${getTimeTakenSincePoint(startTime)}`
+    );
+
+    const excludeRegexPattern = this.config.apiKey
+      ? this.config.regexFilters?.excludePattern ||
+        Settings.DEFAULT_REGEX_EXCLUDE_PATTERN
+      : undefined;
+    const excludeRegex = excludeRegexPattern
+      ? compileRegex(excludeRegexPattern, 'i')
+      : undefined;
+
+    const excludeKeywordsRegex = this.config.excludeFilters
+      ? formRegexFromKeywords(this.config.excludeFilters)
+      : undefined;
+
+    const requiredRegexPattern = this.config.apiKey
+      ? this.config.regexFilters?.includePattern ||
+        Settings.DEFAULT_REGEX_INCLUDE_PATTERN
+      : undefined;
+    const requiredRegex = requiredRegexPattern
+      ? compileRegex(requiredRegexPattern, 'i')
+      : undefined;
+
+    const requiredKeywordsRegex = this.config.strictIncludeFilters
+      ? formRegexFromKeywords(this.config.strictIncludeFilters)
+      : undefined;
+
+    const sortRegexPatterns = this.config.apiKey
+      ? this.config.regexSortPatterns || Settings.DEFAULT_REGEX_SORT_PATTERNS
+      : undefined;
+
+    const sortRegexes: { name?: string; regex: RegExp }[] | undefined =
+      sortRegexPatterns
+        ? sortRegexPatterns
+            .split(/\s+/)
+            .filter(Boolean)
+            .map((pattern) => {
+              const delimiter = '<::>';
+              const delimiterIndex = pattern.indexOf(delimiter);
+              if (delimiterIndex !== -1) {
+                const name = pattern
+                  .slice(0, delimiterIndex)
+                  .replace(/_/g, ' ');
+                const regexPattern = pattern.slice(
+                  delimiterIndex + delimiter.length
+                );
+
+                const regex = compileRegex(regexPattern, 'i');
+                return { name, regex };
+              }
+              return { regex: compileRegex(pattern, 'i') };
+            })
+        : undefined;
+
+    excludeRegex ||
+    excludeKeywordsRegex ||
+    requiredRegex ||
+    requiredKeywordsRegex ||
+    sortRegexes
+      ? logger.debug(
+          `The following regex patterns are being used:\n` +
+            `Exclude Regex: ${excludeRegex}\n` +
+            `Exclude Keywords: ${excludeKeywordsRegex}\n` +
+            `Required Regex: ${requiredRegex}\n` +
+            `Required Keywords: ${requiredKeywordsRegex}\n` +
+            `Sort Regexes: ${sortRegexes?.map((regex) => `${regex.name || 'Unnamed'}: ${regex.regex}`).join(' --> ')}\n`
+        )
+      : [];
+
+    const filterStartTime = new Date().getTime();
+
+    let filteredResults = parsedStreams.filter((parsedStream) => {
+      const streamTypeFilter = this.config.streamTypes?.find(
+        (streamType) => streamType[parsedStream.type] === false
+      );
+      if (this.config.streamTypes && streamTypeFilter) {
+        skipReasons.excludeStreamTypes++;
+        return false;
+      }
+
+      const resolutionFilter = this.config.resolutions?.find(
+        (resolution) => resolution[parsedStream.resolution] === false
+      );
+      if (resolutionFilter) {
+        skipReasons.excludeResolutions++;
+        return false;
+      }
+
+      const qualityFilter = this.config.qualities?.find(
+        (quality) => quality[parsedStream.quality] === false
+      );
+      if (this.config.qualities && qualityFilter) {
+        skipReasons.excludeQualities++;
+        return false;
+      }
+
+      // Check for HDR and DV tags in the parsed stream
+      const hasHDR = parsedStream.visualTags.some((tag) =>
+        tag.startsWith('HDR')
+      );
+      const hasDV = parsedStream.visualTags.includes('DV');
+      const hasHDRAndDV = hasHDR && hasDV;
+      const HDRAndDVEnabled = this.config.visualTags.some(
+        (visualTag) => visualTag['HDR+DV'] === true
+      );
+
+      const isTagDisabled = (tag: string) =>
+        this.config.visualTags.some((visualTag) => visualTag[tag] === false);
+
+      if (hasHDRAndDV) {
+        if (!HDRAndDVEnabled) {
+          skipReasons.excludeVisualTags++;
+          return false;
+        }
+      } else if (hasHDR) {
+        const specificHdrTags = parsedStream.visualTags.filter((tag) =>
+          tag.startsWith('HDR')
+        );
+        const disabledTags = specificHdrTags.filter(
+          (tag) => isTagDisabled(tag) === true
+        );
+        if (disabledTags.length > 0) {
+          skipReasons.excludeVisualTags++;
+          return;
+        }
+      } else if (hasDV && isTagDisabled('DV')) {
+        skipReasons.excludeVisualTags++;
+        return false;
+      }
+
+      // Check other visual tags for explicit disabling
+      for (const tag of parsedStream.visualTags) {
+        if (tag.startsWith('HDR') || tag === 'DV') continue;
+        if (isTagDisabled(tag)) {
+          skipReasons.excludeVisualTags++;
+          return false;
+        }
+      }
+
+      // apply excludedLanguages filter
+      const excludedLanguages = this.config.excludedLanguages;
+      if (excludedLanguages && parsedStream.languages.length > 0) {
+        if (
+          parsedStream.languages.every((lang) =>
+            excludedLanguages.includes(lang)
+          )
+        ) {
+          skipReasons.excludeLanguages++;
+          return false;
+        }
+      } else if (
+        excludedLanguages &&
+        excludedLanguages.includes('Unknown') &&
+        parsedStream.languages.length === 0
+      ) {
+        skipReasons.excludeLanguages++;
+        return false;
+      }
+
+      const audioTagFilter = parsedStream.audioTags.find((tag) =>
+        this.config.audioTags.some((audioTag) => audioTag[tag] === false)
+      );
+      if (audioTagFilter) {
+        skipReasons.excludeAudioTags++;
+        return false;
+      }
+
+      if (
+        parsedStream.encode &&
+        this.config.encodes.some(
+          (encode) => encode[parsedStream.encode] === false
+        )
+      ) {
+        skipReasons.excludeEncodes++;
+        return false;
+      }
+
+      if (
+        this.config.onlyShowCachedStreams &&
+        parsedStream.provider &&
+        !parsedStream.provider.cached
+      ) {
+        skipReasons.excludeUncached++;
+        return false;
+      }
+
+      if (
+        this.config.minSize &&
+        parsedStream.size &&
+        parsedStream.size < this.config.minSize
+      ) {
+        skipReasons.sizeFilters++;
+        return false;
+      }
+
+      if (
+        this.config.maxSize &&
+        parsedStream.size &&
+        parsedStream.size > this.config.maxSize
+      ) {
+        skipReasons.sizeFilters++;
+        return false;
+      }
+
+      if (
+        streamRequest.type === 'movie' &&
+        this.config.maxMovieSize &&
+        parsedStream.size &&
+        parsedStream.size > this.config.maxMovieSize
+      ) {
+        skipReasons.sizeFilters++;
+        return false;
+      }
+
+      if (
+        streamRequest.type === 'movie' &&
+        this.config.minMovieSize &&
+        parsedStream.size &&
+        parsedStream.size < this.config.minMovieSize
+      ) {
+        skipReasons.sizeFilters++;
+        return false;
+      }
+
+      if (
+        streamRequest.type === 'series' &&
+        this.config.maxEpisodeSize &&
+        parsedStream.size &&
+        parsedStream.size > this.config.maxEpisodeSize
+      ) {
+        skipReasons.sizeFilters++;
+        return false;
+      }
+
+      if (
+        streamRequest.type === 'series' &&
+        this.config.minEpisodeSize &&
+        parsedStream.size &&
+        parsedStream.size < this.config.minEpisodeSize
+      ) {
+        skipReasons.sizeFilters++;
+        return false;
+      }
+
+      // generate array of excludeTests. for each regex, only add to array if the filename or indexers are defined
+      let excludeTests: (boolean | null)[] = [];
+      let requiredTests: (boolean | null)[] = [];
+
+      const addToTests = (field: string | undefined) => {
+        if (field) {
+          excludeTests.push(
+            excludeRegex ? safeRegexTest(excludeRegex, field) : null,
+            excludeKeywordsRegex
+              ? safeRegexTest(excludeKeywordsRegex, field)
+              : null
+          );
+          requiredTests.push(
+            requiredRegex ? safeRegexTest(requiredRegex, field) : null,
+            requiredKeywordsRegex
+              ? safeRegexTest(requiredKeywordsRegex, field)
+              : null
+          );
+        }
+      };
+
+      addToTests(parsedStream.filename);
+      addToTests(parsedStream.folderName);
+      addToTests(parsedStream.indexers);
+
+      // filter out any null values as these are when the regex is not defined
+      excludeTests = excludeTests.filter((test) => test !== null);
+      requiredTests = requiredTests.filter((test) => test !== null);
+
+      if (excludeTests.length > 0 && excludeTests.some((test) => test)) {
+        skipReasons.excludeRegex++;
+        return false;
+      }
+
+      if (requiredTests.length > 0 && !requiredTests.some((test) => test)) {
+        skipReasons.requiredRegex++;
+        return false;
+      }
+
+      return true;
+    });
+
+    logger.info(
+      `Initial filter to ${filteredResults.length} streams in ${getTimeTakenSincePoint(filterStartTime)}`
+    );
+
+    if (this.config.cleanResults) {
+      const cleanedStreams: ParsedStream[] = [];
+      const initialStreams = filteredResults;
+      const normaliseFilename = (filename?: string): string | undefined =>
+        filename
+          ? filename
+              ?.replace(
+                /\.(mkv|mp4|avi|mov|wmv|flv|webm|m4v|mpg|mpeg|3gp|3g2|m2ts|ts|vob|ogv|ogm|divx|xvid|rm|rmvb|asf|mxf|mka|mks|mk3d|webm|f4v|f4p|f4a|f4b)$/i,
+                ''
+              )
+              .replace(/[^\p{L}\p{N}+]/gu, '')
+              .replace(/\s+/g, '')
+              .toLowerCase()
+          : undefined;
+
+      const groupStreamsByKey = (
+        streams: ParsedStream[],
+        keyExtractor: (stream: ParsedStream) => string | undefined
+      ): Record<string, ParsedStream[]> => {
+        return streams.reduce(
+          (acc, stream) => {
+            const key = keyExtractor(stream);
+            if (!key) {
+              if (!cleanedStreams.includes(stream)) {
+                cleanedStreams.push(stream);
+              }
+              return acc;
+            }
+            acc[key] = acc[key] || [];
+            acc[key].push(stream);
+            return acc;
+          },
+          {} as Record<string, ParsedStream[]>
+        );
+      };
+
+      const cleanResultsStartTime = new Date().getTime();
+      // Deduplication by normalised filename
+      const cleanResultsByFilenameStartTime = new Date().getTime();
+      logger.info(`Received ${initialStreams.length} streams to clean`);
+      const streamsGroupedByFilename = groupStreamsByKey(
+        initialStreams,
+        (stream) => normaliseFilename(stream.filename)
+      );
+
+      logger.info(
+        `Found ${Object.keys(streamsGroupedByFilename).length} unique filenames with ${
+          initialStreams.length -
+          Object.values(streamsGroupedByFilename).reduce(
+            (sum, group) => sum + group.length,
+            0
+          )
+        } streams not grouped`
+      );
+
+      // Process grouped streams by filename
+      const cleanedStreamsByFilename = await this.processGroupedStreams(
+        streamsGroupedByFilename
+      );
+
+      logger.info(
+        `Deduplicated streams by filename to ${cleanedStreamsByFilename.length} streams in ${getTimeTakenSincePoint(cleanResultsByFilenameStartTime)}`
+      );
+
+      // Deduplication by hash
+      const cleanResultsByHashStartTime = new Date().getTime();
+
+      const streamsGroupedByHash = groupStreamsByKey(
+        cleanedStreamsByFilename,
+        (stream) => stream._infoHash
+      );
+      logger.info(
+        `Found ${Object.keys(streamsGroupedByHash).length} unique hashes with ${cleanedStreamsByFilename.length - Object.values(streamsGroupedByHash).reduce((sum, group) => sum + group.length, 0)} streams not grouped`
+      );
+
+      // Process grouped streams by hash
+      const cleanedStreamsByHash =
+        await this.processGroupedStreams(streamsGroupedByHash);
+
+      logger.info(
+        `Deduplicated streams by hash to ${cleanedStreamsByHash.length} streams in ${getTimeTakenSincePoint(cleanResultsByHashStartTime)}`
+      );
+
+      cleanedStreams.push(...cleanedStreamsByHash);
+      logger.info(
+        `Deduplicated streams to ${cleanedStreams.length} streams in ${getTimeTakenSincePoint(cleanResultsStartTime)}`
+      );
+      skipReasons.duplicateStreams =
+        filteredResults.length - cleanedStreams.length;
+      filteredResults = cleanedStreams;
+    }
+    // pre compute highest indexes for regexSortPatterns
+    const startPrecomputeTime = new Date().getTime();
+    filteredResults.forEach((stream: ParsedStream) => {
+      if (sortRegexes) {
+        for (let i = 0; i < sortRegexes.length; i++) {
+          if (!stream.filename && !stream.folderName) continue;
+          const regex = sortRegexes[i];
+          if (
+            (stream.filename && isMatch(regex.regex, stream.filename)) ||
+            (stream.folderName && isMatch(regex.regex, stream.folderName))
+          ) {
+            stream.regexMatched = {
+              name: regex.name,
+              pattern: regex.regex.source,
+              index: i,
+            };
+            break;
+          }
+        }
+      }
+    });
+    logger.info(
+      `Precomputed sortRegex indexes for ${filteredResults.length} streams in ${getTimeTakenSincePoint(
+        startPrecomputeTime
+      )}`
+    );
+    // Apply sorting
+    const sortStartTime = new Date().getTime();
+    // initially sort by filename to ensure consistent results
+    filteredResults.sort((a, b) =>
+      a.filename && b.filename ? a.filename.localeCompare(b.filename) : 0
+    );
+
+    // then apply our this.config sorting
+    filteredResults.sort((a, b) => {
+      for (const sortByField of this.config.sortBy) {
+        const field = Object.keys(sortByField).find(
+          (key) => typeof sortByField[key] === 'boolean'
+        );
+        if (!field) continue;
+        const value = sortByField[field];
+
+        if (value) {
+          const fieldComparison = this.compareByField(a, b, field);
+          if (fieldComparison !== 0) return fieldComparison;
+        }
+      }
+
+      return 0;
+    });
+
+    logger.info(`Sorted results in ${getTimeTakenSincePoint(sortStartTime)}`);
+
+    // apply config.maxResultsPerResolution
+    if (this.config.maxResultsPerResolution) {
+      const startTime = new Date().getTime();
+      const resolutionCounts = new Map();
+
+      const limitedResults = filteredResults.filter((result) => {
+        const resolution = result.resolution || 'Unknown';
+        const currentCount = resolutionCounts.get(resolution) || 0;
+
+        if (currentCount < this.config.maxResultsPerResolution!) {
+          resolutionCounts.set(resolution, currentCount + 1);
+          return true;
+        }
+
+        return false;
+      });
+      skipReasons.streamLimiters =
+        filteredResults.length - limitedResults.length;
+      filteredResults = limitedResults;
+
+      logger.info(
+        `Limited results to ${limitedResults.length} streams after applying maxResultsPerResolution in ${new Date().getTime() - startTime}ms`
+      );
+    }
+
+    const totalSkipped = Object.values(skipReasons).reduce(
+      (acc, val) => acc + val,
+      0
+    );
+    const reportLines = [
+      '╔═══════════════════════╤════════════╗',
+      '║ Skip Reason           │ Count      ║',
+      '╟───────────────────────┼────────────╢',
+      ...Object.entries(skipReasons)
+        .filter(([reason, count]) => count > 0)
+        .map(
+          ([reason, count]) =>
+            `║ ${reason.padEnd(21)} │ ${String(count).padStart(10)} ║`
+        ),
+      '╟───────────────────────┼────────────╢',
+      `║ Total Skipped         │ ${String(totalSkipped).padStart(10)} ║`,
+      '╚═══════════════════════╧════════════╝',
+    ];
+
+    if (totalSkipped > 0) logger.info('\n' + reportLines.join('\n'));
+
+    // Create stream objects
+    const streamsStartTime = new Date().getTime();
+    const streamObjects = await this.createStreamObjects(filteredResults);
+    streams.push(...streamObjects.filter((s) => s !== null));
+
+    // Add error streams to the end
+    streams.push(
+      ...errorStreams.map((e) => errorStream(e.error, e.addon.name))
+    );
+
+    logger.info(
+      `Created ${streams.length} stream objects in ${getTimeTakenSincePoint(streamsStartTime)}`
+    );
+    logger.info(
+      `Total time taken to get streams: ${getTimeTakenSincePoint(startTime)}`
+    );
+    return streams;
+  }
+
+  private shouldProxyStream(
+    stream: ParsedStream,
+    mediaFlowConfig: ReturnType<typeof getMediaFlowConfig>,
+    stremThruConfig: ReturnType<typeof getStremThruConfig>
+  ): boolean {
+    if (!stream.url) return false;
+
+    const streamProvider = stream.provider ? stream.provider.id : 'none';
+
+    // // now check if mediaFlowConfig.proxiedAddons or mediaFlowConfig.proxiedServices is not null
+    // logger.info(this.config.mediaFlowConfig?.proxiedAddons);
+    // logger.info(stream.addon.id);
+    if (
+      mediaFlowConfig.mediaFlowEnabled &&
+      (!mediaFlowConfig.proxiedAddons?.length ||
+        mediaFlowConfig.proxiedAddons.includes(stream.addon.id)) &&
+      (!mediaFlowConfig.proxiedServices?.length ||
+        mediaFlowConfig.proxiedServices.includes(streamProvider))
+    ) {
+      return true;
+    }
+
+    if (
+      stremThruConfig.stremThruEnabled &&
+      (!stremThruConfig.proxiedAddons?.length ||
+        stremThruConfig.proxiedAddons.includes(stream.addon.id)) &&
+      (!stremThruConfig.proxiedServices?.length ||
+        stremThruConfig.proxiedServices.includes(streamProvider))
+    ) {
+      return true;
+    }
+
+    return false;
+  }
+
+  private getFormattedText(parsedStream: ParsedStream): {
+    name: string;
+    description: string;
+  } {
+    switch (this.config.formatter) {
+      case 'gdrive': {
+        return gdriveFormat(parsedStream, false);
+      }
+      case 'minimalistic-gdrive': {
+        return gdriveFormat(parsedStream, true);
+      }
+      case 'imposter': {
+        return imposterFormat(parsedStream);
+      }
+      case 'torrentio': {
+        return torrentioFormat(parsedStream);
+      }
+      case 'torbox': {
+        return torboxFormat(parsedStream);
+      }
+      default: {
+        if (
+          this.config.formatter.startsWith('custom:') &&
+          this.config.formatter.length > 7
+        ) {
+          const jsonString = this.config.formatter.slice(7);
+          const formatter = JSON.parse(jsonString);
+          if (formatter.name && formatter.description) {
+            try {
+              return customFormat(parsedStream, formatter);
+            } catch (error: any) {
+              logger.error(
+                `Error in custom formatter: ${error.message || error}, falling back to default formatter`
+              );
+              return gdriveFormat(parsedStream, false);
+            }
+          }
+        }
+
+        return gdriveFormat(parsedStream, false);
+      }
+    }
+  }
+
+  private async createStreamObjects(
+    parsedStreams: ParsedStream[]
+  ): Promise<Stream[]> {
+    const mediaFlowConfig = getMediaFlowConfig(this.config);
+    const stremThruConfig = getStremThruConfig(this.config);
+
+    // Identify streams that require proxying
+    const streamsToProxy = parsedStreams
+      .map((stream, index) => ({ stream, index }))
+      .filter(
+        ({ stream }) =>
+          stream.url &&
+          this.shouldProxyStream(stream, mediaFlowConfig, stremThruConfig)
+      );
+
+    const proxiedUrls = streamsToProxy.length
+      ? mediaFlowConfig.mediaFlowEnabled
+        ? await generateMediaFlowStreams(
+            mediaFlowConfig,
+            streamsToProxy.map(({ stream }) => ({
+              url: stream.url!,
+              filename: stream.filename,
+              headers: stream.stream?.behaviorHints?.proxyHeaders,
+            }))
+          )
+        : stremThruConfig.stremThruEnabled
+          ? await generateStremThruStreams(
+              stremThruConfig,
+              streamsToProxy.map(({ stream }) => ({
+                url: stream.url!,
+                filename: stream.filename,
+                headers: stream.stream?.behaviorHints?.proxyHeaders,
+              }))
+            )
+          : null
+      : null;
+
+    const removeIndexes = new Set<number>();
+
+    // Apply proxied URLs and mark as proxied
+    streamsToProxy.forEach(({ stream, index }, i) => {
+      const proxiedUrl = proxiedUrls?.[i];
+      if (proxiedUrl) {
+        stream.url = proxiedUrl;
+        stream.proxied = true;
+      } else {
+        removeIndexes.add(index);
+      }
+    });
+
+    // Remove streams that failed to proxy
+    if (removeIndexes.size > 0) {
+      logger.error(
+        `Failed to proxy ${removeIndexes.size} streams, removing them from the final list`
+      );
+      parsedStreams = parsedStreams.filter(
+        (_, index) => !removeIndexes.has(index)
+      );
+    }
+
+    // Build final Stream objects
+    const proxyBingeGroupPrefix = mediaFlowConfig.mediaFlowEnabled
+      ? 'mfp.'
+      : stremThruConfig.stremThruEnabled
+        ? 'st.'
+        : '';
+    const streamObjects: Stream[] = await Promise.all(
+      parsedStreams.map((parsedStream) => {
+        const { name, description } = this.getFormattedText(parsedStream);
+
+        const combinedTags = [
+          parsedStream.resolution,
+          parsedStream.quality,
+          parsedStream.encode,
+          ...parsedStream.visualTags,
+          ...parsedStream.audioTags,
+          ...parsedStream.languages,
+        ];
+
+        return {
+          url: parsedStream.url,
+          externalUrl: parsedStream.externalUrl,
+          infoHash: parsedStream.torrent?.infoHash,
+          fileIdx: parsedStream.torrent?.fileIdx,
+          name,
+          description,
+          subtitles: parsedStream.stream?.subtitles,
+          sources: parsedStream.torrent?.sources,
+          behaviorHints: {
+            videoSize: parsedStream.size
+              ? Math.floor(parsedStream.size)
+              : undefined,
+            filename: parsedStream.filename,
+            bingeGroup: `${parsedStream.proxied ? proxyBingeGroupPrefix : ''}${Settings.ADDON_ID}|${parsedStream.addon.name}|${combinedTags.join('|')}`,
+            proxyHeaders: parsedStream.stream?.behaviorHints?.proxyHeaders,
+            notWebReady: parsedStream.stream?.behaviorHints?.notWebReady,
+          },
+        };
+      })
+    );
+
+    return streamObjects;
+  }
+
+  private compareLanguages(a: ParsedStream, b: ParsedStream) {
+    if (this.config.prioritiseLanguage) {
+      const aHasPrioritisedLanguage = a.languages.includes(
+        this.config.prioritiseLanguage
+      );
+      const bHasPrioritisedLanguage = b.languages.includes(
+        this.config.prioritiseLanguage
+      );
+
+      if (aHasPrioritisedLanguage && !bHasPrioritisedLanguage) return -1;
+      if (!aHasPrioritisedLanguage && bHasPrioritisedLanguage) return 1;
+    }
+    return 0;
+  }
+
+  private compareByField(a: ParsedStream, b: ParsedStream, field: string) {
+    if (field === 'resolution') {
+      return (
+        this.config.resolutions.findIndex(
+          (resolution) => resolution[a.resolution]
+        ) -
+        this.config.resolutions.findIndex(
+          (resolution) => resolution[b.resolution]
+        )
+      );
+    } else if (field === 'regexSort') {
+      const regexSortPatterns =
+        this.config.regexSortPatterns || Settings.DEFAULT_REGEX_SORT_PATTERNS;
+      if (!regexSortPatterns) return 0;
+      try {
+        // Get direction once
+        const direction = this.config.sortBy.find(
+          (sort) => Object.keys(sort)[0] === 'regexSort'
+        )?.direction;
+
+        // Early exit if no filename to test
+        if (!a.filename && !b.filename) return 0;
+        if (!a.filename) return direction === 'asc' ? -1 : 1;
+        if (!b.filename) return direction === 'asc' ? 1 : -1;
+
+        const aHighestIndex = a.regexMatched?.index;
+        const bHighestIndex = b.regexMatched?.index;
+
+        // If both have a regex match, sort by the highest index
+        if (aHighestIndex !== undefined && bHighestIndex !== undefined) {
+          return direction === 'asc'
+            ? bHighestIndex - aHighestIndex
+            : aHighestIndex - bHighestIndex;
+        }
+        // If one has a regex match and the other doesn't, sort by the one that does
+        if (aHighestIndex !== undefined) return direction === 'asc' ? 1 : -1;
+        if (bHighestIndex !== undefined) return direction === 'asc' ? -1 : 1;
+
+        // If both have no regex match, they are equal
+        return 0;
+      } catch (e) {
+        return 0;
+      }
+    } else if (field === 'cached') {
+      let aCanbeCached = a.provider;
+      let bCanbeCached = b.provider;
+      let aCached = a.provider?.cached;
+      let bCached = b.provider?.cached;
+
+      // prioritise non debrid/usenet p2p over uncached
+      if (aCanbeCached && !bCanbeCached && !aCached) return 1;
+      if (!aCanbeCached && bCanbeCached && !bCached) return -1;
+      if (aCanbeCached && bCanbeCached) {
+        if (aCached === bCached) return 0;
+        // prioritise a false value over undefined
+        if (aCached === false && bCached === undefined) return -1;
+        if (aCached === undefined && bCached === false) return 1;
+        return this.config.sortBy.find(
+          (sort) => Object.keys(sort)[0] === 'cached'
+        )?.direction === 'asc'
+          ? aCached
+            ? 1
+            : -1 // uncached > cached
+          : aCached
+            ? -1
+            : 1; // cached > uncached
+      }
+    } else if (field === 'personal') {
+      // depending on direction, sort by personal or not personal
+      const direction = this.config.sortBy.find(
+        (sort) => Object.keys(sort)[0] === 'personal'
+      )?.direction;
+      if (direction === 'asc') {
+        // prefer not personal over personal
+        return a.personal === b.personal ? 0 : a.personal ? 1 : -1;
+      }
+      if (direction === 'desc') {
+        // prefer personal over not personal
+        return a.personal === b.personal ? 0 : a.personal ? -1 : 1;
+      }
+    } else if (field === 'service') {
+      // sort files with providers by name
+      let aProvider = a.provider?.id;
+      let bProvider = b.provider?.id;
+
+      if (aProvider && bProvider) {
+        const aIndex = this.config.services.findIndex(
+          (service) => service.id === aProvider
+        );
+        const bIndex = this.config.services.findIndex(
+          (service) => service.id === bProvider
+        );
+        return aIndex - bIndex;
+      }
+    } else if (field === 'size') {
+      return this.config.sortBy.find((sort) => Object.keys(sort)[0] === 'size')
+        ?.direction === 'asc'
+        ? (a.size || 0) - (b.size || 0)
+        : (b.size || 0) - (a.size || 0);
+    } else if (field === 'seeders') {
+      if (
+        a.torrent?.seeders !== undefined &&
+        b.torrent?.seeders !== undefined
+      ) {
+        return this.config.sortBy.find(
+          (sort) => Object.keys(sort)[0] === 'seeders'
+        )?.direction === 'asc'
+          ? a.torrent.seeders - b.torrent.seeders
+          : b.torrent.seeders - a.torrent.seeders;
+      } else if (
+        a.torrent?.seeders !== undefined &&
+        b.torrent?.seeders === undefined
+      ) {
+        return -1;
+      } else if (
+        a.torrent?.seeders === undefined &&
+        b.torrent?.seeders !== undefined
+      ) {
+        return 1;
+      }
+    } else if (field === 'streamType') {
+      return (
+        (this.config.streamTypes?.findIndex(
+          (streamType) => streamType[a.type]
+        ) ?? -1) -
+        (this.config.streamTypes?.findIndex(
+          (streamType) => streamType[b.type]
+        ) ?? -1)
+      );
+    } else if (field === 'quality') {
+      return (
+        this.config.qualities.findIndex((quality) => quality[a.quality]) -
+        this.config.qualities.findIndex((quality) => quality[b.quality])
+      );
+    } else if (field === 'visualTag') {
+      // Find the highest priority visual tag in each file
+      const getIndexOfTag = (tag: string) =>
+        this.config.visualTags.findIndex((t) => t[tag]);
+
+      const getHighestPriorityTagIndex = (tags: string[]) => {
+        // Check if the file contains both any HDR tag and DV
+        const hasHDR = tags.some((tag) => tag.startsWith('HDR'));
+        const hasDV = tags.includes('DV');
+
+        if (hasHDR && hasDV) {
+          // Sort according to the position of the HDR+DV tag
+          const hdrDvIndex = this.config.visualTags.findIndex(
+            (t) => t['HDR+DV']
+          );
+          if (hdrDvIndex !== -1) {
+            return hdrDvIndex;
+          }
+        }
+
+        // If the file contains multiple HDR tags, look at the HDR tag that has the highest priority
+        const hdrTagIndices = tags
+          .filter((tag) => tag.startsWith('HDR'))
+          .map((tag) => getIndexOfTag(tag));
+        if (hdrTagIndices.length > 0) {
+          return Math.min(...hdrTagIndices);
+        }
+
+        // Always consider the highest priority visual tag when a file has multiple visual tags
+        return tags.reduce(
+          (minIndex, tag) => Math.min(minIndex, getIndexOfTag(tag)),
+          this.config.visualTags.length
+        );
+      };
+
+      const aVisualTagIndex = getHighestPriorityTagIndex(a.visualTags);
+      const bVisualTagIndex = getHighestPriorityTagIndex(b.visualTags);
+
+      // Sort by the visual tag index
+      return aVisualTagIndex - bVisualTagIndex;
+    } else if (field === 'audioTag') {
+      // Find the highest priority audio tag in each file
+      const getIndexOfTag = (tag: string) =>
+        this.config.audioTags.findIndex((t) => t[tag]);
+      const aAudioTagIndex = a.audioTags.reduce(
+        (minIndex, tag) => Math.min(minIndex, getIndexOfTag(tag)),
+        this.config.audioTags.length
+      );
+
+      const bAudioTagIndex = b.audioTags.reduce(
+        (minIndex, tag) => Math.min(minIndex, getIndexOfTag(tag)),
+        this.config.audioTags.length
+      );
+      // Sort by the audio tag index
+      return aAudioTagIndex - bAudioTagIndex;
+    } else if (field === 'encode') {
+      return (
+        this.config.encodes.findIndex((encode) => encode[a.encode]) -
+        this.config.encodes.findIndex((encode) => encode[b.encode])
+      );
+    } else if (field === 'addon') {
+      const aAddon = a.addon.id;
+      const bAddon = b.addon.id;
+
+      const addonIds = this.config.addons.map((addon) => {
+        return `${addon.id}-${JSON.stringify(addon.options)}`;
+      });
+      return addonIds.indexOf(aAddon) - addonIds.indexOf(bAddon);
+    } else if (field === 'language') {
+      if (this.config.prioritiseLanguage) {
+        return this.compareLanguages(a, b);
+      }
+      if (!this.config.prioritisedLanguages) {
+        return 0;
+      }
+      // else, we look at the array of prioritisedLanguages.
+      // any file with a language in the prioritisedLanguages array should be prioritised
+      // if both files contain a prioritisedLanguage, we compare the index of the highest priority language
+
+      const aHasPrioritisedLanguage =
+        a.languages.some((lang) =>
+          this.config.prioritisedLanguages?.includes(lang)
+        ) ||
+        (a.languages.length === 0 &&
+          this.config.prioritisedLanguages?.includes('Unknown'));
+      const bHasPrioritisedLanguage =
+        b.languages.some((lang) =>
+          this.config.prioritisedLanguages?.includes(lang)
+        ) ||
+        (b.languages.length === 0 &&
+          this.config.prioritisedLanguages?.includes('Unknown'));
+
+      if (aHasPrioritisedLanguage && !bHasPrioritisedLanguage) return -1;
+      if (!aHasPrioritisedLanguage && bHasPrioritisedLanguage) return 1;
+
+      if (aHasPrioritisedLanguage && bHasPrioritisedLanguage) {
+        const getHighestPriorityLanguageIndex = (languages: string[]) => {
+          if (languages.length === 0) {
+            const unknownIndex =
+              this.config.prioritisedLanguages!.indexOf('Unknown');
+            return unknownIndex !== -1
+              ? unknownIndex
+              : this.config.prioritisedLanguages!.length;
+          }
+          return languages.reduce((minIndex, lang) => {
+            const index =
+              this.config.prioritisedLanguages?.indexOf(lang) ??
+              this.config.prioritisedLanguages!.length;
+            return index !== -1 ? Math.min(minIndex, index) : minIndex;
+          }, this.config.prioritisedLanguages!.length);
+        };
+
+        const aHighestPriorityLanguageIndex = getHighestPriorityLanguageIndex(
+          a.languages
+        );
+        const bHighestPriorityLanguageIndex = getHighestPriorityLanguageIndex(
+          b.languages
+        );
+
+        return aHighestPriorityLanguageIndex - bHighestPriorityLanguageIndex;
+      }
+    }
+    return 0;
+  }
+
+  private async getParsedStreams(
+    streamRequest: StreamRequest
+  ): Promise<{ parsedStreams: ParsedStream[]; errorStreams: ErrorStream[] }> {
+    const parsedStreams: ParsedStream[] = [];
+    const errorStreams: ErrorStream[] = [];
+    const formatError = (error: string) =>
+      typeof error === 'string'
+        ? error
+            .replace(/- |: /g, '\n')
+            .split('\n')
+            .map((line: string) => line.trim())
+            .join('\n')
+            .trim()
+        : error;
+
+    const addonPromises = this.config.addons.map(async (addon) => {
+      const addonName =
+        addon.options.name ||
+        addon.options.overrideName ||
+        addonDetails.find((addonDetail) => addonDetail.id === addon.id)?.name ||
+        addon.id;
+      const addonId = `${addon.id}-${JSON.stringify(addon.options)}`;
+      try {
+        const startTime = new Date().getTime();
+        const { addonStreams, addonErrors } = await this.getStreamsFromAddon(
+          addon,
+          addonId,
+          streamRequest
+        );
+        parsedStreams.push(...addonStreams);
+        errorStreams.push(
+          ...[...new Set(addonErrors)].map((error) => ({
+            error: formatError(error),
+            addon: { id: addonId, name: addonName },
+          }))
+        );
+        logger.info(
+          `Got ${addonStreams.length} streams ${addonErrors.length > 0 ? `and ${addonErrors.length} errors ` : ''}from addon ${addonName} in ${getTimeTakenSincePoint(startTime)}`
+        );
+      } catch (error: any) {
+        logger.error(`Failed to get streams from ${addonName}: ${error}`);
+        errorStreams.push({
+          error: formatError(error.message ?? error ?? 'Unknown error'),
+          addon: {
+            id: addonId,
+            name: addonName,
+          },
+        });
+      }
+    });
+
+    await Promise.all(addonPromises);
+    return { parsedStreams, errorStreams };
+  }
+
+  private async getStreamsFromAddon(
+    addon: Config['addons'][0],
+    addonId: string,
+    streamRequest: StreamRequest
+  ): Promise<{ addonStreams: ParsedStream[]; addonErrors: string[] }> {
+    switch (addon.id) {
+      case 'torbox': {
+        return await getTorboxStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'torrentio': {
+        return await getTorrentioStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'comet': {
+        return await getCometStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'mediafusion': {
+        return await getMediafusionStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'stremio-jackett': {
+        return await getStremioJackettStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'jackettio': {
+        return await getJackettioStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'orion-stremio-addon': {
+        return await getOrionStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'easynews': {
+        return await getEasynewsStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'easynews-plus': {
+        return await getEasynewsPlusStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'easynews-plus-plus': {
+        return await getEasynewsPlusPlusStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'debridio': {
+        return await getDebridioStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'peerflix': {
+        return await getPeerflixStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'stremthru-store': {
+        return await getStremThruStoreStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'dmm-cast': {
+        return await getDMMCastStreams(
+          this.config,
+          addon.options,
+          streamRequest,
+          addonId
+        );
+      }
+      case 'gdrive': {
+        if (!addon.options.addonUrl) {
+          throw new Error('The addon URL was undefined for GDrive');
+        }
+        const wrapper = new BaseWrapper(
+          addon.options.overrideName || 'GDrive',
+          addon.options.addonUrl,
+          addonId,
+          this.config,
+          addon.options.indexerTimeout
+            ? parseInt(addon.options.indexerTimeout)
+            : Settings.DEFAULT_GDRIVE_TIMEOUT
+        );
+        return await wrapper.getParsedStreams(streamRequest);
+      }
+      default: {
+        if (!addon.options.url) {
+          throw new Error(
+            `The addon URL was undefined for ${addon.options.name}`
+          );
+        }
+        const wrapper = new BaseWrapper(
+          addon.options.name || 'Custom',
+          addon.options.url.trim(),
+          addonId,
+          this.config,
+          addon.options.indexerTimeout
+            ? parseInt(addon.options.indexerTimeout)
+            : undefined
+        );
+        return wrapper.getParsedStreams(streamRequest);
+      }
+    }
+  }
+  private async processGroupedStreams(
+    groupedStreams: Record<string, ParsedStream[]>
+  ) {
+    const uniqueStreams: ParsedStream[] = [];
+    Object.values(groupedStreams).forEach((groupedStreams) => {
+      if (groupedStreams.length === 1) {
+        uniqueStreams.push(groupedStreams[0]);
+        return;
+      }
+
+      /*logger.info(
+        `==================\nDetermining unique streams for ${groupedStreams[0].filename} from ${groupedStreams.length} total duplicates`
+      );
+      logger.info(
+        groupedStreams.map(
+          (stream) =>
+            `Addon ID: ${stream.addon.id}, Provider ID: ${stream.provider?.id}, Provider Cached: ${stream.provider?.cached}, type: ${stream.torrent ? 'torrent' : 'usenet'}`
+        )
+      );
+      logger.info('==================');*/
+      // Separate streams into categories
+      const cachedStreams = groupedStreams.filter(
+        (stream) => stream.provider?.cached || (!stream.provider && stream.url)
+      );
+      const uncachedStreams = groupedStreams.filter(
+        (stream) => stream.provider && !stream.provider.cached
+      );
+      const noProviderStreams = groupedStreams.filter(
+        (stream) => !stream.provider && stream.torrent?.infoHash
+      );
+
+      // Select uncached streams by addon priority (one per provider)
+      const selectedUncachedStreams = Object.values(
+        uncachedStreams.reduce(
+          (acc, stream) => {
+            acc[stream.provider!.id] = acc[stream.provider!.id] || [];
+            acc[stream.provider!.id].push(stream);
+            return acc;
+          },
+          {} as Record<string, ParsedStream[]>
+        )
+      ).map((providerGroup) => {
+        return providerGroup.sort((a, b) => {
+          const aIndex = this.config.addons.findIndex(
+            (addon) =>
+              `${addon.id}-${JSON.stringify(addon.options)}` === a.addon.id
+          );
+          const bIndex = this.config.addons.findIndex(
+            (addon) =>
+              `${addon.id}-${JSON.stringify(addon.options)}` === b.addon.id
+          );
+          return aIndex - bIndex;
+        })[0];
+      });
+      //selectedUncachedStreams.forEach(stream => logger.info(`Selected uncached stream for provider ${stream.provider!.id}: Addon ID: ${stream.addon.id}`));
+
+      // Select cached streams by provider and addon priority
+      const selectedCachedStream = cachedStreams.sort((a, b) => {
+        const aProviderIndex = this.config.services.findIndex(
+          (service) => service.id === a.provider?.id
+        );
+        const bProviderIndex = this.config.services.findIndex(
+          (service) => service.id === b.provider?.id
+        );
+
+        if (aProviderIndex !== bProviderIndex) {
+          return aProviderIndex - bProviderIndex;
+        }
+
+        const aAddonIndex = this.config.addons.findIndex(
+          (addon) =>
+            `${addon.id}-${JSON.stringify(addon.options)}` === a.addon.id
+        );
+        const bAddonIndex = this.config.addons.findIndex(
+          (addon) =>
+            `${addon.id}-${JSON.stringify(addon.options)}` === b.addon.id
+        );
+
+        if (aAddonIndex !== bAddonIndex) {
+          return aAddonIndex - bAddonIndex;
+        }
+
+        // now look at the type of stream. prefer usenet over torrents
+        if (a.torrent?.seeders && !b.torrent?.seeders) return 1;
+        if (!a.torrent?.seeders && b.torrent?.seeders) return -1;
+        return 0;
+      })[0];
+      // Select one non-provider stream (highest addon priority)
+      const selectedNoProviderStream = noProviderStreams.sort((a, b) => {
+        const aIndex = this.config.addons.findIndex(
+          (addon) =>
+            `${addon.id}-${JSON.stringify(addon.options)}` === a.addon.id
+        );
+        const bIndex = this.config.addons.findIndex(
+          (addon) =>
+            `${addon.id}-${JSON.stringify(addon.options)}` === b.addon.id
+        );
+
+        if (aIndex !== bIndex) {
+          return aIndex - bIndex;
+        }
+
+        // now look at the type of stream. prefer usenet over torrents
+        if (a.torrent?.seeders && !b.torrent?.seeders) return 1;
+        if (!a.torrent?.seeders && b.torrent?.seeders) return -1;
+        return 0;
+      })[0];
+
+      // Combine selected streams for this group
+      if (selectedNoProviderStream) {
+        //logger.info(`Selected no provider stream: Addon ID: ${selectedNoProviderStream.addon.id}`);
+        uniqueStreams.push(selectedNoProviderStream);
+      }
+      if (selectedCachedStream) {
+        //logger.info(`Selected cached stream for provider ${selectedCachedStream.provider!.id} from Addon ID: ${selectedCachedStream.addon.id}`);
+        uniqueStreams.push(selectedCachedStream);
+      }
+      uniqueStreams.push(...selectedUncachedStreams);
+    });
+
+    return uniqueStreams;
+  }
+}

packages/addon/src/config.ts

@@ -0,0 +1,537 @@
+import { AddonDetail, Config } from '@aiostreams/types';
+import {
+  addonDetails,
+  isValueEncrypted,
+  parseAndDecryptString,
+  serviceDetails,
+  Settings,
+  unminifyConfig,
+} from '@aiostreams/utils';
+
+export const allowedFormatters = [
+  'gdrive',
+  'minimalistic-gdrive',
+  'torrentio',
+  'torbox',
+  'imposter',
+  'custom',
+];
+
+export const allowedLanguages = [
+  'Multi',
+  'English',
+  'Japanese',
+  'Chinese',
+  'Russian',
+  'Arabic',
+  'Portuguese',
+  'Spanish',
+  'French',
+  'German',
+  'Italian',
+  'Korean',
+  'Hindi',
+  'Bengali',
+  'Punjabi',
+  'Marathi',
+  'Gujarati',
+  'Tamil',
+  'Telugu',
+  'Kannada',
+  'Malayalam',
+  'Thai',
+  'Vietnamese',
+  'Indonesian',
+  'Turkish',
+  'Hebrew',
+  'Persian',
+  'Ukrainian',
+  'Greek',
+  'Lithuanian',
+  'Latvian',
+  'Estonian',
+  'Polish',
+  'Czech',
+  'Slovak',
+  'Hungarian',
+  'Romanian',
+  'Bulgarian',
+  'Serbian',
+  'Croatian',
+  'Slovenian',
+  'Dutch',
+  'Danish',
+  'Finnish',
+  'Swedish',
+  'Norwegian',
+  'Malay',
+  'Latino',
+  'Unknown',
+  'Dual Audio',
+  'Dubbed',
+];
+
+export function validateConfig(
+  config: Config,
+  environment: 'client' | 'server' = 'server'
+): {
+  valid: boolean;
+  errorCode: string | null;
+  errorMessage: string | null;
+} {
+  config = unminifyConfig(config);
+  const createResponse = (
+    valid: boolean,
+    errorCode: string | null,
+    errorMessage: string | null
+  ) => {
+    return { valid, errorCode, errorMessage };
+  };
+
+  if (config.addons.length < 1) {
+    return createResponse(
+      false,
+      'noAddons',
+      'At least one addon must be selected'
+    );
+  }
+
+  if (config.addons.length > Settings.MAX_ADDONS) {
+    return createResponse(
+      false,
+      'tooManyAddons',
+      `You can only select a maximum of ${Settings.MAX_ADDONS} addons`
+    );
+  }
+  // check for apiKey if Settings.API_KEY is set
+  if (environment === 'server' && Settings.API_KEY) {
+    const { apiKey } = config;
+    if (!apiKey) {
+      return createResponse(
+        false,
+        'missingApiKey',
+        'The AIOStreams API key is required'
+      );
+    }
+    let decryptedApiKey = apiKey;
+    if (isValueEncrypted(apiKey)) {
+      const decryptionResult = parseAndDecryptString(apiKey);
+      if (decryptionResult === null) {
+        return createResponse(
+          false,
+          'decryptionFailed',
+          'Failed to decrypt the AIOStreams API key'
+        );
+      } else if (decryptionResult === '') {
+        return createResponse(
+          false,
+          'emptyDecryption',
+          'Decrypted API key is empty'
+        );
+      }
+      decryptedApiKey = decryptionResult;
+    }
+    if (decryptedApiKey !== Settings.API_KEY) {
+      return createResponse(
+        false,
+        'invalidApiKey',
+        'Invalid AIOStreams API key. Please use the one defined in your environment variables'
+      );
+    }
+  }
+  const duplicateAddons = config.addons.filter(
+    (addon, index) =>
+      config.addons.findIndex(
+        (a) =>
+          a.id === addon.id &&
+          JSON.stringify(a.options) === JSON.stringify(addon.options)
+      ) !== index
+  );
+
+  if (duplicateAddons.length > 0) {
+    return createResponse(
+      false,
+      'duplicateAddons',
+      'Duplicate addons found. Please remove any duplicates'
+    );
+  }
+
+  for (const addon of config.addons) {
+    if (Settings.DISABLE_TORRENTIO && addon.id === 'torrentio') {
+      return createResponse(
+        false,
+        'torrentioDisabled',
+        Settings.DISABLE_TORRENTIO_MESSAGE
+      );
+    }
+
+    const details = addonDetails.find(
+      (detail: AddonDetail) => detail.id === addon.id
+    );
+    if (!details) {
+      return createResponse(
+        false,
+        'invalidAddon',
+        `Invalid addon: ${addon.id}`
+      );
+    }
+    if (details.requiresService) {
+      const supportedServices = details.supportedServices;
+      const isAtLeastOneServiceEnabled = config.services.some(
+        (service) => supportedServices.includes(service.id) && service.enabled
+      );
+      const isOverrideUrlSet = addon.options?.overrideUrl;
+      if (!isAtLeastOneServiceEnabled && !isOverrideUrlSet) {
+        return createResponse(
+          false,
+          'missingService',
+          `${addon.options?.name || details.name} requires at least one of the following services to be enabled: ${supportedServices
+            .map(
+              (service) =>
+                serviceDetails.find((detail) => detail.id === service)?.name ||
+                service
+            )
+            .join(', ')}`
+        );
+      }
+    }
+    if (details.options) {
+      for (const option of details.options) {
+        if (option.required && !addon.options[option.id]) {
+          return createResponse(
+            false,
+            'missingRequiredOption',
+            `Option ${option.label} is required for addon ${addon.id}`
+          );
+        }
+
+        if (
+          option.id.toLowerCase().includes('url') &&
+          addon.options[option.id] &&
+          ((isValueEncrypted(addon.options[option.id]) &&
+            environment === 'server') ||
+            !isValueEncrypted(addon.options[option.id]))
+        ) {
+          const url = parseAndDecryptString(addon.options[option.id] ?? '');
+          if (url === null) {
+            return createResponse(
+              false,
+              'decryptionFailed',
+              `Failed to decrypt URL for ${option.label}`
+            );
+          } else if (url === '') {
+            return createResponse(
+              false,
+              'emptyDecryption',
+              `Decrypted URL for ${option.label} is empty`
+            );
+          }
+          if (
+            Settings.DISABLE_TORRENTIO &&
+            url.match(/torrentio\.strem\.fun/) !== null
+          ) {
+            // if torrentio is disabled, don't allow the user to set URLs with torrentio.strem.fun
+            return createResponse(
+              false,
+              'torrentioDisabled',
+              Settings.DISABLE_TORRENTIO_MESSAGE
+            );
+          } else if (
+            Settings.DISABLE_TORRENTIO &&
+            url.match(/stremthru\.elfhosted\.com/) !== null
+          ) {
+            // if torrentio is disabled, we need to inspect the stremthru URL to see if it's using torrentio
+            try {
+              const parsedUrl = new URL(url);
+              // get the component before manifest.json
+              const pathComponents = parsedUrl.pathname.split('/');
+              if (pathComponents.includes('manifest.json')) {
+                const index = pathComponents.indexOf('manifest.json');
+                const componentBeforeManifest = pathComponents[index - 1];
+                // base64 decode the component before manifest.json
+                const decodedComponent = atob(componentBeforeManifest);
+                const stremthruData = JSON.parse(decodedComponent);
+                if (stremthruData?.manifest_url?.match(/torrentio.strem.fun/)) {
+                  return createResponse(
+                    false,
+                    'torrentioDisabled',
+                    Settings.DISABLE_TORRENTIO_MESSAGE
+                  );
+                }
+              }
+            } catch (_) {
+              // ignore
+            }
+          } else {
+            try {
+              new URL(url);
+            } catch (_) {
+              return createResponse(
+                false,
+                'invalidUrl',
+                ` Invalid URL for ${option.label}`
+              );
+            }
+          }
+        }
+
+        if (option.type === 'number' && addon.options[option.id]) {
+          const input = addon.options[option.id];
+          if (input !== undefined && !parseInt(input)) {
+            return createResponse(
+              false,
+              'invalidNumber',
+              `${option.label} must be a number`
+            );
+          } else if (input !== undefined) {
+            const value = parseInt(input);
+            const { min, max } = option.constraints || {};
+            if (
+              (min !== undefined && value < min) ||
+              (max !== undefined && value > max)
+            ) {
+              return createResponse(
+                false,
+                'invalidNumber',
+                `${option.label} must be between ${min} and ${max}`
+              );
+            }
+          }
+        }
+      }
+    }
+  }
+
+  if (!allowedFormatters.includes(config.formatter)) {
+    if (config.formatter.startsWith('custom') && config.formatter.length > 7) {
+      const jsonString = config.formatter.slice(7);
+      const data = JSON.parse(jsonString);
+      if (!data.name || !data.description) {
+        return createResponse(
+          false,
+          'invalidCustomFormatter',
+          'Invalid custom formatter: name and description are required'
+        );
+      }
+    } else {
+      return createResponse(
+        false,
+        'invalidFormatter',
+        `Invalid formatter: ${config.formatter}`
+      );
+    }
+  }
+  for (const service of config.services) {
+    if (service.enabled) {
+      const serviceDetail = serviceDetails.find(
+        (detail) => detail.id === service.id
+      );
+      if (!serviceDetail) {
+        return createResponse(
+          false,
+          'invalidService',
+          `Invalid service: ${service.id}`
+        );
+      }
+      for (const credential of serviceDetail.credentials) {
+        if (!service.credentials[credential.id]) {
+          return createResponse(
+            false,
+            'missingCredential',
+            `${credential.label} is required for ${service.name}`
+          );
+        }
+      }
+    }
+  }
+
+  // need at least one visual tag, resolution, quality
+
+  if (
+    !config.visualTags.some((tag) => Object.values(tag)[0]) ||
+    !config.resolutions.some((resolution) => Object.values(resolution)[0]) ||
+    !config.qualities.some((quality) => Object.values(quality)[0])
+  ) {
+    return createResponse(
+      false,
+      'noFilters',
+      'At least one visual tag, resolution, and quality must be selected'
+    );
+  }
+
+  for (const [min, max] of [
+    [config.minMovieSize, config.maxMovieSize],
+    [config.minEpisodeSize, config.maxEpisodeSize],
+    [config.minSize, config.maxSize],
+  ]) {
+    if (min && max) {
+      if (min >= max) {
+        return createResponse(
+          false,
+          'invalidSizeRange',
+          "Your minimum size limit can't be greater than or equal to your maximum size limit"
+        );
+      }
+    }
+  }
+
+  if (config.maxResultsPerResolution && config.maxResultsPerResolution < 1) {
+    return createResponse(
+      false,
+      'invalidMaxResultsPerResolution',
+      'Max results per resolution must be greater than 0'
+    );
+  }
+
+  if (
+    config.mediaFlowConfig?.mediaFlowEnabled &&
+    config.stremThruConfig?.stremThruEnabled
+  ) {
+    return createResponse(
+      false,
+      'multipleProxyServices',
+      'Multiple proxy services are not allowed'
+    );
+  }
+  if (config.mediaFlowConfig?.mediaFlowEnabled) {
+    if (!config.mediaFlowConfig.proxyUrl) {
+      return createResponse(
+        false,
+        'missingProxyUrl',
+        'Proxy URL is required if MediaFlow is enabled'
+      );
+    }
+    if (!config.mediaFlowConfig.apiPassword) {
+      return createResponse(
+        false,
+        'missingApiPassword',
+        'API Password is required if MediaFlow is enabled'
+      );
+    }
+  }
+
+  if (config.stremThruConfig?.stremThruEnabled) {
+    if (!config.stremThruConfig.url) {
+      return createResponse(
+        false,
+        'missingUrl',
+        'URL is required if Stremthru is enabled'
+      );
+    }
+    if (!config.stremThruConfig.credential) {
+      return createResponse(
+        false,
+        'missingCredential',
+        'Credential is required if StremThru is enabled'
+      );
+    }
+  }
+
+  if (
+    (config.excludeFilters?.length ?? 0) > Settings.MAX_KEYWORD_FILTERS ||
+    (config.strictIncludeFilters?.length ?? 0) > Settings.MAX_KEYWORD_FILTERS
+  ) {
+    return createResponse(
+      false,
+      'tooManyFilters',
+      `You can only have a maximum of ${Settings.MAX_KEYWORD_FILTERS} filters`
+    );
+  }
+
+  const filters = [
+    ...(config.excludeFilters || []),
+    ...(config.strictIncludeFilters || []),
+  ];
+  filters.forEach((filter) => {
+    if (filter.length > 20) {
+      return createResponse(
+        false,
+        'invalidFilter',
+        'One of your filters is too long'
+      );
+    }
+    if (!filter) {
+      return createResponse(
+        false,
+        'invalidFilter',
+        'Filters must not be empty'
+      );
+    }
+  });
+
+  if (config.regexFilters) {
+    if (!config.apiKey) {
+      return createResponse(
+        false,
+        'missingApiKey',
+        'Regex filtering requires an API key to be set'
+      );
+    }
+
+    if (config.regexFilters.excludePattern) {
+      try {
+        new RegExp(config.regexFilters.excludePattern);
+      } catch (e) {
+        return createResponse(
+          false,
+          'invalidExcludeRegex',
+          'Invalid exclude regex pattern'
+        );
+      }
+    }
+
+    if (config.regexFilters.includePattern) {
+      try {
+        new RegExp(config.regexFilters.includePattern);
+      } catch (e) {
+        return createResponse(
+          false,
+          'invalidIncludeRegex',
+          'Invalid include regex pattern'
+        );
+      }
+    }
+  }
+
+  if (config.regexSortPatterns) {
+    if (!config.apiKey) {
+      return createResponse(
+        false,
+        'missingApiKey',
+        'Regex sorting requires an API key to be set'
+      );
+    }
+
+    // Split the pattern by spaces and validate each one
+    const patterns = config.regexSortPatterns.split(/\s+/).filter(Boolean);
+    // Enforce an upper bound on the number of patterns
+    if (patterns.length > Settings.MAX_REGEX_SORT_PATTERNS) {
+      return createResponse(
+        false,
+        'tooManyRegexSortPatterns',
+        `You can specify at most ${Settings.MAX_REGEX_SORT_PATTERNS} regex sort patterns`
+      );
+    }
+
+    for (const pattern of patterns) {
+      const delimiter = '<::>';
+      const delimiterIndex = pattern.indexOf(delimiter);
+      let name: string = 'Unamed';
+      let regexPattern = pattern;
+      if (delimiterIndex !== -1) {
+        name = pattern.slice(0, delimiterIndex).replace(/_/g, ' ');
+        regexPattern = pattern.slice(delimiterIndex + delimiter.length);
+      }
+      try {
+        new RegExp(regexPattern);
+      } catch (e) {
+        return createResponse(
+          false,
+          'invalidRegexSortPattern',
+          `Invalid regex sort pattern: ${name ? `"${name}" ` : ''}${regexPattern}`
+        );
+      }
+    }
+  }
+  return createResponse(true, null, null);
+}

packages/addon/src/index.ts

@@ -0,0 +1,4 @@
+export * from './addon';
+export * from './config';
+export * from './manifest';
+export * from './responses';

packages/addon/src/manifest.ts

@@ -0,0 +1,37 @@
+import { Config } from '@aiostreams/types';
+import { version, description } from '../../../package.json';
+import { getTextHash, Settings } from '@aiostreams/utils';
+
+const manifest = (config?: Config, configPresent?: boolean) => {
+  let addonId = Settings.ADDON_ID;
+  if (config && Settings.DETERMINISTIC_ADDON_ID) {
+    addonId =
+      addonId += `.${getTextHash(JSON.stringify(config)).substring(0, 12)}`;
+  }
+  return {
+    name: config?.overrideName || Settings.ADDON_NAME,
+    id: addonId,
+    version: version,
+    description: description,
+    catalogs: [],
+    resources: ['stream'],
+    background:
+      'https://raw.githubusercontent.com/Viren070/AIOStreams/refs/heads/main/packages/frontend/public/assets/background.png',
+    logo: 'https://raw.githubusercontent.com/Viren070/AIOStreams/refs/heads/main/packages/frontend/public/assets/logo.png',
+    types: ['movie', 'series'],
+    behaviorHints: {
+      configurable: true,
+      configurationRequired: config || configPresent ? false : true,
+    },
+    stremioAddonsConfig:
+      Settings.STREMIO_ADDONS_CONFIG_ISSUER &&
+      Settings.STREMIO_ADDONS_CONFIG_SIGNATURE
+        ? {
+            issuer: Settings.STREMIO_ADDONS_CONFIG_ISSUER,
+            signature: Settings.STREMIO_ADDONS_CONFIG_SIGNATURE,
+          }
+        : undefined,
+  };
+};
+
+export default manifest;

packages/addon/src/responses.ts

@@ -0,0 +1,29 @@
+import { Settings } from '@aiostreams/utils';
+
+export const errorResponse = (
+  errorMessage: string,
+  origin?: string,
+  path?: string,
+  externalUrl?: string
+) => {
+  return {
+    streams: [errorStream(errorMessage, 'Error', origin, path, externalUrl)],
+  };
+};
+
+export const errorStream = (
+  errorMessage: string,
+  errorTitle?: string,
+  origin?: string,
+  path?: string,
+  externalUrl?: string
+) => {
+  return {
+    externalUrl:
+      (origin && path ? origin + path : undefined) ||
+      externalUrl ||
+      'https://github.com/Viren070/AIOStreams',
+    name: `[❌] ${Settings.ADDON_NAME}\n${errorTitle || 'Error'}`,
+    description: errorMessage,
+  };
+};

packages/addon/src/server.ts

@@ -0,0 +1,645 @@
+import express, { Request, Response } from 'express';
+
+import path from 'path';
+import { AIOStreams } from './addon';
+import { Config, StreamRequest } from '@aiostreams/types';
+import { validateConfig } from './config';
+import manifest from './manifest';
+import { errorResponse } from './responses';
+import {
+  Settings,
+  addonDetails,
+  parseAndDecryptString,
+  Cache,
+  unminifyConfig,
+  minifyConfig,
+  crushJson,
+  compressData,
+  encryptData,
+  decompressData,
+  decryptData,
+  uncrushJson,
+  loadSecretKey,
+  createLogger,
+  getTimeTakenSincePoint,
+  isValueEncrypted,
+  maskSensitiveInfo,
+} from '@aiostreams/utils';
+
+const logger = createLogger('server');
+
+const app = express();
+//logger.info(`Starting server and loading settings...`);
+logger.info('Starting server and loading settings...', { func: 'init' });
+Object.entries(Settings).forEach(([key, value]) => {
+  switch (key) {
+    case 'SECRET_KEY':
+      if (value) {
+        logger.info(`${key} = ${value.replace(/./g, '*').slice(0, 64)}`);
+      }
+      break;
+
+    case 'BRANDING':
+    case 'CUSTOM_CONFIGS':
+      // Skip CUSTOM_CONFIGS processing here, handled later
+      break;
+
+    default:
+      logger.info(`${key} = ${value}`);
+  }
+});
+
+// attempt to load the secret key
+try {
+  if (Settings.SECRET_KEY) loadSecretKey(true);
+} catch (error: any) {
+  // determine command to run based on system OS
+  const command =
+    process.platform === 'win32'
+      ? '[System.Guid]::NewGuid().ToString("N").Substring(0, 32) + [System.Guid]::NewGuid().ToString("N").Substring(0, 32)'
+      : 'openssl rand -hex 32';
+  logger.error(
+    `The secret key is invalid. You will not be able to generate configurations. You can generate a new secret key by running the following command\n${command}`
+  );
+}
+
+// Built-in middleware for parsing JSON
+app.use(express.json());
+// Built-in middleware for parsing URL-encoded data
+app.use(express.urlencoded({ extended: true }));
+
+// unhandled errors
+app.use((err: any, req: Request, res: Response, next: any) => {
+  logger.error(`${err.message}`);
+  res.status(500).send('Internal server error');
+});
+
+app.use((req, res, next) => {
+  res.append('Access-Control-Allow-Origin', '*');
+  res.append('Access-Control-Allow-Methods', 'GET,PUT,POST,DELETE');
+  const start = Date.now();
+  res.on('finish', () => {
+    logger.info(
+      `${req.method} ${req.path
+        .replace(/\/ey[JI][\w\=]+/g, '/*******')
+        .replace(
+          /\/(E2?|B)?-[\w-\%]+/g,
+          '/*******'
+        )} - ${getIp(req) ? maskSensitiveInfo(getIp(req)!) : 'Unknown IP'} - ${res.statusCode} - ${getTimeTakenSincePoint(start)}`
+    );
+  });
+  next();
+});
+
+app.get('/', (req, res) => {
+  res.redirect('/configure');
+});
+
+app.get(
+  ['/_next/*', '/assets/*', '/icon.ico', '/configure.txt'],
+  (req, res) => {
+    res.sendFile(path.join(__dirname, '../../frontend/out', req.path));
+  }
+);
+
+if (!Settings.DISABLE_CUSTOM_CONFIG_GENERATOR_ROUTE) {
+  app.get('/custom-config-generator', (req, res) => {
+    res.sendFile(
+      path.join(__dirname, '../../frontend/out/custom-config-generator.html')
+    );
+  });
+}
+
+app.get('/configure', (req, res) => {
+  res.sendFile(path.join(__dirname, '../../frontend/out/configure.html'));
+});
+
+app.get('/:config/configure', (req, res) => {
+  const config = req.params.config;
+  if (config.startsWith('eyJ') || config.startsWith('eyI')) {
+    return res.sendFile(
+      path.join(__dirname, '../../frontend/out/configure.html')
+    );
+  }
+  try {
+    let configJson = extractJsonConfig(config);
+    let configString = config;
+    if (Settings.CUSTOM_CONFIGS) {
+      const customConfig = extractCustomConfig(config);
+      if (customConfig) {
+        configJson = customConfig;
+        configString = decodeURIComponent(Settings.CUSTOM_CONFIGS[config]);
+      }
+    }
+    if (isValueEncrypted(configString)) {
+      logger.info(`Encrypted config detected, encrypting credentials`);
+      configJson = encryptInfoInConfig(configJson);
+    }
+    const base64Config = Buffer.from(JSON.stringify(configJson)).toString(
+      'base64'
+    );
+    res.redirect(`/${encodeURIComponent(base64Config)}/configure`);
+  } catch (error: any) {
+    logger.error(`Failed to extract config: ${error.message}`);
+    res.status(400).send('Invalid config');
+  }
+});
+
+app.get('/manifest.json', (req, res) => {
+  res.status(200).json(manifest());
+});
+
+app.get('/:config/manifest.json', (req, res) => {
+  const config = decodeURIComponent(req.params.config);
+  let configJson: Config;
+  try {
+    configJson = extractJsonConfig(config);
+    logger.info(`Extracted config for manifest request`);
+    configJson = decryptEncryptedInfoFromConfig(configJson);
+    if (Settings.LOG_SENSITIVE_INFO) {
+      logger.info(`Final config: ${JSON.stringify(configJson)}`);
+    }
+    logger.info(`Successfully removed or decrypted sensitive info`);
+    const { valid, errorMessage } = validateConfig(configJson);
+    if (!valid) {
+      logger.error(
+        `Received invalid config for manifest request: ${errorMessage}`
+      );
+      res.status(400).json({ error: 'Invalid config', message: errorMessage });
+      return;
+    }
+  } catch (error: any) {
+    logger.error(`Failed to extract config: ${error.message}`);
+    res.status(400).json({ error: 'Invalid config' });
+    return;
+  }
+  res.status(200).json(manifest(configJson));
+});
+
+// Route for /stream
+app.get('/stream/:type/:id', (req: Request, res: Response) => {
+  res
+    .status(200)
+    .json(
+      errorResponse(
+        'You must configure this addon to use it',
+        rootUrl(req),
+        '/configure'
+      )
+    );
+});
+
+app.get('/:config/stream/:type/:id.json', (req, res: Response): void => {
+  const { config, type, id } = req.params;
+  let configJson: Config;
+  try {
+    configJson = extractJsonConfig(config);
+    logger.info(`Extracted config for stream request`);
+    configJson = decryptEncryptedInfoFromConfig(configJson);
+    if (Settings.LOG_SENSITIVE_INFO) {
+      logger.info(`Final config: ${JSON.stringify(configJson)}`);
+    }
+    logger.info(`Successfully removed or decrypted sensitive info`);
+  } catch (error: any) {
+    logger.error(`Failed to extract config: ${error.message}`);
+    res.json(
+      errorResponse(
+        `${error.message}, please check the logs or click this stream to create an issue on GitHub`,
+        rootUrl(req),
+        undefined,
+        'https://github.com/Viren070/AIOStreams/issues/new?template=bug_report.yml'
+      )
+    );
+    return;
+  }
+
+  logger.info(`Requesting streams for ${type} ${id}`);
+
+  if (type !== 'movie' && type !== 'series') {
+    logger.error(`Invalid type for stream request`);
+    res.json(
+      errorResponse(
+        'Invalid type for stream request, must be movie or series',
+        rootUrl(req),
+        '/'
+      )
+    );
+    return;
+  }
+  let streamRequest: StreamRequest = { id, type };
+
+  try {
+    const { valid, errorCode, errorMessage } = validateConfig(configJson);
+    if (!valid) {
+      logger.error(`Received invalid config: ${errorCode} - ${errorMessage}`);
+      res.json(
+        errorResponse(errorMessage ?? 'Unknown', rootUrl(req), '/configure')
+      );
+      return;
+    }
+    configJson.requestingIp = getIp(req);
+    const aioStreams = new AIOStreams(configJson);
+    aioStreams
+      .getStreams(streamRequest)
+      .then((streams) => {
+        res.json({ streams: streams });
+      })
+      .catch((error: any) => {
+        logger.error(`Internal addon error: ${error.message}`);
+        res.json(
+          errorResponse(
+            'An unexpected error occurred, please check the logs or create an issue on GitHub',
+            rootUrl(req),
+            undefined,
+            'https://github.com/Viren070/AIOStreams/issues/new?template=bug_report.yml'
+          )
+        );
+      });
+  } catch (error: any) {
+    logger.error(`Internal addon error: ${error.message}`);
+    res.json(
+      errorResponse(
+        'An unexpected error occurred, please check the logs or create an issue on GitHub',
+        rootUrl(req),
+        undefined,
+        'https://github.com/Viren070/AIOStreams/issues/new?template=bug_report.yml'
+      )
+    );
+  }
+});
+
+app.post('/encrypt-user-data', (req, res) => {
+  const { data } = req.body;
+  let finalString: string = '';
+  if (!data) {
+    logger.error('/encrypt-user-data: No data provided');
+    res.json({ success: false, message: 'No data provided' });
+    return;
+  }
+  // First, validate the config
+  try {
+    const config = JSON.parse(data);
+    const { valid, errorCode, errorMessage } = validateConfig(config);
+    if (!valid) {
+      logger.error(
+        `generateConfig: Invalid config: ${errorCode} - ${errorMessage}`
+      );
+      res.json({ success: false, message: errorMessage, error: errorMessage });
+      return;
+    }
+  } catch (error: any) {
+    logger.error(`/encrypt-user-data: Invalid JSON: ${error.message}`);
+    res.json({ success: false, message: 'Malformed configuration' });
+    return;
+  }
+
+  try {
+    const minified = minifyConfig(JSON.parse(data));
+    const crushed = crushJson(JSON.stringify(minified));
+    const compressed = compressData(crushed);
+    if (!Settings.SECRET_KEY) {
+      // use base64 encoding if no secret key is set
+      finalString = `B-${encodeURIComponent(compressed.toString('base64'))}`;
+    } else {
+      const { iv, data } = encryptData(compressed);
+      finalString = `E2-${encodeURIComponent(iv)}-${encodeURIComponent(data)}`;
+    }
+
+    logger.info(
+      `|INF| server > /encrypt-user-data: Encrypted user data, compression report:`
+    );
+    logger.info(`+--------------------------------------------+`);
+    logger.info(`| Original:         ${data.length} bytes`);
+    logger.info(`| URL Encoded:      ${encodeURIComponent(data).length} bytes`);
+    logger.info(`| Minified:         ${JSON.stringify(minified).length} bytes`);
+    logger.info(`| Crushed:          ${crushed.length} bytes`);
+    logger.info(`| Compressed:       ${compressed.length} bytes`);
+    logger.info(`| Final String:     ${finalString.length} bytes`);
+    logger.info(
+      `| Ratio:            ${((finalString.length / data.length) * 100).toFixed(2)}%`
+    );
+    logger.info(
+      `| Reduction:        ${data.length - finalString.length} bytes (${(((data.length - finalString.length) / data.length) * 100).toFixed(2)}%)`
+    );
+    logger.info(`+--------------------------------------------+`);
+
+    res.json({ success: true, data: finalString });
+  } catch (error: any) {
+    logger.error(`/encrypt-user-data: ${error.message}`);
+    logger.error(error);
+    res.json({ success: false, message: error.message });
+  }
+});
+
+app.get('/get-addon-config', (req, res) => {
+  res.status(200).json({
+    success: true,
+    maxMovieSize: Settings.MAX_MOVIE_SIZE,
+    maxEpisodeSize: Settings.MAX_EPISODE_SIZE,
+    torrentioDisabled: Settings.DISABLE_TORRENTIO,
+    apiKeyRequired: !!Settings.API_KEY,
+  });
+});
+
+app.get('/health', (req, res) => {
+  res.status(200).json({ status: 'ok' });
+});
+
+// define 404
+app.use((req, res) => {
+  res.status(404).sendFile(path.join(__dirname, '../../frontend/out/404.html'));
+});
+
+app.listen(Settings.PORT, () => {
+  logger.info(`Listening on port ${Settings.PORT}`);
+});
+
+function getIp(req: Request): string | undefined {
+  return (
+    req.get('X-Client-IP') ||
+    req.get('X-Forwarded-For')?.split(',')[0].trim() ||
+    req.get('X-Real-IP') ||
+    req.get('CF-Connecting-IP') ||
+    req.get('True-Client-IP') ||
+    req.get('X-Forwarded')?.split(',')[0].trim() ||
+    req.get('Forwarded-For')?.split(',')[0].trim() ||
+    req.ip
+  );
+}
+function extractJsonConfig(config: string): Config {
+  if (
+    config.startsWith('eyJ') ||
+    config.startsWith('eyI') ||
+    config.startsWith('B-') ||
+    isValueEncrypted(config)
+  ) {
+    return extractEncryptedOrEncodedConfig(config, 'Config');
+  }
+  if (Settings.CUSTOM_CONFIGS) {
+    const customConfig = extractCustomConfig(config);
+    if (customConfig) return customConfig;
+  }
+  throw new Error('Config was in an unexpected format');
+}
+
+function extractCustomConfig(config: string): Config | undefined {
+  const customConfig = Settings.CUSTOM_CONFIGS[config];
+  if (!customConfig) return undefined;
+  logger.info(
+    `Found custom config for alias ${config}, attempting to extract config`
+  );
+  return extractEncryptedOrEncodedConfig(
+    decodeURIComponent(customConfig),
+    `CustomConfig ${config}`
+  );
+}
+
+function extractEncryptedOrEncodedConfig(
+  config: string,
+  label: string
+): Config {
+  let decodedConfig: Config;
+  try {
+    if (config.startsWith('E-')) {
+      // compressed and encrypted (hex)
+      logger.info(`Extracting encrypted (v1) config`);
+      const parts = config.split('-');
+      if (parts.length !== 3) {
+        throw new Error('Invalid encrypted config format');
+      }
+      const iv = Buffer.from(decodeURIComponent(parts[1]), 'hex');
+      const data = Buffer.from(decodeURIComponent(parts[2]), 'hex');
+      decodedConfig = JSON.parse(decompressData(decryptData(data, iv)));
+    } else if (config.startsWith('E2-')) {
+      // minified, crushed, compressed and encrypted (base64)
+      logger.info(`Extracting encrypted (v2) config`);
+      const parts = config.split('-');
+      if (parts.length !== 3) {
+        throw new Error('Invalid encrypted config format');
+      }
+      const iv = Buffer.from(decodeURIComponent(parts[1]), 'base64');
+      const data = Buffer.from(decodeURIComponent(parts[2]), 'base64');
+      const compressedCrushedJson = decryptData(data, iv);
+      const crushedJson = decompressData(compressedCrushedJson);
+      const minifiedConfig = uncrushJson(crushedJson);
+      decodedConfig = unminifyConfig(JSON.parse(minifiedConfig));
+    } else if (config.startsWith('B-')) {
+      // minifed, crushed, compressed, base64 encoded
+      logger.info(`Extracting base64 encoded and compressed config`);
+      decodedConfig = unminifyConfig(
+        JSON.parse(
+          uncrushJson(decompressData(Buffer.from(config.slice(2), 'base64')))
+        )
+      );
+    } else {
+      // plain base64 encoded
+      logger.info(`Extracting plain base64 encoded config`);
+      decodedConfig = JSON.parse(
+        Buffer.from(config, 'base64').toString('utf-8')
+      );
+    }
+    return decodedConfig;
+  } catch (error: any) {
+    logger.error(`Failed to parse ${label}: ${error.message}`, {
+      func: 'extractJsonConfig',
+    });
+    logger.error(error, { func: 'extractJsonConfig' });
+    throw new Error(`Failed to parse ${label}`);
+  }
+}
+
+function decryptEncryptedInfoFromConfig(config: Config): Config {
+  if (config.services) {
+    config.services.forEach(
+      (service) =>
+        service.credentials &&
+        processObjectValues(
+          service.credentials,
+          `service ${service.id}`,
+          true,
+          (key, value) => isValueEncrypted(value)
+        )
+    );
+  }
+
+  if (config.mediaFlowConfig) {
+    decryptMediaFlowConfig(config.mediaFlowConfig);
+  }
+  if (config.stremThruConfig) {
+    decryptStremThruConfig(config.stremThruConfig);
+  }
+
+  if (config.apiKey) {
+    config.apiKey = decryptValue(config.apiKey, 'aioStreams apiKey');
+  }
+
+  if (config.addons) {
+    config.addons.forEach((addon) => {
+      if (addon.options) {
+        processObjectValues(
+          addon.options,
+          `addon ${addon.id}`,
+          true,
+          (key, value) =>
+            isValueEncrypted(value) &&
+            // Decrypt only if the option is secret
+            (
+              addonDetails.find((addonDetail) => addonDetail.id === addon.id)
+                ?.options ?? []
+            ).some((option) => option.id === key && option.secret)
+        );
+      }
+    });
+  }
+  return config;
+}
+
+function decryptMediaFlowConfig(mediaFlowConfig: {
+  apiPassword: string;
+  proxyUrl: string;
+  publicIp: string;
+}): void {
+  const { apiPassword, proxyUrl, publicIp } = mediaFlowConfig;
+  mediaFlowConfig.apiPassword = decryptValue(
+    apiPassword,
+    'MediaFlow apiPassword'
+  );
+  mediaFlowConfig.proxyUrl = decryptValue(proxyUrl, 'MediaFlow proxyUrl');
+  mediaFlowConfig.publicIp = decryptValue(publicIp, 'MediaFlow publicIp');
+}
+
+function decryptStremThruConfig(
+  stremThruConfig: Config['stremThruConfig']
+): void {
+  if (!stremThruConfig) return;
+  const { url, credential, publicIp } = stremThruConfig;
+  stremThruConfig.url = decryptValue(url, 'StremThru url');
+  stremThruConfig.credential = decryptValue(credential, 'StremThru credential');
+  stremThruConfig.publicIp = decryptValue(publicIp, 'StremThru publicIp');
+}
+
+function encryptInfoInConfig(config: Config): Config {
+  if (config.services) {
+    config.services.forEach(
+      (service) =>
+        service.credentials &&
+        processObjectValues(
+          service.credentials,
+          `service ${service.id}`,
+          false,
+          () => true
+        )
+    );
+  }
+
+  if (config.mediaFlowConfig) {
+    encryptMediaFlowConfig(config.mediaFlowConfig);
+  }
+
+  if (config.stremThruConfig) {
+    encryptStremThruConfig(config.stremThruConfig);
+  }
+
+  if (config.apiKey) {
+    // we can either remove the api key for better security or encrypt it for usability
+    // removing it means the user has to enter it every time upon reconfiguration.
+    config.apiKey = encryptValue(config.apiKey, 'aioStreams apiKey');
+  }
+
+  if (config.addons) {
+    config.addons.forEach((addon) => {
+      if (addon.options) {
+        processObjectValues(
+          addon.options,
+          `addon ${addon.id}`,
+          false,
+          (key) => {
+            const addonDetail = addonDetails.find(
+              (addonDetail) => addonDetail.id === addon.id
+            );
+            if (!addonDetail) return false;
+            const optionDetail = addonDetail.options?.find(
+              (option) => option.id === key
+            );
+            // Encrypt only if the option is secret
+            return optionDetail?.secret ?? false;
+          }
+        );
+      }
+    });
+  }
+  return config;
+}
+
+function encryptMediaFlowConfig(mediaFlowConfig: {
+  apiPassword: string;
+  proxyUrl: string;
+  publicIp: string;
+}): void {
+  const { apiPassword, proxyUrl, publicIp } = mediaFlowConfig;
+  mediaFlowConfig.apiPassword = encryptValue(
+    apiPassword,
+    'MediaFlow apiPassword'
+  );
+  mediaFlowConfig.proxyUrl = encryptValue(proxyUrl, 'MediaFlow proxyUrl');
+  mediaFlowConfig.publicIp = encryptValue(publicIp, 'MediaFlow publicIp');
+}
+
+function encryptStremThruConfig(
+  stremThruConfig: Config['stremThruConfig']
+): void {
+  if (!stremThruConfig) return;
+  const { url, credential, publicIp } = stremThruConfig;
+  stremThruConfig.url = encryptValue(url, 'StremThru url');
+  stremThruConfig.credential = encryptValue(credential, 'StremThru credential');
+  stremThruConfig.publicIp = encryptValue(publicIp, 'StremThru publicIp');
+}
+
+function processObjectValues(
+  obj: Record<string, any>,
+  labelPrefix: string,
+  decrypt: boolean,
+  condition: (key: string, value: any) => boolean
+): void {
+  Object.keys(obj).forEach((key) => {
+    const value = obj[key];
+    if (condition(key, value)) {
+      logger.debug(`Processing ${labelPrefix} ${key}`);
+      obj[key] = decrypt
+        ? decryptValue(value, `${labelPrefix} ${key}`)
+        : encryptValue(value, `${labelPrefix} ${key}`);
+    }
+  });
+}
+
+function encryptValue(value: any, label: string): any {
+  if (value && !isValueEncrypted(value)) {
+    try {
+      const { iv, data } = encryptData(compressData(value));
+      return `E2-${iv}-${data}`;
+    } catch (error: any) {
+      logger.error(`Failed to encrypt ${label}`, { func: 'encryptValue' });
+      logger.error(error, { func: 'encryptValue' });
+      return '';
+    }
+  }
+  return value;
+}
+
+function decryptValue(value: any, label: string): any {
+  try {
+    if (!isValueEncrypted(value)) return value;
+    const decrypted = parseAndDecryptString(value);
+    if (decrypted === null) throw new Error('Decryption failed');
+    return decrypted;
+  } catch (error: any) {
+    logger.error(`Failed to decrypt ${label}: ${error.message}`, {
+      func: 'decryptValue',
+    });
+    logger.error(error, { func: 'decryptValue' });
+    throw new Error('Failed to decrypt config');
+  }
+}
+
+const rootUrl = (req: Request) =>
+  `${req.protocol}://${req.hostname}${req.hostname === 'localhost' ? `:${Settings.PORT}` : ''}`;

packages/addon/tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "rootDir": "src",
+    "outDir": "dist",
+    "resolveJsonModule": true
+  },
+  "references": [
+    {
+      "path": "../wrappers"
+    },
+    {
+      "path": "../formatters"
+    },
+    {
+      "path": "../types"
+    },
+    {
+      "path": "../utils"
+    }
+  ]
+}

packages/cloudflare-loadbalancer/COMPARISON.md

@@ -0,0 +1,67 @@
+# AIOStreams Load Balancing: Cloudflare Worker vs. NGINX
+
+This document compares the two load balancing approaches used for AIOStreams:
+
+1. **NGINX Load Balancer** (configured in `nginx.conf`)
+2. **Cloudflare Worker Load Balancer** (in `packages/cloudflare-loadbalancer`)
+
+## Deployment Models
+
+### NGINX Approach
+
+- **Self-hosted**: Requires a dedicated server running NGINX.
+- **Single Point of Failure**: The NGINX server itself becomes a potential point of failure.
+- **Traditional HTTP Proxy**: Uses L7 (HTTP) load balancing.
+- **SSL Termination**: Handles HTTPS connections directly with certificates stored on the server.
+
+### Cloudflare Worker Approach
+
+- **Serverless**: No dedicated infrastructure required.
+- **Globally Distributed**: Runs on Cloudflare's edge network in 300+ locations worldwide.
+- **High Availability**: No single point of failure in the load balancer itself.
+- **Zero Maintenance**: No server patching, scaling, or management required.
+
+## Feature Comparison
+
+| Feature               | NGINX                    | Cloudflare Worker          |
+| --------------------- | ------------------------ | -------------------------- |
+| Load Balancing        | ✅ (ip_hash)              | ✅ (client IP hash)         |
+| Health Checks         | ✅ (passive only)         | ✅ (passive only)           |
+| Failover              | ✅                        | ✅                          |
+| WebSocket Support     | ✅                        | ✅                          |
+| Session Affinity      | ✅ (ip_hash)              | ✅ (cookies)                |
+| HTTP→HTTPS Redirect   | ✅                        | ✅                          |
+| Global Distribution   | ❌                        | ✅                          |
+| SSL Management        | Manual                   | Automatic (via Cloudflare) |
+| DDoS Protection       | Limited                  | ✅ (via Cloudflare)         |
+| Deployment Complexity | Higher                   | Lower                      |
+| Operational Costs     | Server + bandwidth costs | Cloudflare Workers pricing |
+
+## When to Use Each Approach
+
+### Use the NGINX Approach When:
+
+- You need complete control over the load balancing infrastructure.
+- You want to avoid any third-party dependencies.
+- You already have servers running in a datacenter with NGINX expertise.
+- You need advanced customization of HTTP headers, rewriting rules, etc.
+
+### Use the Cloudflare Worker Approach When:
+
+- You want global low-latency access without managing infrastructure.
+- You prefer a serverless, maintenance-free deployment.
+- You need built-in DDoS protection and security features.
+- You want to minimize operational complexity and management.
+
+## Hybrid Approach
+
+You can also use both approaches together:
+
+1. **Primary Traffic**: Route through the Cloudflare Worker for global distribution and DDoS protection.
+2. **Fallback**: If Cloudflare has issues, DNS can be updated to point directly to your NGINX load balancer.
+
+This gives you the benefits of Cloudflare's global network while maintaining the ability to operate independently if needed.
+
+## Conclusion
+
+Both approaches effectively solve the load balancing needs of AIOStreams, but with different operational models. The Cloudflare Worker provides a modern, serverless approach with global distribution, while the NGINX configuration offers traditional self-hosted load balancing with maximum control. 

packages/cloudflare-loadbalancer/README.md

@@ -0,0 +1,70 @@
+# AIOStreams Cloudflare Load Balancer
+
+A Cloudflare Worker that load balances traffic across multiple AIOStreams backends, providing high availability and redundancy.
+
+## Features
+
+- **Load Balancing**: Routes traffic among three backend services:
+  - `aiostreams-cf.example.com`
+  - `aiostreams-koyeb.example.com`
+  - `aiostreams.example.duckdns.org`
+
+- **Sticky Sessions**: Maintains session affinity using cookies, ensuring users stay on the same backend throughout their session.
+
+- **Health Checking**: Automatically detects backend failures and routes traffic away from unhealthy instances.
+
+- **Automatic Failover**: If a backend is unresponsive or returns 5xx errors, requests are retried with another backend.
+
+- **Consistent Hashing**: Uses client IP for consistent backend selection when no sticky session exists.
+
+- **WebSocket Support**: Properly handles WebSocket connections, maintaining the upgrade flow.
+
+- **HTTP-to-HTTPS Redirection**: Automatically redirects HTTP requests to HTTPS.
+
+- **Header Preservation**: Maintains all request headers and adds proper proxy headers for backends.
+
+## Configuration
+
+The worker is configured via environment variables in `wrangler.toml`:
+
+| Variable              | Description                                                        |
+| --------------------- | ------------------------------------------------------------------ |
+| `PRIMARY_DOMAIN`      | Domain name this worker is handling (e.g., aiostreams.example.com) |
+| `BACKEND_CF`          | Hostname for Cloudflare backend                                    |
+| `BACKEND_KOYEB`       | Hostname for Koyeb backend                                         |
+| `BACKEND_DUCK`        | Hostname for DuckDNS backend                                       |
+| `STICKY_SESSIONS`     | Enable/disable sticky sessions (true/false)                        |
+| `SESSION_COOKIE_NAME` | Cookie name for session stickiness                                 |
+| `SESSION_COOKIE_TTL`  | Session cookie time-to-live in seconds (default: 86400)            |
+| `BACKEND_DOWN_TIME`   | How long to mark a backend as down after a failure (ms)            |
+| `MAX_RETRIES`         | Maximum number of retry attempts                                   |
+
+## Deployment
+
+Deploy the worker to Cloudflare:
+
+```bash
+cd packages/cloudflare-loadbalancer
+npm install
+npm run deploy
+```
+
+## How It Works
+
+1. When a request arrives at the worker (configured for the domain in `PRIMARY_DOMAIN`), the worker chooses a backend based on:
+   - Existing session cookie (if sticky sessions enabled)
+   - Client IP hash (for consistent backend selection)
+   - Backend health status
+
+2. The worker forwards the request to the selected backend, preserving all headers, query parameters, and request body.
+
+3. If the backend fails or returns a 5xx error, the worker retries with another backend.
+
+4. For sticky sessions, the worker sets a cookie to ensure subsequent requests from the same client go to the same backend.
+
+## Fault Tolerance
+
+- The worker maintains a temporary in-memory health status for each backend.
+- Failed backends are marked as "down" for a configurable period.
+- If all backends are down, the worker will reset all health statuses and try again.
+- A maximum retry count prevents excessive attempts when all backends are failing.

packages/cloudflare-loadbalancer/deploy.sh

@@ -0,0 +1,17 @@
+#!/bin/bash
+
+# AIOStreams Cloudflare Load Balancer Deployment Script
+
+echo "=== AIOStreams Cloudflare Load Balancer Deployment ==="
+echo "Installing dependencies..."
+npm install
+
+echo "Building and deploying worker..."
+npx wrangler deploy
+
+echo "=== Deployment Complete ==="
+echo "Your load balancer is now deployed to Cloudflare."
+echo "Make sure to set up appropriate DNS records pointing aiostreams.example.com to your worker."
+echo ""
+echo "Test your deployment with:"
+echo "curl -I https://aiostreams.example.com" 

packages/cloudflare-loadbalancer/package.json

@@ -0,0 +1,19 @@
+{
+    "name": "@aiostreams/cloudflare-loadbalancer",
+    "version": "1.0.0",
+    "description": "Cloudflare Worker that routes traffic between multiple AIOStreams backends",
+    "scripts": {
+        "deploy": "wrangler deploy",
+        "dev": "wrangler dev",
+        "start": "wrangler dev",
+        "test": "vitest",
+        "cf-typegen": "wrangler types"
+    },
+    "dependencies": {},
+    "devDependencies": {
+        "@cloudflare/workers-types": "^4.20241224.0",
+        "esbuild": "^0.25.5",
+        "typescript": "^5.5.2",
+        "wrangler": "^4.18.0"
+    }
+}

packages/cloudflare-loadbalancer/src/index.ts

@@ -0,0 +1,260 @@
+export interface Env {
+    // Environment variables
+    BACKEND_CF: string;
+    BACKEND_KOYEB: string;
+    BACKEND_DUCK: string;
+    STICKY_SESSIONS: boolean;
+    SESSION_COOKIE_NAME: string;
+    BACKEND_DOWN_TIME: string;
+    MAX_RETRIES: string;
+    // Optional duration for sticky session cookie in seconds (default: 1 day)
+    SESSION_COOKIE_TTL?: string;
+    // Primary domain that the worker is handling
+    PRIMARY_DOMAIN: string;
+}
+
+// Store for tracking backend health status
+interface HealthStatus {
+    isDown: boolean;
+    lastFailure: number;
+}
+
+// Health status for each backend
+const backendHealth = new Map<string, HealthStatus>();
+
+// Helper function to choose a backend
+function chooseBackend(request: Request, env: Env): string {
+    const backendOptions = [
+        env.BACKEND_CF,
+        env.BACKEND_KOYEB,
+        env.BACKEND_DUCK
+    ];
+
+    // Filter out any backends that are marked as down
+    const availableBackends = backendOptions.filter(backend => {
+        const health = backendHealth.get(backend);
+        if (!health) return true;
+
+        if (health.isDown) {
+            // Check if the backend has been down long enough to retry
+            const downTime = parseInt(env.BACKEND_DOWN_TIME) || 30000;
+            if (Date.now() - health.lastFailure > downTime) {
+                // Reset the backend status
+                backendHealth.set(backend, { isDown: false, lastFailure: 0 });
+                return true;
+            }
+            return false;
+        }
+
+        return true;
+    });
+
+    // If no backends are available, reset all backends and try again
+    if (availableBackends.length === 0) {
+        backendOptions.forEach(backend => {
+            backendHealth.set(backend, { isDown: false, lastFailure: 0 });
+        });
+        return backendOptions[0];
+    }
+
+    // Check for sticky session cookie if enabled
+    if (env.STICKY_SESSIONS) {
+        const cookies = request.headers.get('Cookie') || '';
+        const cookieRegex = new RegExp(`${env.SESSION_COOKIE_NAME}=([^;]+)`);
+        const match = cookies.match(cookieRegex);
+
+        if (match && match[1]) {
+            const preferredBackend = match[1];
+            // Check if the preferred backend is available
+            if (availableBackends.includes(preferredBackend)) {
+                return preferredBackend;
+            }
+        }
+    }
+
+    // Use client IP for consistent hashing if no cookie or preferred backend is down
+    const clientIP = request.headers.get('CF-Connecting-IP') ||
+        request.headers.get('X-Real-IP') ||
+        request.headers.get('X-Forwarded-For')?.split(',')[0].trim() ||
+        'unknown';
+
+    // Simple hash function for the client IP
+    const hashCode = (str: string) => {
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            hash = ((hash << 5) - hash) + char;
+            hash = hash & hash; // Convert to 32bit integer
+        }
+        return Math.abs(hash);
+    };
+
+    const index = hashCode(clientIP) % availableBackends.length;
+    return availableBackends[index];
+}
+
+// Mark a backend as down
+function markBackendDown(backend: string, env: Env): void {
+    backendHealth.set(backend, {
+        isDown: true,
+        lastFailure: Date.now()
+    });
+
+    console.error(`Backend ${backend} marked as down at ${new Date().toISOString()}`);
+}
+
+// Clone request with new URL
+function createBackendRequest(request: Request, backend: string): Request {
+    const url = new URL(request.url);
+    const backendUrl = new URL(`https://${backend}`);
+
+    // Preserve path and query parameters
+    backendUrl.pathname = url.pathname;
+    backendUrl.search = url.search;
+
+    // Get original headers and create a new headers object
+    const headers = new Headers(request.headers);
+
+    // Set the host header to the backend hostname
+    headers.set('Host', backend);
+
+    // Add proxy headers
+    headers.set('X-Forwarded-Host', url.hostname);
+    headers.set('X-Forwarded-Proto', url.protocol.replace(':', ''));
+
+    // Check if we need to handle WebSockets
+    const upgradeHeader = request.headers.get('Upgrade');
+    const isWebSocket = upgradeHeader !== null && upgradeHeader.toLowerCase() === 'websocket';
+
+    // Clone the request with the new URL
+    const newRequest = new Request(backendUrl.toString(), {
+        method: request.method,
+        headers: headers,
+        body: request.body,
+        redirect: 'manual', // Don't follow redirects automatically
+        // If this is a WebSocket request, we need to preserve the upgrade header
+        duplex: isWebSocket ? 'half' : undefined
+    });
+
+    return newRequest;
+}
+
+// Determine if we're in a development environment
+function isDevelopment(): boolean {
+    try {
+        // Check if we're in a browser-like environment with location object
+        // @ts-ignore - Cloudflare Workers have location in dev/preview but not in TypeScript defs
+        return typeof globalThis.location === 'object' &&
+            // @ts-ignore
+            (globalThis.location.hostname === 'localhost' ||
+                // @ts-ignore
+                globalThis.location.hostname.includes('workers.dev') ||
+                // @ts-ignore
+                globalThis.location.hostname.includes('preview'));
+    } catch (e) {
+        return false;
+    }
+}
+
+export default {
+    async fetch(request: Request, env: Env, ctx: any): Promise<Response> {
+        const url = new URL(request.url);
+        const isDevEnvironment = isDevelopment();
+
+        // In production, only handle requests for the PRIMARY_DOMAIN
+        // In development, handle all requests (to make testing easier)
+        if (!isDevEnvironment && url.hostname !== env.PRIMARY_DOMAIN) {
+            console.log(`Request for ${url.hostname} rejected (expected ${env.PRIMARY_DOMAIN})`);
+            return new Response(`This worker is configured to handle requests for ${env.PRIMARY_DOMAIN} only`, {
+                status: 404,
+                headers: { 'Content-Type': 'text/plain' }
+            });
+        }
+
+        // Redirect HTTP to HTTPS in production
+        if (!isDevEnvironment && url.protocol === 'http:') {
+            url.protocol = 'https:';
+            return Response.redirect(url.toString(), 301);
+        }
+
+        // Check for WebSocket upgrade
+        const upgradeHeader = request.headers.get('Upgrade');
+        const isWebSocket = upgradeHeader !== null && upgradeHeader.toLowerCase() === 'websocket';
+
+        // Try each backend until success or we run out of retries
+        let backend = chooseBackend(request, env);
+        let attempts = 0;
+        const maxRetries = parseInt(env.MAX_RETRIES) || 3;
+
+        // For WebSockets, we only try once per backend to avoid connection issues
+        const effectiveMaxRetries = isWebSocket ? Math.min(maxRetries, 1) : maxRetries;
+
+        console.log(`Routing request to ${backend} (attempt 1/${effectiveMaxRetries})`);
+
+        while (attempts < effectiveMaxRetries) {
+            attempts++;
+
+            try {
+                // Create a new request for the backend
+                const backendRequest = createBackendRequest(request, backend);
+
+                // Forward the request to the backend
+                const response = await fetch(backendRequest);
+
+                // If the response is a server error (5xx), mark the backend as down and try another
+                if (response.status >= 500 && response.status < 600) {
+                    console.error(`Backend ${backend} returned ${response.status}`);
+                    markBackendDown(backend, env);
+
+                    // Choose a different backend for the next attempt
+                    if (attempts < effectiveMaxRetries) {
+                        backend = chooseBackend(request, env);
+                        console.log(`Retrying with ${backend} (attempt ${attempts + 1}/${effectiveMaxRetries})`);
+                        continue;
+                    }
+                }
+
+                // Clone the response so we can modify headers
+                const clonedResponse = new Response(response.body, response);
+
+                // If sticky sessions are enabled, set a cookie with the backend
+                if (env.STICKY_SESSIONS) {
+                    // Calculate cookie expiration
+                    const ttl = parseInt(env.SESSION_COOKIE_TTL || '86400'); // Default to 1 day
+                    const expires = new Date();
+                    expires.setSeconds(expires.getSeconds() + ttl);
+
+                    clonedResponse.headers.append('Set-Cookie',
+                        `${env.SESSION_COOKIE_NAME}=${backend}; Path=/; HttpOnly; SameSite=Lax; Expires=${expires.toUTCString()}`);
+                }
+
+                // For WebSocket upgrade responses, make sure we preserve the Connection and Upgrade headers
+                if (isWebSocket && response.status === 101) {
+                    clonedResponse.headers.set('Connection', 'Upgrade');
+                    clonedResponse.headers.set('Upgrade', 'websocket');
+                }
+
+                console.log(`Successfully routed to ${backend}, status: ${response.status}`);
+                return clonedResponse;
+            } catch (error) {
+                console.error(`Error forwarding to ${backend}:`, error);
+                markBackendDown(backend, env);
+
+                // Choose a different backend for the next attempt
+                if (attempts < effectiveMaxRetries) {
+                    backend = chooseBackend(request, env);
+                    console.log(`Retrying with ${backend} (attempt ${attempts + 1}/${effectiveMaxRetries})`);
+                }
+            }
+        }
+
+        // If we've exhausted all retries, return a 502 Bad Gateway
+        return new Response('All backends are currently unavailable', {
+            status: 502,
+            headers: {
+                'Content-Type': 'text/plain',
+                'Retry-After': '30'
+            }
+        });
+    }
+}; 

packages/cloudflare-loadbalancer/src/test.ts

@@ -0,0 +1,149 @@
+/**
+ * This is a simple test script that can be run locally using wrangler dev.
+ * It simulates the behavior of the load balancer by mocking backend responses.
+ */
+
+import { Env } from './index';
+
+// Mock fetch responses for each backend
+const mockResponses = new Map<string, Response>();
+
+// Helper to register a mock response for a backend
+function mockBackendResponse(backend: string, status: number, body: string): void {
+    mockResponses.set(backend, new Response(body, { status }));
+}
+
+// Overrides the global fetch for testing
+// @ts-ignore
+globalThis.fetch = async (request: Request): Promise<Response> => {
+    const url = new URL(request.url);
+    const hostname = url.hostname;
+
+    if (mockResponses.has(hostname)) {
+        return mockResponses.get(hostname)!;
+    }
+
+    return new Response(`Unmocked backend: ${hostname}`, { status: 404 });
+};
+
+// Mock the location object for development detection
+// @ts-ignore
+globalThis.location = {
+    hostname: 'localhost:8787',
+    protocol: 'http:'
+};
+
+// Test scenarios
+async function runTests() {
+    // Set up mock environment
+    const env: Env = {
+        PRIMARY_DOMAIN: 'aiostreams.example.com',
+        BACKEND_CF: 'aiostreams-cf.example.com',
+        BACKEND_KOYEB: 'aiostreams-koyeb.example.com',
+        BACKEND_DUCK: 'aiostreams.example.duckdns.org',
+        STICKY_SESSIONS: true,
+        SESSION_COOKIE_NAME: 'aiostreams_backend',
+        SESSION_COOKIE_TTL: '86400',
+        BACKEND_DOWN_TIME: '30000',
+        MAX_RETRIES: '3'
+    };
+
+    console.log('=== AIOStreams Load Balancer Tests ===');
+
+    // Test 1: All backends healthy
+    console.log('\nTest 1: All backends healthy');
+    mockBackendResponse(env.BACKEND_CF, 200, 'Response from CF');
+    mockBackendResponse(env.BACKEND_KOYEB, 200, 'Response from Koyeb');
+    mockBackendResponse(env.BACKEND_DUCK, 200, 'Response from DuckDNS');
+
+    // Simulate a request
+    const request1 = new Request(`https://${env.PRIMARY_DOMAIN}/test`);
+    // @ts-ignore - Import the actual handler from index.ts
+    const response1 = await require('./index').default.fetch(request1, env, {});
+
+    console.log(`Status: ${response1.status}`);
+    console.log(`Body: ${await response1.text()}`);
+    console.log(`Cookie: ${response1.headers.get('Set-Cookie')}`);
+
+    // Test 2: One backend down
+    console.log('\nTest 2: One backend down (Cloudflare)');
+    mockBackendResponse(env.BACKEND_CF, 503, 'Service Unavailable');
+
+    const request2 = new Request(`https://${env.PRIMARY_DOMAIN}/test`);
+    // @ts-ignore - Import the actual handler from index.ts
+    const response2 = await require('./index').default.fetch(request2, env, {});
+
+    console.log(`Status: ${response2.status}`);
+    console.log(`Body: ${await response2.text()}`);
+
+    // Test 3: Sticky session
+    console.log('\nTest 3: Sticky session (should use Koyeb)');
+    const request3 = new Request(`https://${env.PRIMARY_DOMAIN}/test`, {
+        headers: {
+            'Cookie': `${env.SESSION_COOKIE_NAME}=${env.BACKEND_KOYEB}`
+        }
+    });
+
+    // @ts-ignore - Import the actual handler from index.ts
+    const response3 = await require('./index').default.fetch(request3, env, {});
+
+    console.log(`Status: ${response3.status}`);
+    console.log(`Body: ${await response3.text()}`);
+
+    // Test 4: All backends down
+    console.log('\nTest 4: All backends down');
+    mockBackendResponse(env.BACKEND_CF, 503, 'Service Unavailable');
+    mockBackendResponse(env.BACKEND_KOYEB, 502, 'Bad Gateway');
+    mockBackendResponse(env.BACKEND_DUCK, 500, 'Internal Server Error');
+
+    const request4 = new Request(`https://${env.PRIMARY_DOMAIN}/test`);
+    // @ts-ignore - Import the actual handler from index.ts
+    const response4 = await require('./index').default.fetch(request4, env, {});
+
+    console.log(`Status: ${response4.status}`);
+    console.log(`Body: ${await response4.text()}`);
+
+    // Test 5: HTTP to HTTPS redirect
+    console.log('\nTest 5: HTTP to HTTPS redirect');
+    const request5 = new Request(`http://${env.PRIMARY_DOMAIN}/test`);
+    // @ts-ignore - Import the actual handler from index.ts
+    const response5 = await require('./index').default.fetch(request5, env, {});
+
+    console.log(`Status: ${response5.status}`);
+    console.log(`Location: ${response5.headers.get('Location')}`);
+
+    // Test 6: WebSocket handling
+    console.log('\nTest 6: WebSocket handling');
+    mockBackendResponse(env.BACKEND_CF, 101, ''); // WebSocket upgrade response
+
+    const webSocketHeaders = new Headers();
+    webSocketHeaders.set('Upgrade', 'websocket');
+    webSocketHeaders.set('Connection', 'Upgrade');
+
+    const request6 = new Request(`https://${env.PRIMARY_DOMAIN}/ws`, {
+        headers: webSocketHeaders
+    });
+
+    // @ts-ignore - Import the actual handler from index.ts
+    const response6 = await require('./index').default.fetch(request6, env, {});
+
+    console.log(`Status: ${response6.status}`);
+    console.log(`Upgrade header: ${response6.headers.get('Upgrade')}`);
+    console.log(`Connection header: ${response6.headers.get('Connection')}`);
+
+    // Test 7: Wrong hostname (should be ignored in dev environment)
+    console.log('\nTest 7: Wrong hostname (should be handled in dev)');
+    const request7 = new Request('https://wrong-hostname.example.com/test');
+    // @ts-ignore - Import the actual handler from index.ts
+    const response7 = await require('./index').default.fetch(request7, env, {});
+
+    console.log(`Status: ${response7.status}`);
+    console.log(`Body: ${await response7.text().then((body: string) => body.substring(0, 50) + '...')}`);
+
+    console.log('\n=== Tests Complete ===');
+}
+
+// Run the tests
+runTests().catch(error => {
+    console.error('Test error:', error);
+}); 

packages/cloudflare-loadbalancer/tsconfig.json

@@ -0,0 +1,30 @@
+{
+    "compilerOptions": {
+        "target": "es2022",
+        "lib": [
+            "es2022"
+        ],
+        "module": "es2022",
+        "moduleResolution": "node",
+        "esModuleInterop": true,
+        "strict": true,
+        "noImplicitAny": true,
+        "strictNullChecks": true,
+        "strictFunctionTypes": true,
+        "strictBindCallApply": true,
+        "strictPropertyInitialization": true,
+        "noImplicitThis": true,
+        "alwaysStrict": true,
+        "isolatedModules": true,
+        "resolveJsonModule": true,
+        "skipLibCheck": true,
+        "outDir": "dist"
+    },
+    "include": [
+        "src/**/*"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}

packages/cloudflare-loadbalancer/wrangler.toml

@@ -0,0 +1,28 @@
+#:schema node_modules/wrangler/config-schema.json
+name = "aiostreams-loadbalancer"
+main = "src/index.ts"
+compatibility_date = "2024-12-24"
+compatibility_flags = ["nodejs_compat"]
+
+# Workers Logs
+[observability]
+enabled = true
+
+# Variable bindings
+[vars]
+# Primary domain the worker is handling
+PRIMARY_DOMAIN = "aiostreams.example.com"
+# Upstream backends
+BACKEND_CF = "aiostreams-cf.example.com"
+BACKEND_KOYEB = "aiostreams-koyeb.example.com"
+BACKEND_DUCK = "aiostreams.example.duckdns.org"
+# Sticky session configuration
+STICKY_SESSIONS = true
+# Session cookie name (used if sticky sessions are enabled)
+SESSION_COOKIE_NAME = "aiostreams_backend"
+# Session cookie TTL in seconds (default: 86400 = 1 day)
+SESSION_COOKIE_TTL = "86400"
+# How long to mark a backend as down after a failure (in milliseconds)
+BACKEND_DOWN_TIME = "30000"
+# Maximum number of retries when a backend fails
+MAX_RETRIES = "3" 

packages/cloudflare-worker/package.json

@@ -0,0 +1,21 @@
+{
+  "name": "@aiostreams/cloudflare-worker",
+  "version": "1.21.1",
+  "scripts": {
+    "deploy": "wrangler deploy",
+    "dev": "wrangler dev",
+    "start": "wrangler dev",
+    "test": "vitest",
+    "cf-typegen": "wrangler types"
+  },
+  "dependencies": {
+    "@aiostreams/addon": "^1.0.0",
+    "@aiostreams/types": "^1.0.0"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20241224.0",
+    "esbuild": "^0.25.5",
+    "typescript": "^5.5.2",
+    "wrangler": "^4.18.0"
+  }
+}

packages/cloudflare-worker/src/index.ts

@@ -0,0 +1,215 @@
+import { AIOStreams, errorResponse, validateConfig } from '@aiostreams/addon';
+import manifest from '@aiostreams/addon/src/manifest';
+import { Config, StreamRequest } from '@aiostreams/types';
+import { unminifyConfig } from '@aiostreams/utils';
+
+const HEADERS = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Methods': 'GET,HEAD,POST,OPTIONS',
+};
+
+const PROXY_URL = 'https://warp-proxy.bolabaden.org';
+
+// Proxy utility function
+async function fetchWithProxy(input: RequestInfo | URL, init?: RequestInit): Promise<Response> {
+  try {
+    // Convert input to string URL
+    const targetUrl = typeof input === 'string' ? input : input instanceof URL ? input.toString() : input.url;
+
+    // First, try to use the proxy
+    const proxyUrl = `${PROXY_URL}/fetch?url=${encodeURIComponent(targetUrl)}`;
+    const proxyResponse = await fetch(proxyUrl, {
+      ...init,
+      // Add API key and other headers
+      headers: {
+        ...init?.headers,
+        'User-Agent': 'AIOStreams-CloudflareWorker/1.0',
+        'X-API-Key': 'sk_IQys9kpENSiYY8lFuCslok3PauKBRSzeGprmvPfiMWAM9neeXoSqCZW7pMlWKbqPrwtF33kh1F73vf7D4PBpVfZJ1reHEL8d6ny6J03Ho',
+      },
+    });
+
+    // If proxy responds successfully, return the response
+    if (proxyResponse.ok) {
+      return proxyResponse;
+    }
+
+    // If proxy fails, fall back to direct request
+    console.warn(`Proxy failed with status ${proxyResponse.status}, falling back to direct request`);
+    return await fetch(input, init);
+  } catch (error) {
+    // If proxy is completely unreachable, fall back to direct request
+    console.warn('Proxy unreachable, falling back to direct request:', error);
+    return await fetch(input, init);
+  }
+}
+
+function createJsonResponse(data: any): Response {
+  return new Response(JSON.stringify(data, null, 4), {
+    headers: HEADERS,
+  });
+}
+
+function createResponse(message: string, status: number): Response {
+  return new Response(message, {
+    status,
+    headers: HEADERS,
+  });
+}
+
+export default {
+  async fetch(request, env, ctx): Promise<Response> {
+    try {
+      const url = new URL(decodeURIComponent(request.url));
+      const components = url.pathname.split('/').splice(1);
+
+      // handle static asset requests
+      if (components.includes('_next') || components.includes('assets')) {
+        return env.ASSETS.fetch(request);
+      }
+
+      if (url.pathname === '/icon.ico') {
+        return env.ASSETS.fetch(request);
+      }
+
+      // redirect to /configure if root path is requested
+      if (url.pathname === '/') {
+        return Response.redirect(url.origin + '/configure', 301);
+      }
+
+      // handle /encrypt-user-data POST requests
+      if (components.includes('encrypt-user-data')) {
+        const data = (await request.json()) as { data: string };
+        if (!data) {
+          return createResponse('Invalid Request', 400);
+        }
+        const dataToEncode = data.data;
+        try {
+          console.log(
+            `Received /encrypt-user-data request with Data: ${dataToEncode}`
+          );
+          const encodedData = Buffer.from(dataToEncode).toString('base64');
+          return createJsonResponse({ data: encodedData, success: true });
+        } catch (error: any) {
+          console.error(error);
+          return createJsonResponse({ error: error.message, success: false });
+        }
+      }
+      // handle /configure and /:config/configure requests
+      if (components.includes('configure')) {
+        if (components.length === 1) {
+          return env.ASSETS.fetch(request);
+        } else {
+          // display configure page with config still in url
+          return env.ASSETS.fetch(
+            new Request(url.origin + '/configure', request)
+          );
+        }
+      }
+
+      // handle /manifest.json and /:config/manifest.json requests
+      if (components.includes('manifest.json')) {
+        if (components.length === 1) {
+          return createJsonResponse(manifest());
+        } else {
+          return createJsonResponse(manifest(undefined, true));
+        }
+      }
+
+      if (components.includes('stream')) {
+        // when /stream is requested without config
+        let config = decodeURIComponent(components[0]);
+        console.log(`components: ${components}`);
+        if (components.length < 4) {
+          return createJsonResponse(
+            errorResponse(
+              'You must configure this addon first',
+              url.origin,
+              '/configure'
+            )
+          );
+        }
+        console.log(`Received /stream request with Config: ${config}`);
+        const decodedPath = decodeURIComponent(url.pathname);
+
+        const streamMatch = /stream\/(movie|series)\/([^/]+)\.json/.exec(
+          decodedPath
+        );
+        if (!streamMatch) {
+          let path = decodedPath.replace(`/${config}`, '');
+          console.error(`Invalid request: ${path}`);
+          return createResponse('Invalid request', 400);
+        }
+
+        const [type, id] = streamMatch.slice(1);
+        console.log(`Received /stream request with Type: ${type}, ID: ${id}`);
+
+        let decodedConfig: Config;
+
+        if (config.startsWith('E-') || config.startsWith('E2-')) {
+          return createResponse('Encrypted Config Not Supported', 400);
+        }
+        try {
+          decodedConfig = unminifyConfig(
+            JSON.parse(Buffer.from(config, 'base64').toString('utf-8'))
+          );
+        } catch (error: any) {
+          console.error(error);
+          return createJsonResponse(
+            errorResponse(
+              'Unable to parse config, please reconfigure or create an issue on GitHub',
+              url.origin,
+              '/configure'
+            )
+          );
+        }
+        const { valid, errorMessage, errorCode } =
+          validateConfig(decodedConfig);
+        if (!valid) {
+          console.error(`Invalid config: ${errorMessage}`);
+          return createJsonResponse(
+            errorResponse(errorMessage ?? 'Unknown', url.origin, '/configure')
+          );
+        }
+
+        if (type !== 'movie' && type !== 'series') {
+          return createResponse('Invalid Request', 400);
+        }
+
+        let streamRequest: StreamRequest = { id, type };
+
+        decodedConfig.requestingIp =
+          request.headers.get('X-Forwarded-For') ||
+          request.headers.get('X-Real-IP') ||
+          request.headers.get('CF-Connecting-IP') ||
+          request.headers.get('X-Client-IP') ||
+          undefined;
+
+        // Temporarily replace global fetch with proxy-enabled fetch for AIOStreams
+        const originalFetch = globalThis.fetch;
+        globalThis.fetch = fetchWithProxy;
+
+        try {
+          const aioStreams = new AIOStreams(decodedConfig);
+          const streams = await aioStreams.getStreams(streamRequest);
+          return createJsonResponse({ streams });
+        } finally {
+          // Restore original fetch
+          globalThis.fetch = originalFetch;
+        }
+      }
+
+      const notFound = await env.ASSETS.fetch(
+        new Request(url.origin + '/404', request)
+      );
+      return new Response(notFound.body, { ...notFound, status: 404 });
+    } catch (e) {
+      console.error(e);
+      return new Response('Internal Server Error', {
+        status: 500,
+        headers: {
+          'Content-Type': 'text/plain',
+        },
+      });
+    }
+  },
+} satisfies ExportedHandler<Env>;

packages/cloudflare-worker/tsconfig.json

@@ -0,0 +1,48 @@
+{
+  "compilerOptions": {
+    "target": "es2021",
+    "lib": ["es2021"],
+    /* Specify what JSX code is generated. */
+    "jsx": "react-jsx",
+
+    /* Specify what module code is generated. */
+    "module": "es2022",
+    /* Specify how TypeScript looks up a file from a given module specifier. */
+    "moduleResolution": "Bundler",
+    /* Specify type package names to be included without being referenced in a source file. */
+    "types": ["@cloudflare/workers-types"],
+    /* Enable importing .json files */
+    "resolveJsonModule": true,
+
+    /* Allow JavaScript files to be a part of your program. Use the `checkJS` option to get errors from these files. */
+    "allowJs": true,
+    /* Enable error reporting in type-checked JavaScript files. */
+    "checkJs": false,
+
+    /* Disable emitting files from a compilation. */
+    "noEmit": true,
+
+    /* Ensure that each file can be safely transpiled without relying on other imports. */
+    "isolatedModules": true,
+    /* Allow 'import x from y' when a module doesn't have a default export. */
+    "allowSyntheticDefaultImports": true,
+    /* Ensure that casing is correct in imports. */
+    "forceConsistentCasingInFileNames": true,
+
+    /* Enable all strict type-checking options. */
+    "strict": true,
+
+    /* Skip type checking all .d.ts files. */
+    "skipLibCheck": true
+  },
+  "references": [
+    {
+      "path": "../addon"
+    },
+    {
+      "path": "../types"
+    }
+  ],
+  "exclude": ["test"],
+  "include": ["worker-configuration.d.ts", "src/**/*.ts"]
+}

packages/cloudflare-worker/worker-configuration.d.ts

@@ -0,0 +1,5 @@
+// Generated by Wrangler by running `wrangler types`
+
+interface Env {
+  ASSETS: Fetcher;
+}

packages/cloudflare-worker/wrangler.toml

@@ -0,0 +1,138 @@
+#:schema node_modules/wrangler/config-schema.json
+name = "aiostreams"
+main = "src/index.ts"
+compatibility_date = "2024-12-24"
+compatibility_flags = ["nodejs_compat"]
+assets = { directory = "../frontend/out", binding = "ASSETS", experimental_serve_directly = false}
+
+# Workers Logs
+# Docs: https://developers.cloudflare.com/workers/observability/logs/workers-logs/
+# Configuration: https://developers.cloudflare.com/workers/observability/logs/workers-logs/#enable-workers-logs
+[observability]
+enabled = true
+
+# Automatically place your workloads in an optimal location to minimize latency.
+# If you are running back-end logic in a Worker, running it closer to your back-end infrastructure
+# rather than the end user may result in better performance.
+# Docs: https://developers.cloudflare.com/workers/configuration/smart-placement/#smart-placement
+# [placement]
+# mode = "smart"
+
+# Variable bindings. These are arbitrary, plaintext strings (similar to environment variables)
+# Docs:
+# - https://developers.cloudflare.com/workers/wrangler/configuration/#environment-variables
+# Note: Use secrets to store sensitive data.
+# - https://developers.cloudflare.com/workers/configuration/secrets/
+[vars]
+ADDON_ID="aiostreams.cfworker.bolabaden"
+ADDON_NAME="BadenAIO (CloudFlare)"
+DETERMINISTIC_ADDON_ID=false
+SECRET_KEY="1070c705d193441da9fce510d5977e824686d5d0a0ab44bc8d8cb006ff64ee82"
+API_KEY="sk_4dc059c0399c43fd94c09baaf0b94da119fc526775914bf2b3a3fb6e073e26d9"
+LOG_LEVEL="debug"
+LOG_FORMAT="text"
+LOG_SENSITIVE_INFO=true
+MAX_ADDONS=50
+MAX_KEYWORD_FILTERS=30
+DEFAULT_STREMTHRU_URL="https://stremthru.bolabaden.org/"
+DEFAULT_STREMTHRU_CREDENTIAL="[email protected]:Hilogirl80!"
+ENCRYPT_STREMTHRU_URLS=true
+COMET_URL="http://comet.elfhosted.com/"
+MEDIAFUSION_URL="http://mediafusion.elfhosted.com/"
+JACKETTIO_URL="https://jackettio.elfhosted.com/"
+DEFAULT_JACKETTIO_INDEXERS='["1337x", "animetosho", "anirena", "limetorrents", "nyaasi", "solidtorrents", "thepiratebay", "torlock", "yts"]'
+DEFAULT_JACKETTIO_STREMTHRU_URL="https://stremthru.bolabaden.org"
+STREMIO_JACKETT_URL="https://stremio-jackett.elfhosted.com/"
+DEFAULT_STREMIO_JACKETT_TMDB_API_KEY="cec876f852b9c15d2c1b436b1117dff7"
+STREMIO_JACKETT_CACHE_ENABLED=true
+STREMTHRU_STORE_URL="https://stremthru.bolabaden.org/stremio/store/"
+
+# Add other non-sensitive environment variables here
+
+# Bind the Workers AI model catalog. Run machine learning models, powered by serverless GPUs, on Cloudflare’s global network
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#workers-ai
+# [ai]
+# binding = "AI"
+
+# Bind an Analytics Engine dataset. Use Analytics Engine to write analytics within your Pages Function.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#analytics-engine-datasets
+# [[analytics_engine_datasets]]
+# binding = "MY_DATASET"
+
+# Bind a headless browser instance running on Cloudflare's global network.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#browser-rendering
+# [browser]
+# binding = "MY_BROWSER"
+
+# Bind a D1 database. D1 is Cloudflare’s native serverless SQL database.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#d1-databases
+# [[d1_databases]]
+# binding = "MY_DB"
+# database_name = "my-database"
+# database_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+
+# Bind a dispatch namespace. Use Workers for Platforms to deploy serverless functions programmatically on behalf of your customers.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#dispatch-namespace-bindings-workers-for-platforms
+# [[dispatch_namespaces]]
+# binding = "MY_DISPATCHER"
+# namespace = "my-namespace"
+
+# Bind a Durable Object. Durable objects are a scale-to-zero compute primitive based on the actor model.
+# Durable Objects can live for as long as needed. Use these when you need a long-running "server", such as in realtime apps.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#durable-objects
+# [[durable_objects.bindings]]
+# name = "MY_DURABLE_OBJECT"
+# class_name = "MyDurableObject"
+
+# Durable Object migrations.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#migrations
+# [[migrations]]
+# tag = "v1"
+# new_classes = ["MyDurableObject"]
+
+# Bind a Hyperdrive configuration. Use to accelerate access to your existing databases from Cloudflare Workers.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#hyperdrive
+# [[hyperdrive]]
+# binding = "MY_HYPERDRIVE"
+# id = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+
+# Bind a KV Namespace. Use KV as persistent storage for small key-value pairs.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#kv-namespaces
+# [[kv_namespaces]]
+# binding = "MY_KV_NAMESPACE"
+# id = "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
+
+# Bind an mTLS certificate. Use to present a client certificate when communicating with another service.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#mtls-certificates
+# [[mtls_certificates]]
+# binding = "MY_CERTIFICATE"
+# certificate_id = "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
+
+# Bind a Queue producer. Use this binding to schedule an arbitrary task that may be processed later by a Queue consumer.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#queues
+# [[queues.producers]]
+# binding = "MY_QUEUE"
+# queue = "my-queue"
+
+# Bind a Queue consumer. Queue Consumers can retrieve tasks scheduled by Producers to act on them.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#queues
+# [[queues.consumers]]
+# queue = "my-queue"
+
+# Bind an R2 Bucket. Use R2 to store arbitrarily large blobs of data, such as files.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#r2-buckets
+# [[r2_buckets]]
+# binding = "MY_BUCKET"
+# bucket_name = "my-bucket"
+
+# Bind another Worker service. Use this binding to call another Worker without network overhead.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#service-bindings
+# [[services]]
+# binding = "MY_SERVICE"
+# service = "my-service"
+
+# Bind a Vectorize index. Use to store and query vector embeddings for semantic search, classification and other vector search use-cases.
+# Docs: https://developers.cloudflare.com/workers/wrangler/configuration/#vectorize-indexes
+# [[vectorize]]
+# binding = "MY_INDEX"
+# index_name = "my-index"

packages/core/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@aiostreams/core",
+  "version": "0.0.0",
+  "main": "dist/index.js",
+  "scripts": {
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest watch",
+    "build": "tsc"
+  },
+  "description": "Combine all your streams into one addon and display them with consistent formatting, sorting, and filtering.",
+  "dependencies": {
+    "bcrypt": "^6.0.0",
+    "bytes": "^3.1.2",
+    "dotenv": "^16.4.7",
+    "envalid": "^8.0.0",
+    "expr-eval": "^2.0.2",
+    "moment-timezone": "^0.5.48",
+    "parse-torrent-title": "github:TheBeastLT/parse-torrent-title",
+    "pg": "^8.16.0",
+    "sqlite": "^5.1.1",
+    "sqlite3": "^5.1.7",
+    "super-regex": "^1.0.0",
+    "undici": "^7.2.3",
+    "winston": "^3.17.0",
+    "zod": "^3.24.4"
+  },
+  "devDependencies": {
+    "@types/bcrypt": "^5.0.2",
+    "@types/bytes": "^3.1.5",
+    "@types/node": "^20.14.10",
+    "@types/pg": "^8.15.2"
+  }
+}

packages/core/src/db/db.ts

@@ -0,0 +1,230 @@
+import { TABLES } from './schemas';
+import { createLogger } from '../utils';
+import { parseConnectionURI, adaptQuery, ConnectionURI } from './utils';
+
+const logger = createLogger('database');
+
+import { Pool, Client, QueryResult } from 'pg';
+import sqlite3 from 'sqlite3';
+import { open, Database } from 'sqlite';
+import { URL } from 'url';
+import path from 'path';
+import fs from 'fs';
+
+type QueryResultRow = Record<string, any>;
+
+interface UnifiedQueryResult<T = QueryResultRow> {
+  rows: T[];
+  rowCount: number;
+  command?: string;
+}
+
+type DBDialect = 'postgres' | 'sqlite';
+
+type DSNModifier = (url: URL, query: URLSearchParams) => void;
+
+type Transaction = {
+  commit: () => Promise<void>;
+  rollback: () => Promise<void>;
+  execute: (query: string, params?: any[]) => Promise<UnifiedQueryResult<any>>;
+};
+
+export class DB {
+  private static instance: DB;
+  private db!: Pool | Database<any>;
+  private static initialised: boolean = false;
+  private static dialect: DBDialect;
+  private uri!: ConnectionURI;
+  private dsnModifiers: DSNModifier[] = [];
+
+  private constructor() {}
+
+  static getInstance(): DB {
+    if (!this.instance) {
+      this.instance = new DB();
+    }
+    return this.instance;
+  }
+  isInitialised(): boolean {
+    return DB.initialised;
+  }
+
+  getDialect(): DBDialect {
+    return DB.dialect;
+  }
+
+  async initialise(
+    uri: string,
+    dsnModifiers: DSNModifier[] = []
+  ): Promise<void> {
+    if (DB.initialised) {
+      return;
+    }
+    try {
+      this.uri = parseConnectionURI(uri);
+      this.dsnModifiers = dsnModifiers;
+      await this.open();
+      await this.ping();
+
+      // create tables
+      for (const [name, schema] of Object.entries(TABLES)) {
+        const createTableQuery = `CREATE TABLE IF NOT EXISTS ${name} (${schema})`;
+        await this.execute(createTableQuery);
+      }
+
+      if (this.uri.dialect === 'sqlite') {
+        await this.execute('PRAGMA busy_timeout = 5000');
+        await this.execute('PRAGMA foreign_keys = ON');
+        await this.execute('PRAGMA synchronous = OFF');
+        await this.execute('PRAGMA journal_mode = WAL');
+        await this.execute('PRAGMA locking_mode = IMMEDIATE');
+      }
+
+      DB.initialised = true;
+      DB.dialect = this.uri.dialect;
+    } catch (error) {
+      logger.error('Failed to initialize database:', error);
+      throw error;
+    }
+  }
+
+  async open(): Promise<void> {
+    if (this.uri.dialect === 'postgres') {
+      const pool = new Pool({
+        connectionString: this.uri.url.toString(),
+        idleTimeoutMillis: 30000,
+        connectionTimeoutMillis: 2000,
+      });
+      this.db = pool;
+      this.uri.dialect = 'postgres';
+    } else if (this.uri.dialect === 'sqlite') {
+      // make parent directory if it does not exist
+      const parentDir = path.dirname(this.uri.filename);
+      if (!parentDir) {
+        throw new Error('Invalid SQLite path');
+      }
+      if (!fs.existsSync(parentDir)) {
+        fs.mkdirSync(parentDir, { recursive: true });
+      }
+      logger.debug(`Opening SQLite database: ${this.uri.filename}`);
+
+      this.db = await open({
+        filename: this.uri.filename,
+        driver: sqlite3.Database,
+      });
+      this.uri.dialect = 'sqlite';
+    }
+  }
+
+  async close(): Promise<void> {
+    if (this.uri.dialect === 'postgres') {
+      await (this.db as Pool).end();
+    } else if (this.uri.dialect === 'sqlite') {
+      await (this.db as Database<any>).close();
+    }
+  }
+
+  async ping(): Promise<void> {
+    if (this.uri.dialect === 'postgres') {
+      await (this.db as Pool).query('SELECT 1');
+    } else if (this.uri.dialect === 'sqlite') {
+      await (this.db as Database<any>).get('SELECT 1');
+    }
+  }
+
+  async execute(query: string, params?: any[]): Promise<any> {
+    if (this.uri.dialect === 'postgres') {
+      return (this.db as Pool).query(
+        adaptQuery(query, this.uri.dialect),
+        params
+      );
+    } else if (this.uri.dialect === 'sqlite') {
+      return (this.db as Database<any>).run(
+        adaptQuery(query, this.uri.dialect),
+        params
+      );
+    }
+    throw new Error('Unsupported dialect');
+  }
+
+  async query(query: string, params?: any[]): Promise<any[]> {
+    const adaptedQuery = adaptQuery(query, this.uri.dialect);
+    if (this.uri.dialect === 'postgres') {
+      const result = await (this.db as Pool).query(adaptedQuery, params);
+      return result.rows;
+    } else if (this.uri.dialect === 'sqlite') {
+      return (this.db as Database<any>).all(adaptedQuery, params);
+    }
+    return [];
+  }
+
+  async begin(): Promise<Transaction> {
+    if (this.uri.dialect === 'postgres') {
+      const client = await (this.db as Pool).connect();
+      await client.query('BEGIN');
+
+      let finalised = false;
+
+      const finalise = () => {
+        if (!finalised) {
+          finalised = true;
+          client.release();
+        }
+      };
+
+      return {
+        commit: async () => {
+          try {
+            await client.query('COMMIT');
+          } finally {
+            finalise();
+          }
+        },
+        rollback: async () => {
+          try {
+            await client.query('ROLLBACK');
+          } finally {
+            finalise();
+          }
+        },
+        execute: async (
+          query: string,
+          params?: any[]
+        ): Promise<UnifiedQueryResult> => {
+          const result = await client.query(
+            adaptQuery(query, 'postgres'),
+            params
+          );
+          return {
+            rows: result.rows,
+            rowCount: result.rowCount || 0,
+            command: result.command,
+          };
+        },
+      };
+    } else if (this.uri.dialect === 'sqlite') {
+      const db = this.db as Database<any>;
+      await db.run('BEGIN');
+      return {
+        commit: async () => {
+          await db.run('COMMIT');
+        },
+        rollback: async () => {
+          await db.run('ROLLBACK');
+        },
+        execute: async (
+          query: string,
+          params?: any[]
+        ): Promise<UnifiedQueryResult> => {
+          const result = await db.all(adaptQuery(query, 'sqlite'), params);
+          return {
+            rows: result,
+            rowCount: result.length || 0,
+            command: 'SELECT',
+          };
+        },
+      };
+    }
+    throw new Error('Unsupported transaction dialect');
+  }
+}

packages/core/src/db/index.ts

@@ -0,0 +1,4 @@
+export * from './db';
+export * from './users';
+export * from './schemas';
+export * from './queue';

packages/core/src/db/queue.ts

@@ -0,0 +1,58 @@
+import { createLogger } from '../utils';
+import { DB } from './db';
+const logger = createLogger('db');
+const db = DB.getInstance();
+
+// Queue for SQLite transactions
+
+export class TransactionQueue {
+  private queue: Array<() => Promise<any>> = [];
+  private processing = false;
+  private static instance: TransactionQueue;
+
+  private constructor() {}
+
+  static getInstance(): TransactionQueue {
+    if (!this.instance) {
+      this.instance = new TransactionQueue();
+    }
+    return this.instance;
+  }
+
+  async enqueue<T>(operation: () => Promise<T>): Promise<T> {
+    // If using PostgreSQL, execute directly without queuing
+    if (db['uri']?.dialect === 'postgres') {
+      return operation();
+    }
+
+    return new Promise((resolve, reject) => {
+      this.queue.push(async () => {
+        try {
+          const result = await operation();
+          resolve(result);
+        } catch (error) {
+          reject(error);
+        }
+      });
+      this.processQueue();
+    });
+  }
+
+  private async processQueue() {
+    if (this.processing || this.queue.length === 0) return;
+    this.processing = true;
+
+    while (this.queue.length > 0) {
+      const operation = this.queue.shift();
+      if (operation) {
+        try {
+          await operation();
+        } catch (error) {
+          logger.error('Error processing queued operation:', error);
+        }
+      }
+    }
+
+    this.processing = false;
+  }
+}