@muhammedaksam/easiarr 1.1.8 → 1.2.0

package/src/compose/caddy-config.ts

@@ -0,0 +1,129 @@
+/**
+ * Caddy Configuration Generator
+ * Generates Caddyfile for automatic HTTPS reverse proxy
+ */
+
+import { mkdir, writeFile } from "node:fs/promises"
+import { existsSync } from "node:fs"
+import { join } from "node:path"
+import type { EasiarrConfig } from "../config/schema"
+import { getApp } from "../apps/registry"
+import { debugLog } from "../utils/debug"
+
+/**
+ * Generate Caddyfile content for enabled apps
+ */
+export function generateCaddyfile(config: EasiarrConfig): string {
+  const domain = config.caddy?.domain || "localhost"
+  const email = config.caddy?.email
+
+  let caddyfile = `# Caddyfile
+# Generated by easiarr - https://github.com/muhammedaksam/easiarr
+#
+# Caddy provides automatic HTTPS via Let's Encrypt.
+# For local dev, use 'localhost' or ':80' as domain.
+#
+# To manually reload: docker exec caddy caddy reload --config /etc/caddy/Caddyfile
+
+`
+
+  // Global options block (if email is set for ACME)
+  if (email) {
+    caddyfile += `{
+  email ${email}
+}
+
+`
+  }
+
+  // Get enabled apps that should be proxied
+  const proxyApps = config.apps.filter((app) => {
+    if (!app.enabled) return false
+    // Skip caddy itself and apps without ports
+    if (app.id === "caddy" || app.id === "cloudflared") return false
+    const def = getApp(app.id)
+    if (!def || def.defaultPort === 0) return false
+    return true
+  })
+
+  // Generate reverse proxy blocks for each app
+  for (const app of proxyApps) {
+    const def = getApp(app.id)
+    if (!def) continue
+
+    const port = app.port ?? def.defaultPort
+    const subdomain = app.id
+    const internalPort = def.internalPort ?? port
+
+    // Format: subdomain.domain.com
+    const host = domain === "localhost" ? `${subdomain}.localhost` : `${subdomain}.${domain}`
+
+    caddyfile += `# ${def.name}
+${host} {
+  reverse_proxy ${app.id}:${internalPort}
+}
+
+`
+  }
+
+  return caddyfile
+}
+
+/**
+ * Save Caddyfile to the config directory
+ */
+export async function saveCaddyConfig(config: EasiarrConfig): Promise<string> {
+  // Check if Caddy is enabled
+  const caddyApp = config.apps.find((a) => a.id === "caddy" && a.enabled)
+  if (!caddyApp) {
+    debugLog("Caddy", "Caddy not enabled, skipping config generation")
+    return ""
+  }
+
+  const caddyDir = join(config.rootDir, "config", "caddy")
+  const dataDir = join(caddyDir, "data")
+  const configDir = join(caddyDir, "config")
+
+  debugLog("Caddy", `Generating Caddyfile in ${caddyDir}`)
+
+  try {
+    // Create directories if they don't exist
+    if (!existsSync(caddyDir)) {
+      await mkdir(caddyDir, { recursive: true })
+    }
+    if (!existsSync(dataDir)) {
+      await mkdir(dataDir, { recursive: true })
+    }
+    if (!existsSync(configDir)) {
+      await mkdir(configDir, { recursive: true })
+    }
+
+    // Generate Caddyfile
+    const caddyfileContent = generateCaddyfile(config)
+    const caddyfilePath = join(caddyDir, "Caddyfile")
+
+    // Always overwrite Caddyfile to reflect current app config
+    await writeFile(caddyfilePath, caddyfileContent, "utf-8")
+    debugLog("Caddy", `Saved Caddyfile to ${caddyfilePath}`)
+
+    return caddyfilePath
+  } catch (error) {
+    const err = error as NodeJS.ErrnoException
+    if (err.code === "EACCES") {
+      console.warn(
+        `[WARN] Cannot write Caddy config files (permission denied). ` +
+          `Fix with: sudo chown -R $(id -u):$(id -g) ${caddyDir}`
+      )
+    } else {
+      throw error
+    }
+    return ""
+  }
+}
+
+/**
+ * Get the path to the Caddyfile
+ */
+export function getCaddyfilePath(config: EasiarrConfig): string {
+  return join(config.rootDir, "config", "caddy", "Caddyfile")
+}

