Skip to content

probe — Inspect media metadata

Use probe to quickly check the metadata of any audio or video file.

Usage

praisonai-editor probe INPUT [OPTIONS]

Options

Option Description
INPUT Path to media file (MP3, MP4, WAV, …)
--output FILE Save result as JSON file
--json Print full JSON to stdout

Examples

praisonai-editor probe podcast.mp3

Output: 

File: podcast.mp3
Duration: 1823.45s
Type: Audio only
Audio codec: mp3
Audio: 44100Hz, 2ch
Size: 42.30 MB


praisonai-editor probe video.mp4 --json

{
  "path": "video.mp4",
  "duration": 3600.0,
  "has_video": true,
  "audio_codec": "aac",
  "audio_sample_rate": 48000,
  "audio_channels": 2,
  "video_codec": "h264",
  "width": 1920,
  "height": 1080,
  "fps": 30.0,
  "size_bytes": 524288000
}

praisonai-editor probe file.mp3 --output meta.json

What is probe useful for?

flowchart LR
    A[media file] --> B[probe]
    B --> C{Audio or Video?}
    C -->|Audio only| D["Duration, codec,\nsample rate, channels"]
    C -->|Video| E["+ resolution, FPS,\nvideo codec"]

Python API

from praisonai_editor.probe import probe_media

info = probe_media("podcast.mp3")
print(info.duration)       # 1823.45
print(info.is_audio_only)  # True