@muhammedaksam/easiarr 1.1.0 → 1.1.2

package/src/api/jellyseerr-api.ts

@@ -237,6 +237,15 @@ export class JellyseerrClient implements IAutoSetupClient {
     })
   }
 
+  /**
+   * Set application URL for external access
+   * URL will be used for links to Jellyseerr from other apps
+   */
+  async setApplicationUrl(applicationUrl: string): Promise<JellyseerrMainSettings> {
+    debugLog("Jellyseerr", `Setting applicationUrl to: ${applicationUrl}`)
+    return this.updateMainSettings({ applicationUrl })
+  }
+
   // ==========================================
   // Jellyfin Configuration
   // ==========================================
@@ -383,6 +392,13 @@ export class JellyseerrClient implements IAutoSetupClient {
     })
   }
 
+  async updateRadarr(id: number, settings: Partial<JellyseerrRadarrSettings>): Promise<JellyseerrRadarrSettings> {
+    return this.request<JellyseerrRadarrSettings>(`/settings/radarr/${id}`, {
+      method: "PUT",
+      body: JSON.stringify(settings),
+    })
+  }
+
   // ==========================================
   // Sonarr Configuration
   // ==========================================
@@ -411,6 +427,13 @@ export class JellyseerrClient implements IAutoSetupClient {
     })
   }
 
+  async updateSonarr(id: number, settings: Partial<JellyseerrSonarrSettings>): Promise<JellyseerrSonarrSettings> {
+    return this.request<JellyseerrSonarrSettings>(`/settings/sonarr/${id}`, {
+      method: "PUT",
+      body: JSON.stringify(settings),
+    })
+  }
+
   // ==========================================
   // Full Setup Wizard
   // ==========================================
