Skip to main content

Backup และ Restore Settings

แอปเก็บ settings ทั้งหมดใน SQLite local ที่ %APPDATA%\Mor9an\ — ก่อน reinstall, ย้ายเครื่อง, หรือเปลี่ยน OS แนะนำ export backup เป็นไฟล์ JSON เก็บไว้

ฟังก์ชันนี้ครอบคลุม:

  • ตั้งค่า provider TTS, voice, fallback
  • Connections (token / OAuth / API keys — เลือกใส่หรือไม่ก็ได้)
  • Overlay preset, styling, leader icons
  • Alert mappings + tiers
  • Plugin configs (Timer / Cards / Wheel)
  • Filters, Theme, Chat retention

สิ่งที่ต้องเตรียม​

  • ตัดสินใจว่าจะ รวม API keys ใน backup หรือไม่ (ถ้าจะแชร์ — เลือกไม่รวม)
  • พื้นที่ disk สำหรับเก็บไฟล์ JSON (ขนาดประมาณ 10–100KB)

ขั้นที่ 1 — เปิดแท็บ Backup​

  1. ไปที่ Settings (sidebar)
  2. เลือกแท็บ Backup

ในแท็บนี้มี 3 ส่วน: Export, Restore, Chat Retention

ขั้นที่ 2 — Export Backup​

  1. เลือก toggle Include API Keys?
    • เปิด — รวม Streamlabs token, OAuth tokens, API keys ใน JSON (สำหรับ backup ส่วนตัว)
    • ปิด — ไม่รวม secrets (สำหรับแชร์ template ให้คนอื่น)
  2. กด Export Backup
  3. แอปจะดาวน์โหลดไฟล์ JSON (เช่น mor9an-backup-2026-04-29.json)

:::warning อย่าแชร์ backup ที่รวม API keys ถ้า toggle "Include API Keys" เปิด → ไฟล์จะมี secrets ที่ใช้ login บัญชีจริงได้ — เก็บส่วนตัวเท่านั้น ห้ามอัปขึ้น cloud public หรือ git repo :::

ขั้นที่ 3 — Restore จากไฟล์ Backup​

  1. ในส่วน Restore กดปุ่ม เลือกไฟล์ Backup
  2. เลือกไฟล์ JSON ที่ export ไว้
  3. แอปจะแสดง confirmation — กด ยืนยัน เพื่อทับ settings ปัจจุบัน
  4. หลัง restore — แอป reload หน้าอัตโนมัติ เพื่อโหลด settings ใหม่

:::caution Restore จะทับ settings ปัจจุบัน Restore ไม่ใช่ "merge" — มันทับค่าเดิมทั้งหมดที่อยู่ใน backup ถ้าลังเล export backup ปัจจุบันก่อน restore เผื่อ rollback :::

ขั้นที่ 4 — รู้ว่าอะไร ไม่ รวมใน Backup​

Backup รวมเฉพาะ settings เท่านั้น — รายการต่อไปนี้ ไม่ อยู่ในไฟล์ JSON:

  • ❌ Donation history (อยู่ใน SQLite — ใช้ Export CSV ใน History page แทน)
  • ❌ Alert sound files (.mp3/.wav — ต้องอัปโหลดใหม่)
  • ❌ Overlay images / GIFs — ต้องอัปโหลดใหม่
  • ❌ Card deck images / Card cover — ต้องอัปโหลดใหม่
  • ❌ Spin sound ของ Wheel — ต้องอัปโหลดใหม่
  • ❌ Chat history (deletable per Chat Retention)
  • ❌ TTS audio cache (regenerate อัตโนมัติ)

ถ้าจะย้ายเครื่องแบบ "ทุกอย่าง" — copy โฟลเดอร์ %APPDATA%\Mor9an\ ทั้งหมดไปวางที่เครื่องใหม่

ขั้นที่ 5 — ตั้ง Chat Retention​

ในแท็บเดียวกันมีส่วน Chat Retention:

  • Toggle Auto-cleanup — เปิดให้ระบบลบ chat เก่าอัตโนมัติทุก 6 ชม.
  • Slider Retention Days — เก็บ chat กี่วัน (range 1–365, default 30)

:::tip Counter ยังเก็บถาวร ระบบลบเฉพาะ "เนื้อหาข้อความ" — counter (จำนวนข้อความต่อ viewer) ยังเก็บไว้ตลอด ใช้ดู top chatter ได้ :::

Tips & Troubleshooting​

  • Restore แล้ว overlay ใน OBS ไม่เปลี่ยน: Browser source อาจ cache — Right-click ใน OBS → Refresh
  • Restore แล้ว TTS ไม่ออก: ถ้า backup ไม่รวม API keys → ตั้งใหม่ใน Connections
  • Backup file ใหญ่ผิดปกติ: ตรวจว่า toggle "Include API Keys" ไม่ทำให้ขนาดเพิ่ม — ปกติ < 200KB
  • อยาก backup รูป overlay / sound ด้วย: copy โฟลเดอร์ %APPDATA%\Mor9an\uploads\ แยกต่างหาก
  • Schedule auto-backup: ปัจจุบันยังไม่มี — แนะนำ export ด้วยตัวเองก่อนอัปเดต version ใหญ่

ดูเพิ่มเติม​