Added schedule import and export

Necessary to allow users to back up and restore schedules as JSON
files. Provides a recovery path for users who lost data due to the
previous mount point mismatch.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: ikraamg

trmnl-ha/DOCS.md

@@ -319,6 +319,8 @@ Create cron-based schedules via the Web UI for automatic captures.
 
 **Manual Trigger:** Click **Send Now** to execute immediately.
 
+**Export / Import:** Use the **Export** and **Import** buttons in the Schedules tab to back up or restore schedules as JSON files. Import replaces all existing schedules.
+
 ### Cron Syntax
 
 ```

trmnl-ha/ha-trmnl/html/index.html

@@ -73,6 +73,31 @@
         >
           + New
         </button>
+
+        <button
+          onclick="window.app.exportSchedules()"
+          class="px-3 py-2 rounded-t-lg text-sm transition-all border"
+          style="background-color: #f5f5f5; color: #666; border-color: #e0e0e0"
+          onmouseover="this.style.backgroundColor='#e8e8e8'; this.style.borderColor='var(--primary-light)'"
+          onmouseout="this.style.backgroundColor='#f5f5f5'; this.style.borderColor='#e0e0e0'"
+          title="Export all schedules as JSON"
+        >
+          ↓ Export
+        </button>
+
+        <button
+          onclick="window.app.importSchedules()"
+          class="px-3 py-2 rounded-t-lg text-sm transition-all border"
+          style="background-color: #f5f5f5; color: #666; border-color: #e0e0e0"
+          onmouseover="this.style.backgroundColor='#e8e8e8'; this.style.borderColor='var(--primary-light)'"
+          onmouseout="this.style.backgroundColor='#f5f5f5'; this.style.borderColor='#e0e0e0'"
+          title="Import schedules from JSON file"
+        >
+          ↑ Import
+        </button>
+
+        <!-- Hidden file input for import -->
+        <input type="file" id="importFileInput" accept=".json" class="hidden" />
       </div>
 
       <!-- Tab Content -->

trmnl-ha/ha-trmnl/html/js/api-client.ts

@@ -176,6 +176,32 @@ export class SendSchedule {
   }
 }
 
+/**
+ * Imports schedules (full replace) from a JSON array
+ */
+export class ImportSchedules {
+  baseUrl: string
+
+  constructor(baseUrl = './api/schedules/import') {
+    this.baseUrl = baseUrl
+  }
+
+  async call(schedules: Schedule[]): Promise<{ success: boolean; count: number }> {
+    const response = await fetch(this.baseUrl, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(schedules),
+    })
+
+    if (!response.ok) {
+      const data = await response.json() as { error?: string }
+      throw new Error(data.error ?? `Failed to import: ${response.statusText}`)
+    }
+
+    return response.json()
+  }
+}
+
 /**
  * Fetches a screenshot preview
  */

trmnl-ha/ha-trmnl/html/js/app.ts

@@ -23,7 +23,7 @@ import { PreviewGenerator } from './preview-generator.js'
 import { CropModal } from './crop-modal.js'
 import { ConfirmModal } from './confirm-modal.js'
 import { DevicePresetsManager } from './device-presets.js'
-import { SendSchedule, LoadPalettes, ByosLogin } from './api-client.js'
+import { SendSchedule, LoadPalettes, ByosLogin, ImportSchedules } from './api-client.js'
 import type { PaletteOption } from './palette-options.js'
 import type {
   Schedule,
@@ -552,6 +552,110 @@ class App {
     return null
   }
 
+  // =============================================================================
+  // EXPORT / IMPORT
+  // =============================================================================
+
+  /** Downloads all schedules as a JSON file */
+  exportSchedules(): void {
+    const schedules = this.#scheduleManager.schedules
+
+    if (schedules.length === 0) {
+      this.#confirmModal.alert({
+        title: 'Nothing to Export',
+        message: 'There are no schedules to export.',
+        type: 'info',
+      })
+      return
+    }
+
+    const json = JSON.stringify(schedules, null, 2)
+    const blob = new Blob([json], { type: 'application/json' })
+    const date = new Date().toISOString().slice(0, 10)
+    const filename = `trmnl-schedules-${date}.json`
+
+    const a = document.createElement('a')
+    a.href = URL.createObjectURL(blob)
+    a.download = filename
+    a.click()
+    URL.revokeObjectURL(a.href)
+  }
+
+  /** Prompts user to select a JSON file and imports schedules */
+  async importSchedules(): Promise<void> {
+    const fileInput = document.getElementById('importFileInput') as HTMLInputElement | null
+    if (!fileInput) return
+
+    // Reset so the same file can be re-selected
+    fileInput.value = ''
+
+    // Wait for user to pick a file
+    const file = await new Promise<File | null>((resolve) => {
+      const handler = () => {
+        fileInput.removeEventListener('change', handler)
+        resolve(fileInput.files?.[0] ?? null)
+      }
+      fileInput.addEventListener('change', handler)
+      fileInput.click()
+    })
+
+    if (!file) return
+
+    let parsed: unknown
+    try {
+      const text = await file.text()
+      parsed = JSON.parse(text)
+    } catch {
+      await this.#confirmModal.alert({
+        title: 'Invalid File',
+        message: 'The selected file is not valid JSON.',
+        type: 'error',
+      })
+      return
+    }
+
+    if (!Array.isArray(parsed)) {
+      await this.#confirmModal.alert({
+        title: 'Invalid Format',
+        message: 'Expected a JSON array of schedules.',
+        type: 'error',
+      })
+      return
+    }
+
+    const existing = this.#scheduleManager.schedules.length
+    const incoming = parsed.length
+
+    const confirmed = await this.#confirmModal.confirm({
+      title: 'Import Schedules',
+      message: `This will replace all ${existing} existing schedule(s) with ${incoming} imported schedule(s). This cannot be undone.`,
+      confirmText: 'Import',
+      cancelText: 'Cancel',
+      confirmClass: 'text-white rounded-md transition' +
+        ' ' + 'bg-blue-600 hover:bg-blue-700',
+    })
+
+    if (!confirmed) return
+
+    try {
+      const result = await new ImportSchedules().call(parsed)
+      await this.#scheduleManager.loadAll()
+      this.renderUI()
+
+      await this.#confirmModal.alert({
+        title: 'Import Complete',
+        message: `Successfully imported ${result.count} schedule(s).`,
+        type: 'success',
+      })
+    } catch (err) {
+      await this.#confirmModal.alert({
+        title: 'Import Failed',
+        message: `Failed to import schedules: ${(err as Error).message}`,
+        type: 'error',
+      })
+    }
+  }
+
   // =============================================================================
   // UI RENDERING
   // =============================================================================

trmnl-ha/ha-trmnl/lib/http-router.ts

@@ -20,6 +20,7 @@ import {
   createSchedule as defaultCreateSchedule,
   updateSchedule as defaultUpdateSchedule,
   deleteSchedule as defaultDeleteSchedule,
+  replaceAllSchedules,
 } from './scheduleStore.js'
 import {
   login as defaultByosLogin,
@@ -160,6 +161,10 @@ export class HttpRouter {
       return this.#handleSchedulesAPI(request, response)
     }
 
+    if (pathname === '/api/schedules/import') {
+      return this.#handleScheduleImportAPI(request, response)
+    }
+
     if (pathname.startsWith('/api/schedules/')) {
       if (pathname.endsWith('/send')) {
         return this.#handleScheduleSendAPI(request, response, requestUrl)
@@ -328,6 +333,39 @@ export class HttpRouter {
     return true
   }
 
+  async #handleScheduleImportAPI(
+    request: IncomingMessage,
+    response: ServerResponse,
+  ): Promise<boolean> {
+    response.setHeader('Content-Type', 'application/json')
+
+    if (request.method !== 'POST') {
+      response.writeHead(405)
+      response.end(toJson({ error: 'Method not allowed' }))
+      return true
+    }
+
+    try {
+      const body = await this.#readRequestBody(request)
+      const parsed: unknown = JSON.parse(body)
+
+      if (!Array.isArray(parsed)) {
+        response.writeHead(400)
+        response.end(toJson({ error: 'Request body must be a JSON array' }))
+        return true
+      }
+
+      const schedules = await replaceAllSchedules(parsed as Partial<Schedule>[])
+      response.writeHead(200)
+      response.end(toJson({ success: true, count: schedules.length }))
+    } catch (err) {
+      response.writeHead(400)
+      response.end(toJson({ error: (err as Error).message }))
+    }
+
+    return true
+  }
+
   #handlePresetsAPI(response: ServerResponse): boolean {
     const presets = loadPresets()
     response.writeHead(200, { 'Content-Type': 'application/json' })

trmnl-ha/ha-trmnl/lib/scheduleStore.ts

@@ -267,6 +267,47 @@ export async function deleteSchedule(
   })
 }
 
+/**
+ * Replace all schedules with imported data.
+ * Generates fresh IDs and timestamps, runs each through migrateSchedule().
+ */
+export async function replaceAllSchedules(
+  filePath: string,
+  imported: Partial<Schedule>[]
+): Promise<Schedule[]>
+export async function replaceAllSchedules(
+  imported: Partial<Schedule>[]
+): Promise<Schedule[]>
+export async function replaceAllSchedules(
+  filePathOrImported: string | Partial<Schedule>[],
+  imported?: Partial<Schedule>[]
+): Promise<Schedule[]> {
+  const filePath =
+    typeof filePathOrImported === 'string'
+      ? filePathOrImported
+      : DEFAULT_SCHEDULES_FILE
+  const data =
+    typeof filePathOrImported === 'string' ? imported! : filePathOrImported
+
+  return withLock(filePath, async () => {
+    const now = new Date().toISOString()
+    const schedules = data.map((entry) => {
+      // Strip existing IDs/timestamps — regenerate fresh ones
+      const { id: _id, createdAt: _ca, updatedAt: _ua, ...rest } = entry
+      return migrateSchedule({
+        ...rest,
+        id: generateId(),
+        createdAt: now,
+        updatedAt: now,
+      })
+    })
+
+    await saveSchedules(filePath, schedules)
+    log.info`Imported ${schedules.length} schedules`
+    return schedules
+  })
+}
+
 /**
  * Generate a unique ID
  */