@@ -453,14 +476,32 @@ export class JellyseerrClient implements IAutoSetupClient {
 
   /**
    * Configure Radarr connection with auto-detection of profiles
+   * @param externalUrl - Optional external URL for navigation (e.g., https://radarr.example.com)
    */
   async configureRadarr(
     hostname: string,
     port: number,
     apiKey: string,
-    rootFolder: string
+    rootFolder: string,
+    externalUrl?: string
   ): Promise<JellyseerrRadarrSettings | null> {
     try {
+      // Check if Radarr is already configured
+      const existingConfigs = await this.getRadarrSettings()
+      const existingConfig = existingConfigs.find((c) => c.hostname === hostname && c.port === port)
+
+      if (existingConfig?.id) {
+        // Update existing configuration (just update externalUrl)
+        // Note: id must be excluded from body - it's read-only in the API
+        debugLog("Jellyseerr", `Updating existing Radarr config (id: ${existingConfig.id})`)
+        const { id, ...configWithoutId } = existingConfig
+        return await this.updateRadarr(id, {
+          ...configWithoutId,
+          externalUrl,
+        })
+      }
+
+      // Test connection and get profiles
       const testResult = await this.testRadarr({
         hostname,
         port,
@@ -487,6 +528,7 @@ export class JellyseerrClient implements IAutoSetupClient {
         is4k: false,
         minimumAvailability: "announced",
         isDefault: true,
+        externalUrl,
       })
     } catch (e) {
       debugLog("Jellyseerr", `Radarr config failed: ${e}`)
@@ -496,14 +538,32 @@ export class JellyseerrClient implements IAutoSetupClient {
 
   /**
    * Configure Sonarr connection with auto-detection of profiles
+   * @param externalUrl - Optional external URL for navigation (e.g., https://sonarr.example.com)
    */
   async configureSonarr(
     hostname: string,
     port: number,
     apiKey: string,
-    rootFolder: string
+    rootFolder: string,
+    externalUrl?: string
   ): Promise<JellyseerrSonarrSettings | null> {
     try {
+      // Check if Sonarr is already configured
+      const existingConfigs = await this.getSonarrSettings()
+      const existingConfig = existingConfigs.find((c) => c.hostname === hostname && c.port === port)
+
+      if (existingConfig?.id) {
+        // Update existing configuration (just update externalUrl)
+        // Note: id must be excluded from body - it's read-only in the API
+        debugLog("Jellyseerr", `Updating existing Sonarr config (id: ${existingConfig.id})`)
+        const { id, ...configWithoutId } = existingConfig
+        return await this.updateSonarr(id, {
+          ...configWithoutId,
+          externalUrl,
+        })
+      }
+
+      // Test connection and get profiles
       const testResult = await this.testSonarr({
         hostname,
         port,
@@ -530,6 +590,7 @@ export class JellyseerrClient implements IAutoSetupClient {
         is4k: false,
         enableSeasonFolders: true,
         isDefault: true,
+        externalUrl,
       })
     } catch (e) {
       debugLog("Jellyseerr", `Sonarr config failed: ${e}`)
@@ -550,10 +611,27 @@ export class JellyseerrClient implements IAutoSetupClient {
         return { success: false, message: "Jellyseerr not reachable" }
       }
 
+      // Get Jellyfin connection details from env
+      const jellyfinHost = env["JELLYFIN_HOST"] || "jellyfin"
+      const jellyfinPort = parseInt(env["JELLYFIN_PORT"] || "8096", 10)
+
       // Check if already initialized
       const initialized = await this.isInitialized()
       if (initialized) {
-        // Get API key from settings
+        // Authenticate first to get session cookie (needed for protected endpoints)
+        try {
+          await this.authenticateJellyfin(username, password, jellyfinHost, jellyfinPort)
+          debugLog("Jellyseerr", "Authenticated to already-initialized instance")
+        } catch (authError) {
+          debugLog("Jellyseerr", `Auth failed on initialized instance: ${authError}`)
+          // Still return success, just without API key access
+          return {
+            success: true,
+            message: "Already configured (could not authenticate)",
+          }
+        }
+
+        // Now we can access protected endpoints with our session cookie
         const settings = await this.getMainSettings()
         return {
           success: true,
@@ -563,11 +641,7 @@ export class JellyseerrClient implements IAutoSetupClient {
         }
       }
 
-      // Get Jellyfin connection details from env
-      const jellyfinHost = env["JELLYFIN_HOST"] || "jellyfin"
-      const jellyfinPort = parseInt(env["JELLYFIN_PORT"] || "8096", 10)
-
-      // Run the setup wizard
+      // Run the setup wizard (authenticates as part of setup)
       const apiKey = await this.runJellyfinSetup(jellyfinHost, jellyfinPort, username, password)
 
       // Mark as initialized

package/src/api/naming-config.ts

@@ -0,0 +1,67 @@
+export interface RadarrNamingConfig {
+  renameMovies: boolean
+  replaceIllegalCharacters: boolean
+  colonReplacementFormat: "dash" | "spaceDash" | "spaceDashSpace" | "smart" | "delete" | number
+  standardMovieFormat: string
+  movieFolderFormat: string
+  includeQuality: boolean
+  replaceSpaces: boolean
+}
+
+export interface SonarrNamingConfig {
+  renameEpisodes: boolean
+  replaceIllegalCharacters: boolean
+  colonReplacementFormat: "dash" | "spaceDash" | "spaceDashSpace" | "smart" | "delete" | number
+  multiEpisodeStyle: "extend" | "duplicate" | "repeat" | "scene" | "range" | "prefixedRange" | number
+  dailyEpisodeFormat: string
+  animeEpisodeFormat: string
+  seriesFolderFormat: string
+  seasonFolderFormat: string
+  standardEpisodeFormat: string
+  includeSeriesTitle: boolean
+  includeEpisodeTitle: boolean
+  includeQuality: boolean
+  replaceSpaces: boolean
+  separator: string
+  numberStyle: string
+}
+
+export type NamingConfig = RadarrNamingConfig | SonarrNamingConfig
+
+// TRaSH Guides Recommended Naming Schemes
+// Source: https://trash-guides.info/Radarr/Radarr-recommended-naming-scheme/
+// Source: https://trash-guides.info/Sonarr/Sonarr-recommended-naming-scheme/
+
+export const TRASH_NAMING_CONFIG = {
+  radarr: {
+    renameMovies: true,
+    replaceIllegalCharacters: true,
+    colonReplacementFormat: "dash",
+    standardMovieFormat:
+      "{Movie CleanTitle} ({Release Year}) {edition-{Edition Tags}} {[Custom Formats]}{[Quality Full]}{[MediaInfo 3D]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo VideoCodec]}{-Release Group}",
+    movieFolderFormat: "{Movie CleanTitle} ({Release Year})",
+    includeQuality: true,
+    replaceSpaces: false,
+  } as RadarrNamingConfig,
+
+  sonarr: {
+    renameEpisodes: true,
+    replaceIllegalCharacters: true,
+    colonReplacementFormat: 1, // 1 = Dash
+    multiEpisodeStyle: 5, // 5 = Prefixed Range
+    standardEpisodeFormat:
+      "{Series TitleYear} - S{season:00}E{episode:00} - {Episode CleanTitle} {[Custom Formats]}{[Quality Full]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo VideoCodec]}{-Release Group}",
+    dailyEpisodeFormat:
+      "{Series TitleYear} - {Air-Date} - {Episode CleanTitle} {[Custom Formats]}{[Quality Full]}{[MediaInfo 3D]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{[MediaInfo VideoDynamicRangeType]}{[Mediainfo VideoCodec]}{-Release Group}",
+    animeEpisodeFormat:
+      "{Series TitleYear} - S{season:00}E{episode:00} - {absolute:000} - {Episode CleanTitle} {[Custom Formats]}{[Quality Full]}{[MediaInfo 3D]}{[Mediainfo AudioCodec}{ Mediainfo AudioChannels]}{MediaInfo AudioLanguages}{[MediaInfo VideoDynamicRangeType]}[{Mediainfo VideoCodec }{MediaInfo VideoBitDepth}bit]{-Release Group}",
+    seriesFolderFormat: "{Series TitleYear}",
+    seasonFolderFormat: "Season {season:00}",
+    includeSeriesTitle: true,
+    includeEpisodeTitle: true,
+    includeQuality: true,
+    replaceSpaces: false,
+    separator: " - ",
+    numberStyle: "S{season:00}E{episode:00}",
+  } as SonarrNamingConfig,
+}

package/src/api/overseerr-api.ts

@@ -254,6 +254,30 @@ export class OverseerrClient implements IAutoSetupClient {
     return null
   }
 
+  /**
+   * Set application URL for external access
+   * URL will be used for links to Overseerr from other apps
+   */
+  async setApplicationUrl(applicationUrl: string): Promise<boolean> {
+    debugLog("OverseerrApi", `Setting applicationUrl to: ${applicationUrl}`)
+
+    try {
+      const response = await fetch(`${this.baseUrl}/api/v1/settings/main`, {
+        method: "POST",
+        headers: this.getHeaders(),
+        body: JSON.stringify({ applicationUrl }),
+      })
+
+      if (response.ok) {
+        debugLog("OverseerrApi", "Application URL set successfully")
+        return true
+      }
+    } catch (error) {
+      debugLog("OverseerrApi", `Failed to set application URL: ${error}`)
+    }
+    return false
+  }
+
   /**
    * Sync Plex libraries
    */

package/src/api/qbittorrent-api.ts

@@ -14,6 +14,33 @@ export interface QBittorrentPreferences {
   auto_tmm_enabled?: boolean
   category_changed_tmm_enabled?: boolean
   save_path_changed_tmm_enabled?: boolean
+  max_ratio?: number
+  max_ratio_enabled?: boolean
+  max_ratio_act?: number // 0 = Pause, 1 = Remove
+  max_seeding_time?: number
+  max_seeding_time_enabled?: boolean
+  queueing_enabled?: boolean
+  web_ui_username?: string
+  web_ui_password?: string
+  // Connection & Speed
+  listen_port?: number
+  upnp?: boolean
+  natpmp?: boolean
+  dl_limit?: number
+  up_limit?: number
+  limit_utp_rate?: boolean
+  limit_tcp_overhead?: boolean
+  limit_lan_peers?: boolean
+  // Bittorrent
+  enable_dht?: boolean
+  enable_pex?: boolean
+  enable_lsd?: boolean
+  encryption_mode?: number // 0=Prefer, 1=Force, 2=Allow (check API docs for exact enum, typically 1=Force or Allow)
+  anonymous_mode?: boolean
+  add_trackers_enabled?: boolean
+  pre_allocate_all?: boolean
+  incomplete_files_ext?: boolean
+  create_subfolder_enabled?: boolean
 }
 
 export interface QBittorrentCategory {
@@ -197,6 +224,37 @@ export class QBittorrentClient implements IAutoSetupClient {
       auto_tmm_enabled: true,
       category_changed_tmm_enabled: true,
       save_path_changed_tmm_enabled: true,
+
+      // Downloads
+      pre_allocate_all: false, // Recommended disabled for unRaid/cache drives, safe default
+      incomplete_files_ext: true, // Recommended: Enabled
+      create_subfolder_enabled: true, // Recommended: Enabled
+
+      // Connection
+      upnp: false, // Recommended: Disabled (use manual port forward)
+      natpmp: false, // Recommended: Disabled
+
+      // Speed
+      dl_limit: -1, // Unlimited
+      up_limit: -1, // Unlimited (User should tune if needed)
+      limit_utp_rate: true, // Recommended: Enabled
+      limit_tcp_overhead: false, // Recommended: Disabled
+      limit_lan_peers: true, // Recommended: Enabled
+
+      // Bittorrent
+      enable_dht: true, // Implied enabled
+      enable_pex: true, // Implied enabled
+      enable_lsd: true, // Implied enabled
+      encryption_mode: 0, // 0 = Prefer Encryption (closest to "Allow encryption" usually, need to verify enum. 1=Force, 2=None usually. Let's assume 0 is safe/default or check docs if possible. TRaSH says "Allow encryption")
+      anonymous_mode: false, // Recommended: Disabled
+      add_trackers_enabled: false, // Recommended: Disabled for private trackers
+      queueing_enabled: true, // Recommended: Personal preference, enabled by default
+
+      // Seeding Limits (TRaSH Recommended: Disable globally)
+      max_ratio: -1, // -1 = Unlimited
+      max_ratio_enabled: false,
+      max_seeding_time_enabled: false,
+      max_ratio_act: 0, // 0 = Pause (Safe fallback)
     }
 
     if (auth) {

package/src/api/quality-profile-api.ts

@@ -3,6 +3,9 @@
  * Manages Quality Profiles and Custom Format scoring for Radarr/Sonarr
  */
 
+import { debugLog } from "../utils/debug"
+import { TRASH_RADARR_QUALITY_DEFINITIONS, TRASH_SONARR_QUALITY_DEFINITIONS } from "../config/trash-quality-definitions"
+
 export interface QualityItem {
   id?: number
   name?: string
@@ -112,10 +115,23 @@ export class QualityProfileClient {
   }
 
   async updateQualityDefinitions(definitions: QualityDefinition[]): Promise<QualityDefinition[]> {
-    return this.request<QualityDefinition[]>("/qualitydefinition/update", {
-      method: "PUT",
-      body: JSON.stringify(definitions),
-    })
+    const updated: QualityDefinition[] = []
+
+    // Update each definition individually as bulk update is not reliably supported across all versions
+    for (const def of definitions) {
+      if (!def.id) continue
+
+      try {
+        const result = await this.request<QualityDefinition>(`/qualitydefinition/${def.id}`, {
+          method: "PUT",
+          body: JSON.stringify(def),
+        })
+        updated.push(result)
+      } catch (e) {
+        debugLog("QualityProfile", `Failed to update definition ${def.id}: ${e}`)
+      }
+    }
+    return updated
   }
 
   // Helper: Get quality by name from existing profiles
@@ -202,4 +218,38 @@ export class QualityProfileClient {
 
     return this.updateQualityProfile(profileId, profile)
   }
+
+  // Apply TRaSH Quality Definitions (File Size Limits)
+  async updateTrashQualityDefinitions(appType: "radarr" | "sonarr"): Promise<void> {
+    try {
+      debugLog("QualityProfile", `Updating Quality Definitions for ${appType}`)
+      const definitions = await this.getQualityDefinitions()
+      const trashDefs = appType === "radarr" ? TRASH_RADARR_QUALITY_DEFINITIONS : TRASH_SONARR_QUALITY_DEFINITIONS
+      let updatedCount = 0
+
+      const newDefinitions = definitions.map((def) => {
+        const trashDef = trashDefs.find((t) => t.quality === def.quality.name)
+        if (trashDef) {
+          updatedCount++
+          return {
+            ...def,
+            minSize: trashDef.min,
+            maxSize: trashDef.max,
+            preferredSize: trashDef.preferred,
+          }
+        }
+        return def
+      })
+
+      if (updatedCount > 0) {
+        await this.updateQualityDefinitions(newDefinitions)
+        debugLog("QualityProfile", `Successfully updated ${updatedCount} quality definitions`)
+      } else {
+        debugLog("QualityProfile", "No matching quality definitions found to update")
+      }
+    } catch (e) {
+      debugLog("QualityProfile", `Failed to update quality definitions: ${e}`)
+      throw e
+    }
+  }
 }

package/src/apps/registry.ts

@@ -248,6 +248,17 @@ export const APPS: Record<AppId, AppDefinition> = {
       LOG_HTML: "false",
       CAPTCHA_SOLVER: "none",
     },
+    homepage: {
+      icon: "flaresolverr.png",
+      widget: "customapi",
+      widgetFields: {
+        url: "http://flaresolverr:8191",
+        mappings: JSON.stringify([
+          { field: "msg", label: "Status" },
+          { field: "version", label: "Version" },
+        ]),
+      },
+    },
   },
 
   // === DOWNLOAD CLIENTS ===
@@ -503,6 +514,26 @@ export const APPS: Record<AppId, AppDefinition> = {
     puid: 0,
     pgid: 13000,
     volumes: (root) => [`${root}/config/huntarr:/config`],
+    dependsOn: ["sonarr", "radarr", "lidarr", "readarr"],
+    homepage: {
+      icon: "huntarr.png",
+      widget: "customapi",
+      widgetFields: {
+        url: "http://huntarr:9705/api/cycle/status",
+        mappings: JSON.stringify([
+          { field: "sonarr.next_cycle", label: "Sonarr", format: "relativeDate" },
+          { field: "radarr.next_cycle", label: "Radarr", format: "relativeDate" },
+          { field: "lidarr.next_cycle", label: "Lidarr", format: "relativeDate" },
+          { field: "readarr.next_cycle", label: "Readarr", format: "relativeDate" },
+          { field: "whisparr.next_cycle", label: "Whisparr", format: "relativeDate" },
+        ]),
+      },
+    },
+    autoSetup: {
+      type: "full",
+      description: "Test connections to Sonarr, Radarr, Lidarr, Readarr, Whisparr",
+      requires: ["sonarr", "radarr"],
+    },
   },
 
   unpackerr: {
@@ -627,7 +658,10 @@ export const APPS: Record<AppId, AppDefinition> = {
       widget: "customapi",
       widgetFields: {
         url: "http://easiarr:8080/config.json",
-        mappings: JSON.stringify([{ field: "version", label: "Installed" }]),
+        mappings: JSON.stringify([
+          { field: "version", label: "Version" },
+          { field: "apps.length", label: "Apps" },
+        ]),
       },
     },
   },

package/src/config/homepage-config.ts

@@ -24,7 +24,7 @@ export function getHomepageConfigPath(config: EasiarrConfig): string {
  * Homepage service entry
  */
 interface HomepageService {
-  href: string
+  href?: string // Optional - cloudflared has no web UI
   icon?: string
   description?: string
   ping?: string
@@ -63,10 +63,22 @@ export async function generateServicesYaml(config: EasiarrConfig): Promise<strin
     const dockerUrl = `http://${appDef.id}:${internalPort}`
 
     const service: HomepageService = {
-      href: baseUrl,
       description: appDef.description,
     }
 
+    // Special cases for href/ping
+    if (appDef.id === "cloudflared") {
+      // Cloudflared has no web UI - skip href/ping
+    } else if (appDef.id === "traefik") {
+      // Traefik dashboard is on port 8083 (secondary port), not 80 (proxy)
+      const dashboardUrl = `http://${localIp}:8083`
+      service.href = dashboardUrl
+      service.ping = dashboardUrl
+    } else {
+      service.href = baseUrl
+      service.ping = baseUrl
+    }
+
     // Add icon if defined in homepage meta
     if (appDef.homepage?.icon) {
       service.icon = appDef.homepage.icon
@@ -75,9 +87,6 @@ export async function generateServicesYaml(config: EasiarrConfig): Promise<strin
       service.icon = `${appDef.id}.png`
     }
 
-    // Add ping for monitoring
-    service.ping = baseUrl
-
     // Add widget if defined
     if (appDef.homepage?.widget) {
       const apiKey = env[`API_KEY_${appDef.id.toUpperCase()}`]
@@ -114,7 +123,10 @@ export async function generateServicesYaml(config: EasiarrConfig): Promise<strin
         // Skip widget if no API key
       }
       // Most widgets need API key - only add if available
-      else if (apiKey || ["qbittorrent", "gluetun", "traefik"].includes(appDef.id)) {
+      else if (
+        apiKey ||
+        ["qbittorrent", "gluetun", "traefik", "huntarr", "easiarr", "flaresolverr"].includes(appDef.id)
+      ) {
         service.widget = {
           type: widgetType,
           url: dockerUrl,
@@ -165,6 +177,19 @@ export async function generateServicesYaml(config: EasiarrConfig): Promise<strin
         if (appDef.homepage.widgetFields) {
           Object.assign(service.widget, appDef.homepage.widgetFields)
         }
+
+        // Huntarr: dynamically build mappings based on enabled *arr apps
+        if (appDef.id === "huntarr") {
+          const huntarrApps = ["radarr", "sonarr", "lidarr", "whisparr", "readarr"]
+          const mappings = huntarrApps
+            .filter((appId) => config.apps.some((a) => a.id === appId && a.enabled))
+            .map((appId) => ({
+              field: `${appId}.next_cycle`,
+              label: appId.charAt(0).toUpperCase() + appId.slice(1),
+              format: "relativeDate",
+            }))
+          service.widget.mappings = JSON.stringify(mappings)
+        }
       }
       // If widget requires API key and none is set, skip widget but keep ping/icon
     }
@@ -223,7 +248,10 @@ export async function generateServicesYaml(config: EasiarrConfig): Promise<strin
 
     for (const { name, service } of services) {
       yaml += `    - ${name}:\n`
-      yaml += `        href: ${service.href}\n`
+
+      if (service.href) {
+        yaml += `        href: ${service.href}\n`
+      }
 
       if (service.icon) {
         yaml += `        icon: ${service.icon}\n`
@@ -240,7 +268,9 @@ export async function generateServicesYaml(config: EasiarrConfig): Promise<strin
       if (service.widget) {
         yaml += `        widget:\n`
         yaml += `          type: ${service.widget.type}\n`
-        yaml += `          url: ${service.widget.url}\n`
+        if (service.widget.url) {
+          yaml += `          url: ${service.widget.url}\n`
+        }
 
         if (service.widget.key) {
           yaml += `          key: ${service.widget.key}\n`
@@ -299,6 +329,11 @@ cardBlur: md
 theme: dark
 color: slate
 
+# Docker integration for label-based widget autodiscovery
+# Some apps (e.g., Huntarr) use Docker labels instead of API keys
+docker:
+  enable: true
+
 layout:
   Media Management:
     style: row
@@ -330,11 +365,9 @@ export async function saveHomepageConfig(config: EasiarrConfig): Promise<{ servi
   const servicesYaml = await generateServicesYaml(config)
   await writeFile(servicesPath, servicesYaml, "utf-8")
 
-  // Generate and save settings.yaml (only if doesn't exist)
-  if (!existsSync(settingsPath)) {
-    const settingsYaml = generateSettingsYaml()
-    await writeFile(settingsPath, settingsYaml, "utf-8")
-  }
+  // Generate and save settings.yaml (always regenerate to include docker integration)
+  const settingsYaml = generateSettingsYaml()
+  await writeFile(settingsPath, settingsYaml, "utf-8")
 
   return { services: servicesPath, settings: settingsPath }
 }