cannam@125: .Dd November 2, 2014
cannam@125: .Dt SNDFILE-METADATA-GET 1
cannam@125: .Os
cannam@125: .Sh NAME
cannam@125: .Nm sndfile-metadata-get ,
cannam@125: .Nm sndfile-metadata-set
cannam@125: .Nd get or set metadata in a sound file
cannam@125: .Sh SYNOPSIS
cannam@125: .Nm sndfile-metadata-get
cannam@125: .Op Ar options
cannam@125: .Ar file
cannam@125: .Nm sndfile-metadata-set
cannam@125: .Op Ar options
cannam@125: .Ar file
cannam@125: .Nm sndfile-metadata-set
cannam@125: .Op Ar options
cannam@125: .Ar input
cannam@125: .Ar output
cannam@125: .Sh DESCRIPTION
cannam@125: .Nm sndfile-metadata-get
cannam@125: displays bext and string metadata stored in an audio file.
cannam@125: The following options specify what to print.
cannam@125: .Pp
cannam@125: .Bl -tag -width bext-descriptionXXXX -compact
cannam@125: .It Fl -all
cannam@125: all metadata
cannam@125: .It Fl -bext-description
cannam@125: description
cannam@125: .It Fl -bext-originator
cannam@125: originator info
cannam@125: .It Fl -bext-orig-ref
cannam@125: originator reference
cannam@125: .It Fl -bext-umid
cannam@125: Unique Material Identifier
cannam@125: .It Fl -bext-orig-date
cannam@125: origination date
cannam@125: .It Fl -bext-orig-time
cannam@125: origination time
cannam@125: .It Fl -bext-coding-hist
cannam@125: coding history
cannam@125: .It Fl -str-title
cannam@125: title
cannam@125: .It Fl -str-copyright
cannam@125: copyright
cannam@125: .It Fl -str-artist
cannam@125: artist
cannam@125: .It Fl -str-comment
cannam@125: comment
cannam@125: .It Fl -str-date
cannam@125: creation date
cannam@125: .It Fl -str-album
cannam@125: album
cannam@125: .It Fl -str-license
cannam@125: license
cannam@125: .El
cannam@125: .Pp
cannam@125: .Nm sndfile-metadata-set
cannam@125: sets bext and string metadata in an audio file if the format supports it.
cannam@125: If the file does not contain a BEXT chunk to be modified,
cannam@125: the second synopsis must be used, where another output file
cannam@125: capable of storing the metadata is created.
cannam@125: This file is overwritten if it already exists.
cannam@125: The following options take an argument specifying the metadata:
cannam@125: .Pp
cannam@125: .Bl -tag -width bext-coding-histXXXXXXX -compact
cannam@125: .It Fl -bext-description
cannam@125: description
cannam@125: .It Fl -bext-originator
cannam@125: originator
cannam@125: .It Fl -bext-orig-ref
cannam@125: originator reference
cannam@125: .It Fl -bext-umid
cannam@125: Unique Material Identifier
cannam@125: .It Fl -bext-orig-date
cannam@125: origination date
cannam@125: .It Fl -bext-orig-time
cannam@125: origination time
cannam@125: .It Fl -bext-coding-hist
cannam@125: coding history
cannam@125: .It Fl -bext-time-raf
cannam@125: time reference
cannam@125: .It Fl -str-comment
cannam@125: comment
cannam@125: .It Fl -str-title
cannam@125: title
cannam@125: .It Fl -str-copyright
cannam@125: copyright
cannam@125: .It Fl -str-artist
cannam@125: artist
cannam@125: .It Fl -str-date
cannam@125: date
cannam@125: .It Fl -str-album
cannam@125: album
cannam@125: .It Fl -str-license
cannam@125: license
cannam@125: .El
cannam@125: .Pp
cannam@125: The following options take no argument:
cannam@125: .Pp
cannam@125: .Bl -tag -width bext-coding-histXXXXXXX -compact
cannam@125: .It Fl -bext-auto-time-date
cannam@125: Set the BEXT time and date to current.
cannam@125: .It Fl -bext-auto-time
cannam@125: Set the BEXT time to current.
cannam@125: .It Fl -bext-auto-date
cannam@125: Set the BEXT date to current.
cannam@125: .It Fl -str-auto-date
cannam@125: Set the string date to current.
cannam@125: .El
cannam@125: .Sh EXIT STATUS
cannam@125: .Ex -std
cannam@125: .Sh SEE ALSO
cannam@125: .Lk http://www.mega-nerd.com/libsndfile/
cannam@125: .Lk http://tech.ebu.ch/docs/tech/tech3285.pdf
cannam@125: .Sh AUTHORS
cannam@125: .An Erik de Castro Lopo Aq Mt erikd@mega-nerd.com