probe_container: Shortcut functions for probing specific information

In tidymedia: Media File Preprocessing and Metadata for the 'tidyverse'

Shortcut functions for probing specific information

Description

These functions return one part of what probe_all() returns. probe_container() returns the container tibble, and probe_streams() returns the streams tibble. probe_video() and probe_audio() return only the video rows or the audio rows of streams.

Usage

probe_container(probe = NULL, infile = NULL, typed = TRUE, parallel = FALSE)

probe_streams(probe = NULL, infile = NULL, typed = TRUE, parallel = FALSE)

probe_video(probe = NULL, infile = NULL, typed = TRUE, parallel = FALSE)

probe_audio(probe = NULL, infile = NULL, typed = TRUE, parallel = FALSE)

Arguments

probe	A list made by probe_all(). Must be NULL if you give infile.
infile	A character vector of one or more media files. Must be NULL if you give probe.
typed	A logical that the function passes to probe_all() when you give infile. The default is TRUE. The function ignores it when you give probe.
parallel	A logical that the function passes to probe_all() when you give infile. If TRUE, it probes the files in parallel with furrr. If FALSE (the default), it probes them one at a time. The function ignores it when you give probe, because nothing is left to probe.

Details

Give each function either the output of probe_all() in probe, or one or more files in infile. Give exactly one of the two, or the function gives an error. With infile, the function probes the files again. For large files, probe once with probe_all() and reuse the result.

These functions use FFprobe and return tibbles. The MediaInfo functions, ⁠mediainfo_*()⁠, and the ⁠get_*()⁠ functions are the other ways to read information. The glossary in vignette("tidymedia") explains media terms such as container and stream.

Value

A tibble with only the requested information. When you give infile, a file that could not be probed gives a warning, as in probe_all().

See Also

probe_all() for the full probe. mediainfo_query() to read information with MediaInfo. get_width() and the other ⁠get_*()⁠ functions for single values.

Other metadata functions: get_duration(), get_frame_rate(), get_height(), get_sample_rate(), get_width(), mediainfo_parameter(), mediainfo_query(), mediainfo_template(), probe_all()

Examples

video <- system.file("extdata", "sample.mp4", package = "tidymedia")
# Probe directly from a file location ...
probe_container(infile = video)
# ... or reuse a probe object to avoid reprobing large files
info <- probe_all(video)
probe_video(info)
probe_audio(info)

tidymedia documentation built on Oct. 11, 2026, 5:08 p.m.