tidymedia-package: tidymedia: Media File Preprocessing and Metadata for the...

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

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

Description

tidymedia prepares audio and video files for research. It trims, crops, converts and standardizes files, and reads file details back as tibbles. It runs the programs FFmpeg and MediaInfo. Start with vignette("tidymedia").

Details

Task functions, such as extract_audio(), do one common job in one call. Pipeline functions, such as ffm_files(), build an FFmpeg command one step at a time. Direct commands, ffmpeg(), ffprobe() and mediainfo(), pass your own arguments to the programs. probe_all() and get_duration() read file details.

See vignette("tidymedia") for the guided tour and a glossary of media terms. The other vignettes are "batch", "metadata", "verification" and "workflow".

Session options

A new option value takes effect at the next call. The workers of a parallel = TRUE run use your session's values.

• options(tidymedia.timeout = 600) sets a limit, in whole seconds, on each program the package starts. The default, 0, means no limit. See with_timeout().

• options(tidymedia.check_tracks = FALSE) turns off the dropped-track warning of extract_audio(), convert_audio(), normalize_audio() and their ⁠_batch⁠ forms. The default is TRUE. The check runs one FFprobe call for each different input, when run = TRUE and the call or job row names no audio_stream. Turning it off skips those calls. A value other than TRUE or FALSE gives an error that names the option, when the check would run.

• options(tidymedia.hardware_encoders = "h264_nvenc") names the hardware video encoders of this computer, so the package does not ask FFmpeg. character(0) means none.

Errors when FFmpeg fails

• tidymedia_ffmpeg_exit: FFmpeg exited non-zero in ffm_run(), or in the loudnorm analysis pass of normalize_audio(two_pass = TRUE). The task functions that run their command with ffm_run(), such as extract_audio() and separate_audio_video(), give it too. The tm_status field holds the exit status.

• tidymedia_loudnorm_no_measurement: the two-pass analysis gave no measurement. In the ⁠_batch⁠ form, tm_rows holds the rows, and tm_row_status holds each exit status or NA.

• tidymedia_multitrack_separation: separate_audio_video() could not write several audio tracks into one audio file. The ⁠_batch⁠ form gives a warning.

• tidymedia_encoder_unavailable: this FFmpeg build lists no encoder for a codec the call used. After a failed run, ffm_run() adds it before tidymedia_ffmpeg_exit, and ffm_batch() gives one warning for all its rows. A hardware encoder that fallback = FALSE cannot use gives it too. tm_encoder holds the names and tm_stream says "video" or "audio" for each. "When the build lacks an encoder" on ffm_run() says more.

Author(s)

Maintainer: Jeffrey Girard [e-mail] (ORCID)

Authors:

• Jeffrey Girard [e-mail] (ORCID)

See Also

Useful links:

• https://github.com/jmgirard/tidymedia

• https://jmgirard.github.io/tidymedia/

• Report bugs at https://github.com/jmgirard/tidymedia/issues

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