@muhammedaksam/easiarr 1.4.0 → 1.6.0

package/src/config/bookmarks-generator.ts

@@ -1,160 +0,0 @@
-/**
- * Bookmarks Generator
- * Generates Netscape-format HTML bookmarks for browser import
- */
-
-import { writeFile } from "node:fs/promises"
-
-import type { AppCategory, EasiarrConfig } from "./schema"
-import { CATEGORY_ORDER } from "~/apps/categories"
-import { getApp } from "~/apps/registry"
-import { readEnvSync } from "~/utils/env"
-import { getConfigPath } from "~/utils/paths"
-import { APP_CATEGORIES } from "./schema"
-
-interface BookmarkEntry {
-  name: string
-  url: string
-  description: string
-}
-
-type CategoryBookmarks = Map<AppCategory, BookmarkEntry[]>
-
-/**
- * Get the URL for an app based on Traefik configuration
- */
-function getAppUrl(
-  appId: string,
-  port: number,
-  config: EasiarrConfig,
-  useLocalUrls: boolean
-): string {
-  if (!useLocalUrls && config.traefik?.enabled && config.traefik.domain) {
-    return `https://${appId}.${config.traefik.domain}/`
-  }
-  // Read LOCAL_DOCKER_IP from .env file, fallback to localhost
-  const env = readEnvSync()
-  const host = env.LOCAL_DOCKER_IP || "localhost"
-  return `http://${host}:${port}/`
-}
-
-/**
- * Generate bookmark entries grouped by category
- */
-function generateBookmarksByCategory(
-  config: EasiarrConfig,
-  useLocalUrls: boolean
-): CategoryBookmarks {
-  const categoryBookmarks: CategoryBookmarks = new Map()
-
-  for (const appConfig of config.apps) {
-    if (!appConfig.enabled) continue
-
-    const appDef = getApp(appConfig.id)
-    if (!appDef) continue
-
-    const port = appConfig.port ?? appDef.defaultPort
-    const url = getAppUrl(appConfig.id, port, config, useLocalUrls)
-
-    const entry: BookmarkEntry = {
-      name: appDef.name,
-      url,
-      description: appDef.description,
-    }
-
-    const category = appDef.category
-    if (!categoryBookmarks.has(category)) {
-      categoryBookmarks.set(category, [])
-    }
-    categoryBookmarks.get(category)!.push(entry)
-  }
-
-  return categoryBookmarks
-}
-
-/**
- * Generate Netscape-format HTML bookmarks
- */
-export function generateBookmarksHtml(config: EasiarrConfig, useLocalUrls = false): string {
-  const categoryBookmarks = generateBookmarksByCategory(config, useLocalUrls)
-
-  let html = `<!DOCTYPE NETSCAPE-Bookmark-file-1>
-<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=UTF-8">
-<TITLE>Bookmarks</TITLE>
-<H1>Bookmarks</H1>
-<DL><p>
-    <DT><H3 PERSONAL_TOOLBAR_FOLDER="true">easiarr</H3>
-    <DL><p>
-`
-
-  // Add external resources first
-  html += `        <DT><A HREF="https://github.com/muhammedaksam/easiarr/">GitHub | easiarr Project Repo</A>\n`
-  html += `        <DT><A HREF="https://trash-guides.info/">TRaSH Guides</A>\n`
-
-  // Add apps grouped by category in defined order
-  for (const { id: categoryId } of CATEGORY_ORDER) {
-    const bookmarks = categoryBookmarks.get(categoryId)
-    if (!bookmarks || bookmarks.length === 0) continue
-
-    const categoryName = APP_CATEGORIES[categoryId]
-
-    // Add category header as a folder
-    html += `        <DT><H3>${categoryName}</H3>\n`
-    html += `        <DL><p>\n`
-
-    for (const bookmark of bookmarks) {
-      html += `            <DT><A HREF="${bookmark.url}">${bookmark.name} | ${bookmark.description}</A>\n`
-    }
-
-    html += `        </DL><p>\n`
-  }
-
-  // Close the structure
-  html += `    </DL><p>
-</DL><p>
-`
-
-  return html
-}
-
-/**
- * Get the path to the bookmarks file
- * @param type - 'local' for local URLs, 'remote' for Traefik URLs
- */
-export function getBookmarksPath(type: "local" | "remote" = "local"): string {
-  const filename = type === "remote" ? "bookmarks-remote.html" : "bookmarks-local.html"
-  return getConfigPath(filename)
-}
-
-/**
- * Save bookmarks HTML file
- * @param type - 'local' for local URLs, 'remote' for Traefik URLs
- */
-export async function saveBookmarks(
-  config: EasiarrConfig,
-  type: "local" | "remote" = "local"
-): Promise<string> {
-  const useLocalUrls = type === "local"
-  const html = generateBookmarksHtml(config, useLocalUrls)
-  const path = getBookmarksPath(type)
-  await writeFile(path, html, "utf-8")
-  return path
-}
-
-/**
- * Save all bookmarks files
- * Always saves local bookmarks, and remote bookmarks only if Traefik is enabled
- */
-export async function saveAllBookmarks(config: EasiarrConfig): Promise<string[]> {
-  const paths: string[] = []
-
-  // Always save local bookmarks
-  paths.push(await saveBookmarks(config, "local"))
-
-  // Save remote bookmarks only if Traefik is enabled with a domain
-  if (config.traefik?.enabled && config.traefik.domain) {
-    paths.push(await saveBookmarks(config, "remote"))
-  }
-
-  return paths
-}

