sndfile-metadata-get(1)

Usage

sndfile-metadata-get [options] file

sndfile-metadata-set [options] file

sndfile-metadata-set [options] input output

Overview

sndfile-metadata-get displays bext and string metadata stored in an audio file. The following options specify what to print.

--all: all metadata
--bext-description: description
--bext-originator: originator info
--bext-orig-ref: originator reference
--bext-umid: Unique Material Identifier
--bext-orig-date: origination date
--bext-orig-time: origination time
--bext-coding-hist: coding history
--str-title: title
--str-copyright: copyright
--str-artist: artist
--str-comment: comment
--str-date: creation date
--str-album: album
--str-license: license

sndfile-metadata-set sets bext and string metadata in an audio file if the format supports it. If the file does not contain a BEXT chunk to be modified, the second synopsis must be used, where another output file capable of storing the metadata is created. This file is overwritten if it already exists. The following options take an argument specifying the metadata:

--bext-description: description
--bext-originator: originator
--bext-orig-ref: originator reference
--bext-umid: Unique Material Identifier
--bext-orig-date: origination date
--bext-orig-time: origination time
--bext-coding-hist: coding history
--bext-time-raf: time reference
--str-comment: comment
--str-title: title
--str-copyright: copyright
--str-artist: artist
--str-date: date
--str-album: album
--str-license: license

The following options take no argument:

--bext-auto-time-date: Set the BEXT time and date to current.
--bext-auto-time: Set the BEXT time to current.
--bext-auto-date: Set the BEXT date to current.
--str-auto-date: Set the string date to current.

Exit status

The sndfile-metadata-get utility exits 0 on success, and >0 if an error occurs.

History

Arch Linux 2026-11-01 to Debian 11 (Bullseye): the text shown here
Debian 10 (Buster) to Debian 9 (Stretch)
Debian 8 (Jessie) to Debian 7 (Wheezy)
Debian 6.0 (Squeeze)

--all since Debian 9 (Stretch); --bext-auto-date since Debian 9 (Stretch); --bext-auto-time since Debian 9 (Stretch); --bext-auto-time-date since Debian 9 (Stretch); --bext-coding-hist since Debian 9 (Stretch); --bext-description since Debian 9 (Stretch); --bext-orig-date since Debian 9 (Stretch); --bext-orig-ref since Debian 9 (Stretch); --bext-orig-time since Debian 9 (Stretch); --bext-originator since Debian 9 (Stretch); --bext-time-raf since Debian 9 (Stretch); --bext-umid since Debian 9 (Stretch); --str-album since Debian 9 (Stretch); --str-artist since Debian 9 (Stretch); --str-auto-date since Debian 9 (Stretch); --str-comment since Debian 9 (Stretch); --str-copyright since Debian 9 (Stretch); --str-date since Debian 9 (Stretch); --str-license since Debian 9 (Stretch); --str-title since Debian 9 (Stretch).