@muhammedaksam/easiarr 1.1.1 → 1.1.3

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@muhammedaksam/easiarr",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "TUI tool for generating docker-compose files for the *arr media ecosystem with 41 apps, TRaSH Guides best practices, VPN routing, and Traefik reverse proxy support",
   "module": "src/index.ts",
   "type": "module",

package/src/api/arr-api.ts

@@ -46,6 +46,7 @@ export interface RemotePathMapping {
 
 import type { AppId } from "../config/schema"
 import { getCategoryForApp, getCategoryFieldName } from "../utils/categories"
+import { TRASH_NAMING_CONFIG, type NamingConfig } from "./naming-config"
 
 // qBittorrent download client config
 export function createQBittorrentConfig(
@@ -239,11 +240,63 @@ export class ArrApiClient {
     })
   }
 
+  /**
+   * Set application URL for external access (e.g., from Jellyseerr/dashboard links)
+   * URL will be used when generating external links in the app
+   */
+  async setApplicationUrl(applicationUrl: string): Promise<HostConfig> {
+    const currentConfig = await this.getHostConfig()
+
+    const updatedConfig: HostConfig = {
+      ...currentConfig,
+      applicationUrl,
+    }
+
+    debugLog("ArrAPI", `Setting applicationUrl to: ${applicationUrl}`)
+
+    return this.request<HostConfig>("/config/host", {
+      method: "PUT",
+      body: JSON.stringify(updatedConfig),
+    })
+  }
+
   // Remote Path Mapping methods - for Docker path translation
+
   async getRemotePathMappings(): Promise<RemotePathMapping[]> {
     return this.request<RemotePathMapping[]>("/remotepathmapping")
   }
 
+  // Naming Configuration methods
+  async getNamingConfig<T extends NamingConfig>(): Promise<T> {
+    return this.request<T>("/config/naming")
+  }
+
+  async updateNamingConfig<T extends NamingConfig>(config: T): Promise<T> {
+    return this.request<T>("/config/naming", {
+      method: "PUT",
+      body: JSON.stringify(config),
+    })
+  }
+
+  async configureTRaSHNaming(appType: "radarr" | "sonarr"): Promise<void> {
+    try {
+      // 1. Get current configuration to preserve ID and other fields
+      const currentConfig = await this.getNamingConfig<NamingConfig & { id?: number }>()
+
+      // 2. Merge with TRaSH defaults
+      const trashConfig = TRASH_NAMING_CONFIG[appType]
+      const newConfig = {
+        ...currentConfig,
+        ...trashConfig,
+      }
+
+      // 3. Update configuration
+      await this.updateNamingConfig(newConfig)
+    } catch (e) {
+      throw new Error(`Failed to configure naming: ${e}`)
+    }
+  }
+
   async addRemotePathMapping(host: string, remotePath: string, localPath: string): Promise<RemotePathMapping> {
     return this.request<RemotePathMapping>("/remotepathmapping", {
       method: "POST",

package/src/api/bazarr-api.ts

@@ -6,6 +6,19 @@
 import { debugLog } from "../utils/debug"
 import type { IAutoSetupClient, AutoSetupOptions, AutoSetupResult } from "./auto-setup-types"
 
+/**
+ * Bazarr Language Profile Structure
+ */
+export interface BazarrLanguageProfile {
+  name: string
+  cutoff: string
+  languages: {
+    code: string
+    forced: boolean
+    hi: boolean
+  }[]
+}
+
 /**
  * Bazarr System Settings (partial - auth related fields)
  */
@@ -232,6 +245,76 @@ export class BazarrApiClient implements IAutoSetupClient {
     }
   }
 
+  /**
+   * Configure General Settings (TRaSH Recommended)
+   */
+  async configureGeneralSettings(): Promise<boolean> {
+    try {
+      debugLog("Bazarr", "Configuring general settings")
+      await this.postForm("/system/settings", {
+        "settings-subtitles-use_embedded_subtitles": "true",
+        "settings-subtitles-autosearch": "true",
+        "settings-subtitles-path_mapping": "", // Empty = Alongside Media File
+      })
+      return true
+    } catch (e) {
+      debugLog("Bazarr", `Failed to configure general settings: ${e}`)
+      return false
+    }
+  }
+
+  /**
+   * Get all language profiles
+   */
+  async getLanguageProfiles(): Promise<BazarrLanguageProfile[]> {
+    return this.get<BazarrLanguageProfile[]>("/system/languages/profiles")
+  }
+
+  /**
+   * Configure Default Language Profile
+   * Creates an english profile if it doesn't exist
+   */
+  async configureDefaultLanguageProfile(name = "English", language = "en"): Promise<boolean> {
+    try {
+      debugLog("Bazarr", `Configuring language profile: ${name}`)
+
+      // Get existing profiles to check and to preserve them
+      const profiles = (await this.getLanguageProfiles()) || []
+      const existing = profiles.find((p) => p.name === name)
+
+      if (existing) {
+        debugLog("Bazarr", `Language profile '${name}' already exists`)
+        return true
+      }
+
+      const newProfile: BazarrLanguageProfile = {
+        name: name,
+        cutoff: language,
+        languages: [
+          {
+            code: language,
+            forced: false,
+            hi: false,
+          },
+        ],
+      }
+
+      profiles.push(newProfile)
+
+      // Update settings with the new list (serialized as JSON)
+      // Note: Bazarr expects 'languages_profiles' as a JSON string in the form data
+      await this.postForm("/system/settings", {
+        languages_profiles: JSON.stringify(profiles),
+      })
+
+      debugLog("Bazarr", `Created language profile: ${name}`)
+      return true
+    } catch (e) {
+      debugLog("Bazarr", `Failed to configure language profile: ${e}`)
+      return false
+    }
+  }
+
   /**
    * Run the auto-setup process for Bazarr
    */

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

@@ -1,8 +1,15 @@
 /**
  * Quality Profile API Client
- * Manages Quality Profiles and Custom Format scoring for Radarr/Sonarr
+ * Manages Quality Profiles and Custom Format scoring for Radarr/Sonarr/Lidarr
  */
 
+import { debugLog } from "../utils/debug"
+import {
+  TRASH_RADARR_QUALITY_DEFINITIONS,
+  TRASH_SONARR_QUALITY_DEFINITIONS,
+  TRASH_LIDARR_QUALITY_DEFINITIONS,
+} from "../config/trash-quality-definitions"
+
 export interface QualityItem {
   id?: number
   name?: string
@@ -112,10 +119,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 +222,48 @@ export class QualityProfileClient {
 
     return this.updateQualityProfile(profileId, profile)
   }
+
+  // Apply TRaSH/Davo Quality Definitions (File Size Limits)
+  async updateTrashQualityDefinitions(appType: "radarr" | "sonarr" | "lidarr"): Promise<void> {
+    try {
+      debugLog("QualityProfile", `Updating Quality Definitions for ${appType}`)
+      const definitions = await this.getQualityDefinitions()
+
+      // Get appropriate definitions based on app type
+      let trashDefs
+      if (appType === "radarr") {
+        trashDefs = TRASH_RADARR_QUALITY_DEFINITIONS
+      } else if (appType === "sonarr") {
+        trashDefs = TRASH_SONARR_QUALITY_DEFINITIONS
+      } else {
+        trashDefs = TRASH_LIDARR_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
+    }
+  }
 }