package/src/config/defaults.ts

@@ -1,37 +0,0 @@
-/**
- * Default Value Detection
- * Auto-detect timezone and UID/GID from system
- */
-
-import { existsSync, readlinkSync } from "node:fs"
-
-export function detectTimezone(): string {
-  const tzPath = "/etc/localtime"
-
-  if (existsSync(tzPath)) {
-    try {
-      const link = readlinkSync(tzPath)
-      const parts = link.split("zoneinfo/")
-      if (parts.length > 1) {
-        return parts[1]
-      }
-    } catch {
-      // Fallback if not a symlink
-    }
-  }
-
-  // Try TZ environment variable
-  if (process.env.TZ) {
-    return process.env.TZ
-  }
-
-  return "UTC"
-}
-
-export function detectUid(): number {
-  return process.getuid?.() ?? 1000
-}
-
-export function detectGid(): number {
-  return process.getgid?.() ?? 1000
-}

package/src/config/homepage-config.ts

@@ -1,381 +0,0 @@
-/**
- * Homepage Configuration Generator
- * Generates services.yaml and other config files for Homepage dashboard
- */
-
-import { existsSync } from "node:fs"
-import { mkdir, writeFile } from "node:fs/promises"
-import { join } from "node:path"
-
-import type { AppCategory, EasiarrConfig } from "./schema"
-import { PortainerApiClient } from "~/api/portainer-api"
-import { CATEGORY_ORDER } from "~/apps/categories"
-import { getApp } from "~/apps/registry"
-import { getLocalIp, readEnvSync, updateEnv } from "~/utils/env"
-import { APP_CATEGORIES } from "./schema"
-
-/**
- * Get the Homepage config directory path
- */
-export function getHomepageConfigPath(config: EasiarrConfig): string {
-  return join(config.rootDir, "config", "homepage")
-}
-
-/**
- * Homepage service entry
- */
-interface HomepageService {
-  href?: string // Optional - cloudflared has no web UI
-  icon?: string
-  description?: string
-  ping?: string
-  widget?: {
-    type: string
-    url?: string // Optional - cloudflared doesn't need url
-    key?: string
-    [key: string]: unknown
-  }
-}
-
-/**
- * Generate services.yaml content from enabled apps
- */
-export async function generateServicesYaml(config: EasiarrConfig): Promise<string> {
-  const env = readEnvSync()
-  const localIp = getLocalIp()
-
-  // Group apps by category
-  const categoryGroups = new Map<AppCategory, Array<{ name: string; service: HomepageService }>>()
-
-  for (const appConfig of config.apps) {
-    if (!appConfig.enabled) continue
-
-    const appDef = getApp(appConfig.id)
-    if (!appDef) continue
-
-    // Skip homepage itself
-    if (appDef.id === "homepage") continue
-
-    // Skip apps with no web UI (port 0) and no homepage config
-    if (appDef.defaultPort === 0 && !appDef.homepage) continue
-
-    const port = appConfig.port ?? appDef.defaultPort
-    const internalPort = appDef.internalPort ?? port
-    // External URL for user browser access (href, ping)
-    const baseUrl = `http://${localIp}:${port}`
-    // Internal Docker URL for container-to-container API calls (widgets)
-    const dockerUrl = `http://${appDef.id}:${internalPort}`
-
-    const service: HomepageService = {
-      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
-    } else {
-      // Default to app ID as icon name
-      service.icon = `${appDef.id}.png`
-    }
-
-    // Add widget if defined
-    if (appDef.homepage?.widget) {
-      const apiKey = env[`API_KEY_${appDef.id.toUpperCase()}`]
-
-      // Some widgets require specific config - skip if not available
-      const widgetType = appDef.homepage.widget
-
-      // Cloudflared requires accountid and tunnelid
-      if (appDef.id === "cloudflared") {
-        const accountId = env["CLOUDFLARE_ACCOUNT_ID"]
-        const tunnelId = env["CLOUDFLARE_TUNNEL_ID"]
-        const apiToken = env["CLOUDFLARE_API_TOKEN"]
-
-        if (accountId && tunnelId && apiToken) {
-          service.widget = {
-            type: widgetType,
-            accountid: accountId,
-            tunnelid: tunnelId,
-            key: apiToken,
-          }
-        }
-        // Skip widget entirely if missing required params
-      }
-      // Headscale requires API key
-      else if (appDef.id === "headscale") {
-        const headscaleKey = env["API_KEY_HEADSCALE"]
-        if (headscaleKey) {
-          service.widget = {
-            type: widgetType,
-            url: dockerUrl,
-            key: headscaleKey,
-          }
-        }
-        // Skip widget if no API key
-      }
-      // Most widgets need API key - only add if available
-      else if (
-        apiKey ||
-        ["qbittorrent", "gluetun", "traefik", "huntarr", "easiarr", "flaresolverr"].includes(
-          appDef.id
-        )
-      ) {
-        service.widget = {
-          type: widgetType,
-          url: dockerUrl,
-        }
-
-        if (apiKey) {
-          service.widget.key = apiKey
-        }
-
-        // Add widget-specific credentials from env
-        if (appDef.id === "qbittorrent") {
-          const username = env["USERNAME_QBITTORRENT"]
-          const password = env["PASSWORD_QBITTORRENT"]
-          if (username) service.widget.username = username
-          if (password) service.widget.password = password
-        }
-
-        // Traefik widget needs the dashboard/API port (8080 internal)
-        if (appDef.id === "traefik") {
-          service.widget.url = `http://traefik:8080`
-        }
-
-        if (appDef.id === "portainer") {
-          // Try to auto-detect Portainer environment ID
-          // User can override with PORTAINER_ENV in .env file
-          if (env["PORTAINER_ENV"]) {
-            service.widget.env = env["PORTAINER_ENV"]
-          } else {
-            // Auto-detect from Portainer API
-            const portainerPort = appConfig.port ?? appDef.defaultPort
-            const portainerClient = new PortainerApiClient(localIp, portainerPort)
-            const portainerApiKey = env["API_KEY_PORTAINER"]
-            if (portainerApiKey) {
-              portainerClient.setApiKey(portainerApiKey)
-            }
-            const localEnvId = await portainerClient.getLocalEnvironmentId()
-            const envIdStr = localEnvId?.toString() ?? "1"
-            service.widget.env = envIdStr
-
-            // Persist the detected env ID to .env for future use
-            if (localEnvId) {
-              await updateEnv({ PORTAINER_ENV: envIdStr })
-            }
-          }
-        }
-
-        // Add any custom widget fields
-        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
-    }
-
-    // Add to category group
-    const category = appDef.category
-    if (!categoryGroups.has(category)) {
-      categoryGroups.set(category, [])
-    }
-    categoryGroups.get(category)!.push({ name: appDef.name, service })
-  }
-
-  // Build YAML output
-  let yaml = "---\n# Auto-generated by easiarr\n# https://github.com/muhammedaksam/easiarr\n\n"
-
-  // Add easiarr info section with two widgets - one for installed, one for latest
-  yaml += `- easiarr:\n`
-  // Installed version from local easiarr container
-  yaml += `    - Installed:\n`
-  yaml += `        href: https://github.com/muhammedaksam/easiarr\n`
-  yaml += `        icon: mdi-docker\n`
-  yaml += `        description: Your current version\n`
-  yaml += `        widget:\n`
-  yaml += `          type: customapi\n`
-  yaml += `          url: http://easiarr:8080/config.json\n`
-  yaml += `          refreshInterval: 3600000\n` // 1 hour
-  yaml += `          mappings:\n`
-  yaml += `            - field: version\n`
-  yaml += `              label: Version\n`
-  // Latest version from GitHub API
-  yaml += `    - Latest:\n`
-  yaml += `        href: https://github.com/muhammedaksam/easiarr/releases\n`
-  yaml += `        icon: mdi-github\n`
-  yaml += `        description: Check for updates\n`
-  yaml += `        widget:\n`
-  yaml += `          type: customapi\n`
-  yaml += `          url: https://api.github.com/repos/muhammedaksam/easiarr/releases/latest\n`
-  yaml += `          headers:\n`
-  yaml += `            User-Agent: easiarr-homepage-widget\n`
-  yaml += `          refreshInterval: 86400000\n` // 24 hours
-  yaml += `          mappings:\n`
-  yaml += `            - field: tag_name\n`
-  yaml += `              label: Version\n`
-  yaml += `            - field: published_at\n`
-  yaml += `              label: Released\n`
-  yaml += `              format: relativeDate\n`
-  yaml += `\n`
-
-  // Use CATEGORY_ORDER for consistent ordering
-  for (const { id: category } of CATEGORY_ORDER) {
-    const services = categoryGroups.get(category)
-    if (!services || services.length === 0) continue
-
-    const categoryName = APP_CATEGORIES[category]
-    yaml += `- ${categoryName}:\n`
-
-    for (const { name, service } of services) {
-      yaml += `    - ${name}:\n`
-
-      if (service.href) {
-        yaml += `        href: ${service.href}\n`
-      }
-
-      if (service.icon) {
-        yaml += `        icon: ${service.icon}\n`
-      }
-
-      if (service.description) {
-        yaml += `        description: ${service.description}\n`
-      }
-
-      if (service.ping) {
-        yaml += `        ping: ${service.ping}\n`
-      }
-
-      if (service.widget) {
-        yaml += `        widget:\n`
-        yaml += `          type: ${service.widget.type}\n`
-        if (service.widget.url) {
-          yaml += `          url: ${service.widget.url}\n`
-        }
-
-        if (service.widget.key) {
-          yaml += `          key: ${service.widget.key}\n`
-        }
-
-        // Add any other widget fields
-        for (const [key, value] of Object.entries(service.widget)) {
-          if (key !== "type" && key !== "url" && key !== "key") {
-            // Handle mappings array specially
-            if (key === "mappings") {
-              const mappings = typeof value === "string" ? JSON.parse(value) : value
-              if (Array.isArray(mappings)) {
-                yaml += `          mappings:\n`
-                for (const mapping of mappings) {
-                  yaml += `            - field: ${mapping.field}\n`
-                  yaml += `              label: ${mapping.label}\n`
-                  if (mapping.format) {
-                    yaml += `              format: ${mapping.format}\n`
-                  }
-                }
-              }
-            } else {
-              yaml += `          ${key}: ${value}\n`
-            }
-          }
-        }
-      }
-    }
-
-    yaml += "\n"
-  }
-
-  return yaml
-}
-
-/**
- * Generate settings.yaml with sensible defaults
- */
-export function generateSettingsYaml(): string {
-  return `---
-# Auto-generated by easiarr
-# For configuration options: https://gethomepage.dev/configs/settings/
-
-title: easiarr Dashboard
-
-# Background: "Close-up Photography of Leaves With Droplets"
-# Photo by Sohail Nachiti: https://www.pexels.com/photo/close-up-photography-of-leaves-with-droplets-807598/
-background:
-  image: https://images.pexels.com/photos/807598/pexels-photo-807598.jpeg?cs=srgb&fm=jpg&w=4128&h=3096
-  blur: sm
-  saturate: 50
-  brightness: 50
-  opacity: 50
-
-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
-    columns: 4
-  Media Servers:
-    style: row
-    columns: 2
-  Download Clients:
-    style: row
-    columns: 2
-`
-}
-
-/**
- * Save Homepage configuration files
- */
-export async function saveHomepageConfig(
-  config: EasiarrConfig
-): Promise<{ services: string; settings: string }> {
-  const configPath = getHomepageConfigPath(config)
-
-  // Ensure directory exists
-  if (!existsSync(configPath)) {
-    await mkdir(configPath, { recursive: true })
-  }
-
-  const servicesPath = join(configPath, "services.yaml")
-  const settingsPath = join(configPath, "settings.yaml")
-
-  // Generate and save services.yaml
-  const servicesYaml = await generateServicesYaml(config)
-  await writeFile(servicesPath, servicesYaml, "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 }
-}

package/src/config/index.ts

@@ -1,6 +0,0 @@
-export * from "./schema"
-export * from "./defaults"
-export * from "./manager"
-export * from "./homepage-config"
-export * from "./recyclarr-config"
-export * from "./bookmarks-generator"