package/src/compose/generator.ts

@@ -10,6 +10,7 @@ import { getApp } from "../apps/registry"
 import { generateServiceYaml } from "./templates"
 import { updateEnv, getLocalIp } from "../utils/env"
 import { saveTraefikConfig } from "./traefik-config"
+import { saveCaddyConfig } from "./caddy-config"
 import { debugLog } from "../utils/debug"
 
 export interface ComposeService {
@@ -111,6 +112,11 @@ function buildService(appDef: ReturnType<typeof getApp>, appConfig: AppConfig, c
   // Use ${ROOT_DIR} for volumes
   const volumes = [...appDef.volumes("${ROOT_DIR}"), ...(appConfig.customVolumes ?? [])]
 
+  // Add log volume mount if logMount is enabled and app has logVolume defined
+  if (config.logMount && appDef.logVolume) {
+    volumes.push(`\${ROOT_DIR}/logs/${appDef.id}:${appDef.logVolume}`)
+  }
+
   // Build environment
   const environment: Record<string, string | number> = {
     TZ: "${TIMEZONE}",
@@ -181,7 +187,7 @@ function buildService(appDef: ReturnType<typeof getApp>, appConfig: AppConfig, c
     }
   }
 
-  if (config.traefik?.enabled && appDef.id !== "plex" && appDef.id !== "cloudflared") {
+  if (config.traefik?.enabled && appDef.id !== "plex" && appDef.id !== "cloudflared" && appDef.defaultPort !== 0) {
     if (appDef.id === "traefik") {
       // Special labels for Traefik dashboard (accessible via traefik.domain on port 8080)
       service.labels = generateTraefikLabels("traefik", 8080, config.traefik)
@@ -237,6 +243,9 @@ export async function saveCompose(config: EasiarrConfig): Promise<string> {
   // Generate Traefik config files if Traefik is enabled
   await saveTraefikConfig(config)
 
+  // Generate Caddy config files if Caddy is enabled
+  await saveCaddyConfig(config)
+
   return path
 }
 

package/src/config/recyclarr-config.ts

@@ -0,0 +1,179 @@
+/**
+ * Recyclarr Configuration Generator
+ * Generates recyclarr.yml for automatic TRaSH Guides profile sync
+ */
+
+import { mkdir, writeFile } from "node:fs/promises"
+import { join } from "node:path"
+import YAML from "yaml"
+import type { EasiarrConfig, AppId } from "./schema"
+import { readEnv } from "../utils/env"
+import { debugLog } from "../utils/debug"
+
+/**
+ * Get API key for an app from the .env file
+ */
+async function getAppApiKey(appId: AppId): Promise<string | null> {
+  const env = await readEnv()
+  const envKey = `API_KEY_${appId.toUpperCase()}`
+  return env[envKey] ?? null
+}
+
+// TRaSH Guide Custom Format IDs for common unwanted content
+const UNWANTED_CFS = {
+  radarr: [
+    "ed38b889b31be83fda192888e2286d83", // BR-DISK
+    "90a6f9a284dff5103f6346090e6280c8", // LQ
+    "e204b80c87be9497a8a6eaff48f72905", // LQ (Release Title)
+    "dc98083864ea246d05a42df0d05f81cc", // x265 (HD)
+    "0a3f082873eb454bde444150b70253cc", // Extras
+  ],
+  sonarr: [
+    "85c61753df5da1fb2aab6f2a47426b09", // BR-DISK
+    "9c11cd3f07101cdba90a2d81cf0e56b4", // LQ
+    "e2315f990da2e2cbfc9fa5b7a6fcfe48", // LQ (Release Title)
+    "47435ece6b99a0b477caf360e79ba0bb", // x265 (HD)
+    "fbcb31d8dabd2a319072b84fc0b7249c", // Extras
+  ],
+}
+
+// TRaSH Guide Quality Definition types
+const QUALITY_DEFINITIONS = {
+  radarr: "movie",
+  sonarr: "series",
+}
+
+// Default quality profiles to assign scores to
+const DEFAULT_PROFILES = {
+  radarr: ["HD", "HD-1080p", "Ultra-HD", "Any"],
+  sonarr: ["WEB-1080p", "WEB-DL (1080p)", "HD-1080p", "Any"],
+}
+
+interface RecyclarrInstance {
+  base_url: string
+  api_key: string
+  quality_definition?: {
+    type: string
+    preferred_ratio?: number
+  }
+  custom_formats?: Array<{
+    trash_ids: string[]
+    quality_profiles: Array<{
+      name: string
+    }>
+  }>
+}
+
+interface RecyclarrConfig {
+  radarr?: Record<string, RecyclarrInstance>
+  sonarr?: Record<string, RecyclarrInstance>
+}
+
+/**
+ * Generate recyclarr.yml configuration for enabled *arr apps
+ */
+export async function generateRecyclarrConfig(config: EasiarrConfig): Promise<string> {
+  debugLog("Recyclarr", "Generating recyclarr.yml configuration")
+
+  const recyclarrConfig: RecyclarrConfig = {}
+
+  // Check for enabled Radarr
+  const radarrApp = config.apps.find((a) => a.id === "radarr" && a.enabled)
+  if (radarrApp) {
+    const apiKey = await getAppApiKey("radarr")
+    if (apiKey) {
+      const port = radarrApp.port ?? 7878
+      recyclarrConfig.radarr = {
+        radarr_main: {
+          base_url: `http://radarr:${port}`,
+          api_key: apiKey,
+          quality_definition: {
+            type: QUALITY_DEFINITIONS.radarr,
+            preferred_ratio: 0.5,
+          },
+          custom_formats: [
+            {
+              trash_ids: UNWANTED_CFS.radarr,
+              quality_profiles: DEFAULT_PROFILES.radarr.map((name) => ({ name })),
+            },
+          ],
+        },
+      }
+      debugLog("Recyclarr", "Added Radarr configuration")
+    } else {
+      debugLog("Recyclarr", "Radarr enabled but no API key found - skipping")
+    }
+  }
+
+  // Check for enabled Sonarr
+  const sonarrApp = config.apps.find((a) => a.id === "sonarr" && a.enabled)
+  if (sonarrApp) {
+    const apiKey = await getAppApiKey("sonarr")
+    if (apiKey) {
+      const port = sonarrApp.port ?? 8989
+      recyclarrConfig.sonarr = {
+        sonarr_main: {
+          base_url: `http://sonarr:${port}`,
+          api_key: apiKey,
+          quality_definition: {
+            type: QUALITY_DEFINITIONS.sonarr,
+          },
+          custom_formats: [
+            {
+              trash_ids: UNWANTED_CFS.sonarr,
+              quality_profiles: DEFAULT_PROFILES.sonarr.map((name) => ({ name })),
+            },
+          ],
+        },
+      }
+      debugLog("Recyclarr", "Added Sonarr configuration")
+    } else {
+      debugLog("Recyclarr", "Sonarr enabled but no API key found - skipping")
+    }
+  }
+
+  // Generate YAML
+  const yamlContent = YAML.stringify(recyclarrConfig, {
+    indent: 2,
+    lineWidth: 0,
+  })
+
+  // Add header comment
+  const header = `# Recyclarr Configuration
+# Generated by easiarr - https://github.com/muhammedaksam/easiarr
+# 
+# This configuration syncs TRaSH Guides profiles to your *arr apps.
+# Recyclarr runs daily via cron to keep profiles up to date.
+#
+# For more options, see: https://recyclarr.dev/reference/configuration/
+#
+# To manually trigger sync: docker compose run --rm recyclarr sync
+#
+
+`
+
+  return header + yamlContent
+}
+
+/**
+ * Save recyclarr.yml to the config directory
+ */
+export async function saveRecyclarrConfig(config: EasiarrConfig): Promise<string> {
+  const recyclarrDir = join(config.rootDir, "config", "recyclarr")
+  await mkdir(recyclarrDir, { recursive: true })
+
+  const configContent = await generateRecyclarrConfig(config)
+  const configPath = join(recyclarrDir, "recyclarr.yml")
+
+  await writeFile(configPath, configContent, "utf-8")
+  debugLog("Recyclarr", `Saved recyclarr.yml to ${configPath}`)
+
+  return configPath
+}
+
+/**
+ * Get the path to the recyclarr config file
+ */
+export function getRecyclarrConfigPath(config: EasiarrConfig): string {
+  return join(config.rootDir, "config", "recyclarr", "recyclarr.yml")
+}

package/src/config/schema.ts

@@ -14,13 +14,27 @@ export interface EasiarrConfig {
   umask: string
   apps: AppConfig[]
   network?: NetworkConfig
+  /** Which reverse proxy to use: traefik, caddy, or none */
+  reverseProxy?: "traefik" | "caddy" | "none"
   traefik?: TraefikConfig
+  caddy?: CaddyConfig
   vpn?: VpnConfig
   monitor?: MonitorConfig
+  /** Bind-mount container logs to host for external log aggregation */
+  logMount?: boolean
   createdAt: string
   updatedAt: string
 }
 
+export type ReverseProxyType = "traefik" | "caddy" | "none"
+
+export interface CaddyConfig {
+  enabled: boolean
+  domain: string
+  /** Email for ACME/Let's Encrypt */
+  email?: string
+}
+
 export type VpnMode = "full" | "mini" | "none"
 
 export interface VpnConfig {
@@ -129,6 +143,8 @@ export type AppId =
   | "guacd"
   | "ddns-updater"
   | "easiarr"
+  | "recyclarr"
+  | "profilarr"
   // VPN
   | "gluetun"
   // Monitoring & Infra
@@ -141,6 +157,7 @@ export type AppId =
   // Reverse Proxy
   | "traefik"
   | "traefik-certs-dumper"
+  | "caddy"
   | "cloudflared"
   | "crowdsec"
   // Network/VPN
@@ -212,6 +229,8 @@ export interface AppDefinition {
   autoSetup?: AutoSetupCapability
   /** Use Docker's user: directive instead of PUID/PGID env vars (e.g., slskd) */
   useDockerUser?: boolean
+  /** Path inside container where logs are stored (e.g., "/config/logs"), for bind-mounting */
+  logVolume?: string
 }
 
 /** Auto-setup capability for an app */

package/src/docker/client.ts

@@ -45,6 +45,22 @@ export async function composeDown(): Promise<{
   }
 }
 
+/**
+ * Run a one-off container with docker compose run --rm
+ */
+export async function composeRun(service: string, command: string): Promise<{ success: boolean; output: string }> {
+  try {
+    const composePath = getComposePath()
+    debugLog("Docker", `compose run --rm ${service} ${command}`)
+    const result = await $`docker compose -f ${composePath} run --rm ${service} ${command}`.text()
+    debugLog("Docker", `compose run success`)
+    return { success: true, output: result }
+  } catch (error) {
+    debugLog("Docker", `compose run failed: ${error}`)
+    return { success: false, output: String(error) }
+  }
+}
+
 export async function composeRestart(service?: string): Promise<{ success: boolean; output: string }> {
   try {
     const composePath = getComposePath()

package/src/structure/manager.ts

@@ -1,6 +1,7 @@
 import { mkdir } from "node:fs/promises"
 import { join } from "node:path"
 import type { EasiarrConfig, AppId } from "../config/schema"
+import { getApp } from "../apps/registry"
 
 const BASE_DIRS = ["torrents", "usenet", "media"]
 
@@ -17,9 +18,11 @@ const CONTENT_TYPE_MAP: Partial<Record<AppId, string>> = {
 export async function ensureDirectoryStructure(config: EasiarrConfig): Promise<void> {
   try {
     const dataRoot = join(config.rootDir, "data")
+    const configRoot = join(config.rootDir, "config")
 
-    // Create base data directory
+    // Create base directories
     await mkdir(dataRoot, { recursive: true })
+    await mkdir(configRoot, { recursive: true })
 
     // 1. Create Base Directories (torrents, usenet, media)
     for (const dir of BASE_DIRS) {
@@ -74,6 +77,43 @@ export async function ensureDirectoryStructure(config: EasiarrConfig): Promise<v
       await mkdir(join(dataRoot, "media", "audiobooks"), { recursive: true })
       await mkdir(join(dataRoot, "media", "podcasts"), { recursive: true })
     }
+
+    // 4. Create config directories for enabled apps
+    // Dynamically check each app's volume definitions to see if it needs a config dir
+    for (const appConfig of config.apps) {
+      if (appConfig.enabled) {
+        const appDef = getApp(appConfig.id)
+        if (appDef) {
+          // Check if app has volume that maps to config dir
+          const volumes = appDef.volumes("$ROOT")
+          const hasConfigVolume = volumes.some((v) => v.includes("/config/"))
+          if (hasConfigVolume) {
+            await mkdir(join(configRoot, appConfig.id), { recursive: true })
+          }
+        }
+      }
+    }
+
+    // Special: Traefik needs letsencrypt subdirectory
+    if (enabledApps.has("traefik")) {
+      await mkdir(join(configRoot, "traefik", "letsencrypt"), { recursive: true })
+    }
+
+    // 5. Create log directories if logMount is enabled
+    if (config.logMount) {
+      const logsRoot = join(config.rootDir, "logs")
+      await mkdir(logsRoot, { recursive: true })
+
+      // Create log directory for each enabled app that has logVolume defined
+      for (const appConfig of config.apps) {
+        if (appConfig.enabled) {
+          const appDef = getApp(appConfig.id)
+          if (appDef?.logVolume) {
+            await mkdir(join(logsRoot, appConfig.id), { recursive: true })
+          }
+        }
+      }
+    }
   } catch (error: unknown) {
     const err = error as { code?: string; message: string }
     if (err.code === "EACCES") {

package/src/ui/screens/FullAutoSetup.ts

@@ -23,10 +23,12 @@ import { TautulliClient } from "../../api/tautulli-api"
 import { HomarrClient } from "../../api/homarr-api"
 import { HeimdallClient } from "../../api/heimdall-api"
 import { HuntarrClient } from "../../api/huntarr-api"
+import { ProfilarrApiClient } from "../../api/profilarr-api"
 import { saveConfig } from "../../config"
 import { saveCompose } from "../../compose"
 import { generateSlskdConfig, getSlskdConfigPath } from "../../config/slskd-config"
 import { generateSoularrConfig, getSoularrConfigPath } from "../../config/soularr-config"
+import { saveRecyclarrConfig } from "../../config/recyclarr-config"
 import { writeFile, mkdir } from "fs/promises"
 import { dirname } from "path"
 import { existsSync } from "fs"
@@ -118,6 +120,8 @@ export class FullAutoSetup extends BoxRenderable {
       { name: "Huntarr", status: "pending" },
       { name: "Slskd", status: "pending" },
       { name: "Soularr", status: "pending" },
+      { name: "Recyclarr", status: "pending" },
+      { name: "Profilarr", status: "pending" },
       { name: "Cloudflare Tunnel", status: "pending" },
     ]
   }
@@ -215,7 +219,13 @@ export class FullAutoSetup extends BoxRenderable {
     // Step 20: Soularr (Lidarr -> Slskd bridge)
     await this.setupSoularr()
 
-    // Step 21: Cloudflare Tunnel
+    // Step 21: Recyclarr (TRaSH Guides sync)
+    await this.setupRecyclarr()
+
+    // Step 22: Profilarr (Alternative TRaSH Guides sync)
+    await this.setupProfilarr()
+
+    // Step 22: Cloudflare Tunnel
     await this.setupCloudflare()
 
     this.isRunning = false
@@ -1384,6 +1394,118 @@ export class FullAutoSetup extends BoxRenderable {
     this.refreshContent()
   }
 
+  private async setupRecyclarr(): Promise<void> {
+    this.updateStep("Recyclarr", "running")
+    this.refreshContent()
+
+    const recyclarrConfig = this.config.apps.find((a) => a.id === "recyclarr" && a.enabled)
+    if (!recyclarrConfig) {
+      this.updateStep("Recyclarr", "skipped", "Not enabled")
+      this.refreshContent()
+      return
+    }
+
+    // Check if we have at least one *arr app with API key
+    const radarrApiKey = this.env["API_KEY_RADARR"]
+    const sonarrApiKey = this.env["API_KEY_SONARR"]
+
+    if (!radarrApiKey && !sonarrApiKey) {
+      this.updateStep("Recyclarr", "skipped", "No Radarr/Sonarr API keys")
+      this.refreshContent()
+      return
+    }
+
+    try {
+      const configPath = await saveRecyclarrConfig(this.config)
+      debugLog("FullAutoSetup", `Generated recyclarr.yml at ${configPath}`)
+      this.updateStep("Recyclarr", "success", "Config generated")
+    } catch (e) {
+      this.updateStep("Recyclarr", "error", `${e}`)
+    }
+    this.refreshContent()
+  }
+
+  private async setupProfilarr(): Promise<void> {
+    this.updateStep("Profilarr", "running")
+    this.refreshContent()
+
+    const profilarrConfig = this.config.apps.find((a) => a.id === "profilarr" && a.enabled)
+    if (!profilarrConfig) {
+      this.updateStep("Profilarr", "skipped", "Not enabled")
+      this.refreshContent()
+      return
+    }
+
+    try {
+      const port = profilarrConfig.port || 6868
+      const url = getApplicationUrl("profilarr", port, this.config)
+
+      this.updateStep("Profilarr", "running", "Waiting for Profilarr...")
+      this.refreshContent()
+
+      const client = new ProfilarrApiClient("localhost", port)
+
+      // Wait for health
+      let healthy = false
+      for (let i = 0; i < 12; i++) {
+        if (await client.isHealthy()) {
+          healthy = true
+          break
+        }
+        await new Promise((resolve) => setTimeout(resolve, 5000))
+      }
+
+      if (!healthy) {
+        throw new Error("Timed out waiting for Profilarr API")
+      }
+
+      this.updateStep("Profilarr", "running", "Configuring...")
+
+      const result = await client.setup({
+        username: this.globalUsername,
+        password: this.globalPassword,
+        env: this.env,
+      })
+
+      if (!result.success) {
+        throw new Error(result.message)
+      }
+
+      // Save API key
+      if (result.envUpdates) {
+        await updateEnv(result.envUpdates)
+        Object.assign(this.env, result.envUpdates)
+      }
+
+      // Configure Radarr/Sonarr connections after auth setup
+      const radarrConfig = this.config.apps.find((a) => a.id === "radarr" && a.enabled)
+      if (radarrConfig && this.env["API_KEY_RADARR"]) {
+        try {
+          await client.configureRadarr("radarr", radarrConfig.port || 7878, this.env["API_KEY_RADARR"])
+          debugLog("FullAutoSetup", "Profilarr: Radarr configured")
+        } catch {
+          /* Radarr config failed */
+        }
+      }
+
+      const sonarrConfig = this.config.apps.find((a) => a.id === "sonarr" && a.enabled)
+      if (sonarrConfig && this.env["API_KEY_SONARR"]) {
+        try {
+          await client.configureSonarr("sonarr", sonarrConfig.port || 8989, this.env["API_KEY_SONARR"])
+          debugLog("FullAutoSetup", "Profilarr: Sonarr configured")
+        } catch {
+          /* Sonarr config failed */
+        }
+      }
+
+      this.updateStep("Profilarr", "success", `Configured - ${url}`)
+    } catch (e) {
+      debugLog("FullAutoSetup", `Profilarr setup error: ${e}`)
+      this.updateStep("Profilarr", "error", `${e}`)
+    }
+    this.refreshContent()
+  }
+
   private updateStep(name: string, status: SetupStep["status"], message?: string): void {
     const step = this.steps.find((s) => s.name === name)
     if (step) {