From 1b655ac0b74f982ce03bcc23b5156a76390568cd Mon Sep 17 00:00:00 2001
From: Warren Lo <warren@accusys.com.tw>
Date: Wed, 11 Mar 2026 01:47:20 +0800
Subject: [PATCH] Add USAGE.md

---
 docs/USAGE.md | 60 +++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 60 insertions(+)
 create mode 100644 docs/USAGE.md

diff --git a/docs/USAGE.md b/docs/USAGE.md
new file mode 100644
index 0000000..cc9bf64
--- /dev/null
+++ b/docs/USAGE.md
@@ -0,0 +1,60 @@
+# Usage Guide
+
+This document provides usage instructions for the video_probe tool.
+
+## Basic Usage
+
+```bash
+video_probe video.mp4
+```
+
+This will create `video.probe.json` in the same directory.
+
+## Example Output
+
+```bash
+$ video_probe sample.mp4
+
+Probing video: /path/sample.mp4
+========================================
+✓ Video probed successfully!
+
+File: sample.mp4
+Format: QuickTime / MOV
+Duration: 120.50 seconds
+Size: 50.00 MB
+Bit rate: 3473 kbps
+
+Video Stream:
+  Codec: h264 (High)
+  Resolution: 1920x1080
+  Frame rate: 30/1
+
+Audio Streams: 1
+  [1] aac - 2 channels @ 48000 Hz
+
+✓ Metadata saved to: /path/sample.probe.json
+```
+
+## JSON Output Format
+
+The JSON file contains structured metadata:
+
+```json
+{
+  "video_path": "/path/to/video.mp4",
+  "probed_at": "2026-03-06T10:30:00Z",
+  "format": {
+    "duration": 120.5,
+    "size": 52428800,
+    "bit_rate": 3473408
+  },
+  "video_stream": {
+    "codec_name": "h264",
+    "width": 1920,
+    "height": 1080
+  },
+  "audio_streams": [...],
+  "subtitle_streams": [...]
+}
+```
\ No newline at end of file