From 5c1a7b3a997c7760ab2cd93d70f5eb8eb4341a8b Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Fr=C3=A9d=C3=A9ric=20Mangano?= Date: Wed, 12 Mar 2025 11:35:45 +0900 Subject: [PATCH] Mention METADATA_BLOCK_PICTURE in the man page --- opustags.1 | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/opustags.1 b/opustags.1 index f90ca7c..2b78861 100644 --- a/opustags.1 +++ b/opustags.1 @@ -1,4 +1,4 @@ -.TH opustags 1 "April 2024" "@PROJECT_NAME@ @PROJECT_VERSION@" +.TH opustags 1 "March 2025" "@PROJECT_NAME@ @PROJECT_VERSION@" .SH NAME opustags \- Ogg Opus tag editor .SH SYNOPSIS @@ -106,7 +106,7 @@ environment variable. The allowed format is the same as with \fB--set-all\fP. If TERM and VISUAL are set, VISUAL takes precedence over EDITOR. .TP .B \-\-output-cover \fIFILE\fP -Save the cover art of the input Opus file to the specified location. +Extract the cover art from the \fBMETADATA_BLOCK_PICTURE\fP tag into the specified location. If the input file does not contain any cover art, this option has no effect. To allow overwriting the target location, specify \fB--overwrite\fP. In the case of multiple pictures embedded in the Opus tags, only the first one is saved. @@ -116,7 +116,8 @@ rely on the magic number to deduce the type. You can specify \fB-\fP for standard output, in which case the regular output will be suppressed. .TP .B \-\-set-cover \fIFILE\fP -Replace or set the cover art to the specified picture. +Set the cover art by embedding the specified picture into the \fBMETADATA_BLOCK_PICTURE\fP tag, +replacing any existing values. Specify \fB-\fP to read the picture from standard input. In theory, an Opus file may contain multiple pictures with different roles, though in practice only the front cover really matters.