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)