From 32f52e5788ed96ac904811e728420a2ac7557fee Mon Sep 17 00:00:00 2001
From: Warren Lo <warren@accusys.com.tw>
Date: Thu, 19 Mar 2026 00:32:56 +0800
Subject: [PATCH] Add README.md

---
 README.md | 72 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 72 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..83d8c29
--- /dev/null
+++ b/README.md
@@ -0,0 +1,72 @@
+# MoMentry Playground
+
+統一媒體播放、檢視、監控平台
+
+## 功能
+
+- 多格式媒體播放（視頻、音頻、圖片）
+- Frame-精確的視頻控制
+- Markdown / PDF / HTML 檢視
+- YouTube URL 直接播放
+- 與 momentry_core 進度監控
+- Database 查詢功能
+
+## 安裝依賴
+
+```bash
+# FFmpeg (必需)
+brew install ffmpeg
+
+# yt-dlp (YouTube 支援)
+brew install yt-dlp
+```
+
+## 構建
+
+```bash
+cargo build --release
+```
+
+## 運行
+
+```bash
+# 基本運行
+cargo run
+
+# 開啟檔案
+cargo run -- --file video.mp4
+
+# 指定窗口大小
+cargo run -- --width 1280 --height 720 --file video.mp4
+```
+
+## 命令
+
+| 命令 | 說明 |
+|------|------|
+| `play` | 播放 |
+| `pause` | 暫停 |
+| `stop` | 停止 |
+| `seek <frame>` | Frame seek |
+| `seek <ms>ms` | Time seek |
+| `+` / `-` | Zoom in/out |
+
+## 開發
+
+```bash
+# 格式化
+cargo fmt
+
+# Lint
+cargo clippy
+
+# 測試
+cargo test
+```
+
+## 技術棧
+
+- **語言**: Rust 2021
+- **桌面**: tao + wry
+- **視頻**: SDL2 + FFmpeg
+- **前端**: HTML/CSS/JS (WebView)