Files
video_probe/docs/USAGE.md
2026-03-11 01:47:20 +08:00

60 lines
1.0 KiB
Markdown

# 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": [...]
}
```