| 1 |
<!DOCTYPE html> |
| 2 |
<html xmlns="http://www.w3.org/1999/xhtml" lang xml:lang> |
| 3 |
<head> |
| 4 |
<meta charset="utf-8" /> |
| 5 |
<meta name="generator" content="pandoc" /> |
| 6 |
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" /> |
| 7 |
<title>metaflac(1) Version 1.5.0 | Free Lossless Audio Codec metadata tool</title> |
| 8 |
<style> |
| 9 |
code{white-space: pre-wrap;} |
| 10 |
span.smallcaps{font-variant: small-caps;} |
| 11 |
div.columns{display: flex; gap: min(4vw, 1.5em);} |
| 12 |
div.column{flex: auto; overflow-x: auto;} |
| 13 |
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;} |
| 14 |
|
| 15 |
ul.task-list[class]{list-style: none;} |
| 16 |
ul.task-list li input[type="checkbox"] { |
| 17 |
font-size: inherit; |
| 18 |
width: 0.8em; |
| 19 |
margin: 0 0.8em 0.2em -1.6em; |
| 20 |
vertical-align: middle; |
| 21 |
} |
| 22 |
.display.math{display: block; text-align: center; margin: 0.5rem auto;} |
| 23 |
</style> |
| 24 |
<style type="text/css">html{background-color: #B3D9B3;}body{position: relative;display: block;background-color: #F2F2DE;color: black;margin: 0 auto;padding: 0 0 10px 0;max-width: 1200px;font-family: lucida, verdana, helvetica, arial, sans-serif;font-weight: normal;font-size: 100%;}div.logo{position: relative;background-color: black;padding: 1px;text-align: center;}div.navbar {font-weight: bold;}@media (min-width: 800px){div.navbar{display: flex;gap: 5px;flex-direction: row;padding: 8px;text-align: center;}div.navbar:before, div.navbar:after{content: "";flex: 1 1;border-bottom: 2px solid;margin: 10px;}div.navbar div:first-child a::after, div.navbar div:last-child a:not(:last-child)::after {content: " - ";}#navbarshow{display: none;}}@media (max-width: 799px){div.navbar div{display: flex;gap: 5px;flex-direction: row;padding: 8px;text-align: center;}div.navbar div:before, div.navbar div:after{content: "";flex: 1 1;flex-grow: 3;border-bottom: 2px solid;margin: 10px;}div.navbar div a:not(:last-child)::after {content: " - ";}#navbarshow{display: none;}}div.navbar a{color: #000;text-decoration: none;}div.content{padding: 0 25px;}div.box_footer{border-width: 0px 0px 1px 0px;border-style: solid;border-color: black;background-color: #EEEED4;padding: 3px;}div.box_body{background-color: #EEEED4;padding: 0px 3px 0px 3px;font-family: lucida, verdana, helvetica, arial, sans-serif;font-weight: normal;font-size: 100%;}#newsbox h3{margin: 5px 0 0 0; font-size: 0.9em; }#newsbox p{margin: 0;}div.smallbox{text-align: left;margin: 0 0 0 8px;background-color: #EEEED4;}div.smallbox_title{text-align: center;border-width: 1px 0px 0px 0px;border-style: solid;border-color: black;background-color: #D3D4C5;padding: 3px;font-family: lucida, verdana, helvetica, arial, sans-serif;font-weight: bold;font-size: 100%;}div.smallbox_header{border-width: 1px 0px 0px 0px;border-style: solid;border-color: black;background-color: #EEEED4;padding: 3px;}div.smallbox_footer{border-width: 0px 0px 1px 0px;border-style: solid;border-color: black;background-color: #EEEED4;padding: 3px;}div.smallbox_body{background-color: #EEEED4;padding: 0px 3px 0px 3px;font-family: lucida, verdana, helvetica, arial, sans-serif;font-weight: normal;font-size: 80%;}div.copyright{text-align: left;padding-bottom: 10px;}div.copyright hr {margin: 20px 0;}span.commandname{font-family: monospace;font-weight: bold;}span.command{font-family: monospace;font-weight: bold;}span.argument{font-family: monospace;}span.code{font-family: monospace;}a:link, a:visited, a:active, a:hover{color:#336699;background-color:transparent;}div.imageflex{display: flex;flex-wrap: wrap;justify-content: center;padding: 0 20px}div.imageflex div{width: 200px;height: 125px;padding: 10px;text-align: center;}div.imageflex div span {display: block;text-align: center;}</style> |
| 25 |
</head> |
| 26 |
<body> |
| 27 |
<div class="logo"> |
| 28 |
<img src="data:image/png;base64, |
| 29 |
iVBORw0KGgoAAAANSUhEUgAAAKEAAABQBAMAAACDsQg5AAAAMFBMVEUAAABTAgC1AAMkMh/7AABQ |
| 30 |
UQBbYFklgx8nnieiogCZm5i9wLzIysfY29f5+gD7/vuN5xJAAAAEtklEQVRYw92YP4vbPBjA9SKq |
| 31 |
wU5I+xX6CQyBDHcX0qEf4F26CwwenJjc1vWFd+n4rt0MhQzOhQsUPLgXEihkSHNcIJAhdyGF7qVQ |
| 32 |
uOGS4Nd/ZFmyZV+Sc4dWoER6LP2sP8/z6JEBKD69ePG8WOBfr1+/ynoGNVwkEVlr150VSEQez3V/ |
| 33 |
BuWaPlg8mYhufKD7AIB85bPvn0y8DIDuBoBKUHgyUQ6B7q4wIhmi6yqHE4X6KEVAFx9BFKUGJY6O |
| 34 |
IL58+Zz799OQEmfHryO7nnBNiffFEBEFegpZCDHSHdeyOsUQQ4i7YCrFEJXiiI3IAgsjtiMvISLW |
| 35 |
tI6aouj+imcmWG2zEI6od8mWsa4YNkOho2QQeyviJVarO4Unxmq1jXtDag+bQPjs/fv/ohy2iNXb |
| 36 |
3SWIsb2T3pxXIUv/7Pv3r17+5uewhZtNlJlnkVc33IQwRUQ5xBLbG6eae8kUEKUcYoXtPE/Ombzm |
| 37 |
IGKD7bwRDPFBNOtSDrHNdVdSEs+dCoiVHCI/xb4nueEkfvu09rRziGuu/4zf/NjMsg4tIXHqaPqU |
| 38 |
euPkpPtC4k02Ed6GFn1CibSxpfXIpKN19HM462pVI55C09SEXSucK7mnO73xdfNkHTZK20zcIdOb |
| 39 |
SUQmc8peNo8nIiJr8AYJjiE2p1M7JrbZIR5FRJfhqkXEoUhnDiISzdqpRLZmDDxJ/LoPkerzJpQh |
| 40 |
oRZCz1ai/BiRNzlK3CNYzyAmTI4SwdHEdpIoCYnMOgY5h5gAuvNc4jd2v8VE0n/3ZVAUsUxPEqJE |
| 41 |
c/HO7E+MpYgn9o8lXkZDjIpz6OZo+B7EYbxoZUJaP2aF+cSg+5aJBOZRvI4zbSayGzGRCQFlcs7w |
| 42 |
3gwqh2k4ZFSlRIjkJN6Fg2yEHtc7BRQuP0LEcYMZjRaCsEoipwJ89+4fNj8y6+DGTW4ns+gt/plU |
| 43 |
1ddkrPsT1/R4PKPwy3RIcQAxuiB3unEEUBdEAPsTk67HJyYCqSAU2p9YFhBF096fKImIgsAnQTzP |
| 44 |
8Y9DATEpxAfoI91iniinouYDToX4kryLifyGBc3evPnbzyDKOWdhK+rYYYiImfcW5+zM7m4cE6NK |
| 45 |
L+y4RKynRTccUEzcdrQqvchuLVqBgbI8KMi9tTRV4aTei3CmXeckvet0RN/YvBTdPw8k7pF+E+I5 |
| 46 |
m8GvSRotqalC/DEAcbVcIBrTop0q0NSU2ZoRz/rt23M2B1cBW8U1FfhfcW2kAb+o2FBTUCirqUhB |
| 47 |
QGuioBYKNcN/rpF1/De5M9L46sOnq9pk4hFbXdO5kK25Xe6OnO6p8xmAZU/GDcn5UkF+i089r6Hs |
| 48 |
rGTns3FhZhBR30EjuYUbHtGGPxZINhW7CxZjWDJVAHH9FDcquFkp4xaAPyTDrBtg0AL2AmUTbWl7 |
| 49 |
bdxdK8Aeg/vWEg1N+3q6aD7AnmfMg4FHrAOPqNQBGoEKLjWBYUyXcwCyiWiEzrAUjPGneaZ7/12g |
| 50 |
4pIOHCD1y6e4XVHCMaJ4jOoC9bOIpg0mF7WJE67jste0xnbdGjkXTWcM0LKnT4aSdVuWHMdfR23i |
| 51 |
lJxVyfpodLNmDbEKTlSgezuJUQfUOlDHYSGQ6RrWNe8XBTUUCK0atBTUydKePz79Dy84W9TLWTUv |
| 52 |
AAAAAElFTkSuQmCC" alt="FLAC Logo" id="logo" /> |
| 53 |
</div> |
| 54 |
|
| 55 |
<div class="content"> |
| 56 |
|
| 57 |
|
| 58 |
<header id="title-block-header"> |
| 59 |
<h1 class="title">metaflac(1) Version 1.5.0 | Free Lossless Audio Codec |
| 60 |
metadata tool</h1> |
| 61 |
</header> |
| 62 |
<h1 id="name">NAME</h1> |
| 63 |
<p>metaflac - program to list, add, remove, or edit metadata in one or |
| 64 |
more FLAC files.</p> |
| 65 |
<h1 id="synopsis">SYNOPSIS</h1> |
| 66 |
<p><strong>metaflac</strong> [ <em>options</em> ] [ <em>operations</em> |
| 67 |
] <em>FLACfile …</em></p> |
| 68 |
<h1 id="description">DESCRIPTION</h1> |
| 69 |
<p>Use <strong>metaflac</strong> to list, add, remove, or edit metadata |
| 70 |
in one or more FLAC files. You may perform one major operation, or many |
| 71 |
shorthand operations at a time.</p> |
| 72 |
<h1 id="general-usage">GENERAL USAGE</h1> |
| 73 |
<p>metaflac is the command-line .flac file metadata editor. You can use |
| 74 |
it to list the contents of metadata blocks, edit, delete or insert |
| 75 |
blocks, and manage padding.</p> |
| 76 |
<p>metaflac takes a set of “options” (though some are not optional) and |
| 77 |
a set of FLAC files to operate on. There are three kinds of |
| 78 |
“options”:</p> |
| 79 |
<ul> |
| 80 |
<li><p>Major operations, which specify a mode of operation like listing |
| 81 |
blocks, removing blocks, etc. These will have sub-operations describing |
| 82 |
exactly what is to be done.</p></li> |
| 83 |
<li><p>Shorthand operations, which are convenient synonyms for major |
| 84 |
operations. For example, there is a shorthand operation |
| 85 |
--show-sample-rate that shows just the sample rate field from the |
| 86 |
STREAMINFO metadata block.</p></li> |
| 87 |
<li><p>Global options, which affect all the operations.</p></li> |
| 88 |
</ul> |
| 89 |
<p>All of these are described in the tables below. At least one |
| 90 |
shorthand or major operation must be supplied. You can use multiple |
| 91 |
shorthand operations to do more than one thing to a file or set of |
| 92 |
files. Most of the common things to do to metadata have shorthand |
| 93 |
operations. As an example, here is how to show the MD5 signatures for a |
| 94 |
set of three FLAC files:</p> |
| 95 |
<p><code>metaflac --show-md5sum file1.flac file2.flac file3.flac</code></p> |
| 96 |
<p>Another example; this removes all DESCRIPTION and COMMENT tags in a |
| 97 |
set of FLAC files, and uses the --preserve-modtime global option to keep |
| 98 |
the FLAC file modification times the same (usually when files are edited |
| 99 |
the modification time is set to the current time):</p> |
| 100 |
<p><code>metaflac --preserve-modtime --remove-tag=DESCRIPTION --remove-tag=COMMENT file1.flac file2.flac file3.flac</code></p> |
| 101 |
<h1 id="options">OPTIONS</h1> |
| 102 |
<dl> |
| 103 |
<dt><strong>-o</strong> <em>filename</em><strong>, |
| 104 |
--output-name=</strong><em>filename</em></dt> |
| 105 |
<dd> |
| 106 |
Output to a new file instead of changing or rewriting the input file. |
| 107 |
</dd> |
| 108 |
<dt><strong>--preserve-modtime</strong></dt> |
| 109 |
<dd> |
| 110 |
Preserve the original modification time in spite of edits. This does |
| 111 |
nothing when -o or –output-name are specified. |
| 112 |
</dd> |
| 113 |
<dt><strong>--with-filename</strong></dt> |
| 114 |
<dd> |
| 115 |
Prefix each output line with the FLAC file name (the default if more |
| 116 |
than one FLAC file is specified). This option has no effect for options |
| 117 |
exporting to a file, like --export-tags-to. |
| 118 |
</dd> |
| 119 |
<dt><strong>--no-filename</strong></dt> |
| 120 |
<dd> |
| 121 |
Do not prefix each output line with the FLAC file name (the default if |
| 122 |
only one FLAC file is specified). |
| 123 |
</dd> |
| 124 |
<dt><strong>--no-utf8-convert</strong></dt> |
| 125 |
<dd> |
| 126 |
Do not convert tags from UTF-8 to local charset, or vice versa. This is |
| 127 |
useful for scripts, and setting tags in situations where the locale is |
| 128 |
wrong. |
| 129 |
</dd> |
| 130 |
<dt><strong>--dont-use-padding</strong></dt> |
| 131 |
<dd> |
| 132 |
By default metaflac tries to use padding where possible to avoid |
| 133 |
rewriting the entire file if the metadata size changes. Use this option |
| 134 |
to tell metaflac to not take advantage of padding this way. |
| 135 |
</dd> |
| 136 |
</dl> |
| 137 |
<h1 id="shorthand-operations">SHORTHAND OPERATIONS</h1> |
| 138 |
<dl> |
| 139 |
<dt><strong>--show-md5sum</strong></dt> |
| 140 |
<dd> |
| 141 |
Show the MD5 signature from the STREAMINFO block. |
| 142 |
</dd> |
| 143 |
<dt><strong>--show-min-blocksize</strong></dt> |
| 144 |
<dd> |
| 145 |
Show the minimum block size from the STREAMINFO block. |
| 146 |
</dd> |
| 147 |
<dt><strong>--show-max-blocksize</strong></dt> |
| 148 |
<dd> |
| 149 |
Show the maximum block size from the STREAMINFO block. |
| 150 |
</dd> |
| 151 |
<dt><strong>--show-min-framesize</strong></dt> |
| 152 |
<dd> |
| 153 |
Show the minimum frame size from the STREAMINFO block. |
| 154 |
</dd> |
| 155 |
<dt><strong>--show-max-framesize</strong></dt> |
| 156 |
<dd> |
| 157 |
Show the maximum frame size from the STREAMINFO block. |
| 158 |
</dd> |
| 159 |
<dt><strong>--show-sample-rate</strong></dt> |
| 160 |
<dd> |
| 161 |
Show the sample rate from the STREAMINFO block. |
| 162 |
</dd> |
| 163 |
<dt><strong>--show-channels</strong></dt> |
| 164 |
<dd> |
| 165 |
Show the number of channels from the STREAMINFO block. |
| 166 |
</dd> |
| 167 |
<dt><strong>--show-bps</strong></dt> |
| 168 |
<dd> |
| 169 |
Show the # of bits per sample from the STREAMINFO block. |
| 170 |
</dd> |
| 171 |
<dt><strong>--show-total-samples</strong></dt> |
| 172 |
<dd> |
| 173 |
Show the total # of samples from the STREAMINFO block. |
| 174 |
</dd> |
| 175 |
<dt><strong>--show-vendor-tag</strong></dt> |
| 176 |
<dd> |
| 177 |
Show the vendor string from the VORBIS_COMMENT block. |
| 178 |
</dd> |
| 179 |
<dt><strong>--show-tag=name</strong></dt> |
| 180 |
<dd> |
| 181 |
Show all tags where the field name matches ‘name’. |
| 182 |
</dd> |
| 183 |
<dt><strong>--show-all-tags</strong></dt> |
| 184 |
<dd> |
| 185 |
Show all tags. This is an alias for --export-tags-to=-. |
| 186 |
</dd> |
| 187 |
<dt><strong>--remove-tag=name</strong></dt> |
| 188 |
<dd> |
| 189 |
Remove all tags whose field name is ‘name’. |
| 190 |
</dd> |
| 191 |
<dt><strong>--remove-first-tag=name</strong></dt> |
| 192 |
<dd> |
| 193 |
Remove first tag whose field name is ‘name’. |
| 194 |
</dd> |
| 195 |
<dt><strong>--remove-all-tags</strong></dt> |
| 196 |
<dd> |
| 197 |
Remove all tags, leaving only the vendor string. |
| 198 |
</dd> |
| 199 |
<dt><strong>--remove-all-tags-except=NAME1[=NAME2[=…]]</strong></dt> |
| 200 |
<dd> |
| 201 |
Remove all tags, except the vendor string and the tag names specified. |
| 202 |
Tag names must be separated by an = character. |
| 203 |
</dd> |
| 204 |
<dt><strong>--set-tag=field</strong></dt> |
| 205 |
<dd> |
| 206 |
Add a tag. The field must comply with the Vorbis comment spec, of the |
| 207 |
form “NAME=VALUE”. If there is currently no tag block, one will be |
| 208 |
created. |
| 209 |
</dd> |
| 210 |
<dt><strong>--set-tag-from-file=field</strong></dt> |
| 211 |
<dd> |
| 212 |
Like --set-tag, except the VALUE is a filename whose contents will be |
| 213 |
read verbatim to set the tag value. Unless --no-utf8-convert is |
| 214 |
specified, the contents will be converted to UTF-8 from the local |
| 215 |
charset. This can be used to store a cuesheet in a tag (e.g. |
| 216 |
--set-tag-from-file=“CUESHEET=image.cue”). Do not try to store binary |
| 217 |
data in tag fields! Use APPLICATION blocks for that. |
| 218 |
</dd> |
| 219 |
<dt><strong>--import-tags-from=file</strong></dt> |
| 220 |
<dd> |
| 221 |
Import tags from a file. Use ‘-’ for stdin. Each line should be of the |
| 222 |
form NAME=VALUE. Multi-line comments are currently not supported. |
| 223 |
Specify --remove-all-tags and/or --no-utf8-convert before |
| 224 |
--import-tags-from if necessary. If FILE is ‘-’ (stdin), only one FLAC |
| 225 |
file may be specified. |
| 226 |
</dd> |
| 227 |
<dt><strong>--export-tags-to=file</strong></dt> |
| 228 |
<dd> |
| 229 |
Export tags to a file. Use ‘-’ for stdout. Each line will be of the form |
| 230 |
NAME=VALUE. Specify --no-utf8-convert if necessary. |
| 231 |
</dd> |
| 232 |
<dt><strong>--import-cuesheet-from=file</strong></dt> |
| 233 |
<dd> |
| 234 |
Import a cuesheet from a file. Use ‘-’ for stdin. Only one FLAC file may |
| 235 |
be specified. A seekpoint will be added for each index point in the |
| 236 |
cuesheet to the SEEKTABLE unless --no-cued-seekpoints is specified. |
| 237 |
</dd> |
| 238 |
<dt><strong>--export-cuesheet-to=file</strong></dt> |
| 239 |
<dd> |
| 240 |
Export CUESHEET block to a cuesheet file, suitable for use by CD |
| 241 |
authoring software. Use ‘-’ for stdout. Only one FLAC file may be |
| 242 |
specified on the command line. |
| 243 |
</dd> |
| 244 |
<dt><strong>--import-picture-from={</strong><em>FILENAME</em><strong>|</strong><em>SPECIFICATION</em><strong>}</strong></dt> |
| 245 |
<dd> |
| 246 |
Import a picture and store it in a PICTURE metadata block. More than one |
| 247 |
--import-picture-from command can be specified. Either a filename for |
| 248 |
the picture file or a more complete specification form can be used. The |
| 249 |
SPECIFICATION is a string whose parts are separated by | (pipe) |
| 250 |
characters. Some parts may be left empty to invoke default values. |
| 251 |
FILENAME is just shorthand for “||||FILENAME”. For details on the |
| 252 |
specification, see the section <strong>Picture specification</strong> in |
| 253 |
the <strong>flac(1)</strong> man page. |
| 254 |
</dd> |
| 255 |
<dt><strong>--export-picture-to=file</strong></dt> |
| 256 |
<dd> |
| 257 |
Export PICTURE block to a file. Use ‘-’ for stdout. Only one FLAC file |
| 258 |
may be specified on the command line. The first PICTURE block will be |
| 259 |
exported unless --export-picture-to is preceded by a --block-number=# |
| 260 |
option to specify the exact metadata block to extract. Note that the |
| 261 |
block number is the one shown by --list. |
| 262 |
</dd> |
| 263 |
<dt><strong>--add-replay-gain</strong></dt> |
| 264 |
<dd> |
| 265 |
Calculates the title and album gains/peaks of the given FLAC files as if |
| 266 |
all the files were part of one album, then stores them as FLAC tags. The |
| 267 |
tags are the same as those used by vorbisgain. Existing ReplayGain tags |
| 268 |
will be replaced. If only one FLAC file is given, the album and title |
| 269 |
gains will be the same. Since this operation requires two passes, it is |
| 270 |
always executed last, after all other operations have been completed and |
| 271 |
written to disk. All FLAC files specified must have the same resolution, |
| 272 |
sample rate, and number of channels. Only mono and stereo files are |
| 273 |
allowed, and the sample rate must be 8, 11.025, 12, 16, 18.9, 22.05, 24, |
| 274 |
28, 32, 36, 37.8, 44.1, 48, 56, 64, 72, 75.6, 88.2, 96, 112, 128, 144, |
| 275 |
151.2, 176.4, 192, 224, 256, 288, 302.4, 352.8, 384, 448, 512, 576, or |
| 276 |
604.8 kHz. |
| 277 |
</dd> |
| 278 |
<dt><strong>--scan-replay-gain</strong></dt> |
| 279 |
<dd> |
| 280 |
Like --add-replay-gain, but only analyzes the files rather than writing |
| 281 |
them to the tags. |
| 282 |
</dd> |
| 283 |
<dt><strong>--remove-replay-gain</strong></dt> |
| 284 |
<dd> |
| 285 |
Removes the ReplayGain tags. |
| 286 |
</dd> |
| 287 |
<dt><strong>--add-seekpoint={</strong><em>#</em><strong>|</strong><em>X</em><strong>|</strong><em>#x</em><strong>|</strong><em>#s</em><strong>}</strong></dt> |
| 288 |
<dd> |
| 289 |
Add seek points to a SEEKTABLE block. Using #, a seek point at that |
| 290 |
sample number is added. Using X, a placeholder point is added at the end |
| 291 |
of a the table. Using #x, # evenly spaced seek points will be added, the |
| 292 |
first being at sample 0. Using #s, a seekpoint will be added every # |
| 293 |
seconds (# does not have to be a whole number; it can be, for example, |
| 294 |
9.5, meaning a seekpoint every 9.5 seconds). If no SEEKTABLE block |
| 295 |
exists, one will be created. If one already exists, points will be added |
| 296 |
to the existing table, and any duplicates will be turned into |
| 297 |
placeholder points. You may use many --add-seekpoint options; the |
| 298 |
resulting SEEKTABLE will be the unique-ified union of all such values. |
| 299 |
Example: --add-seekpoint=100x --add-seekpoint=3.5s will add 100 evenly |
| 300 |
spaced seekpoints and a seekpoint every 3.5 seconds. |
| 301 |
</dd> |
| 302 |
<dt><strong>--add-padding=length</strong></dt> |
| 303 |
<dd> |
| 304 |
Add a padding block of the given length (in bytes). The overall length |
| 305 |
of the new block will be 4 + length; the extra 4 bytes is for the |
| 306 |
metadata block header. |
| 307 |
</dd> |
| 308 |
</dl> |
| 309 |
<h1 id="major-operations">MAJOR OPERATIONS</h1> |
| 310 |
<dl> |
| 311 |
<dt><strong>--list</strong></dt> |
| 312 |
<dd> |
| 313 |
List the contents of one or more metadata blocks to stdout. By default, |
| 314 |
all metadata blocks are listed in text format. Use the options |
| 315 |
<strong>--block-number</strong>, <strong>--block-type</strong> or |
| 316 |
<strong>--except-block-type</strong> to change this behavior. |
| 317 |
</dd> |
| 318 |
<dt><strong>--remove</strong></dt> |
| 319 |
<dd> |
| 320 |
Remove one or more metadata blocks from the metadata. Use the options |
| 321 |
<strong>--block-number</strong>, <strong>--block-type</strong> or |
| 322 |
<strong>--except-block-type</strong> to specify which blocks should be |
| 323 |
removed. Note that if both --block-number and --[except-]block-type are |
| 324 |
specified, the result is the logical AND of both arguments. Unless |
| 325 |
--dont-use-padding is specified, the blocks will be replaced with |
| 326 |
padding. You may not remove the STREAMINFO block. |
| 327 |
</dd> |
| 328 |
<dt><strong>--block-number=#[,#[…]]</strong></dt> |
| 329 |
<dd> |
| 330 |
An optional comma-separated list of block numbers to display. The first |
| 331 |
block, the STREAMINFO block, is block 0. |
| 332 |
</dd> |
| 333 |
</dl> |
| 334 |
<p><strong>--block-type=type[,type[…]]</strong></p> |
| 335 |
<dl> |
| 336 |
<dt><strong>--except-block-type=type[,type[…]]</strong></dt> |
| 337 |
<dd> |
| 338 |
An optional comma-separated list of block types to be included or |
| 339 |
ignored with this option. Use only one of --block-type or |
| 340 |
--except-block-type. The valid block types are: STREAMINFO, PADDING, |
| 341 |
APPLICATION, SEEKTABLE, VORBIS_COMMENT, PICTURE. You may narrow down the |
| 342 |
types of APPLICATION blocks selected by appending APPLICATION with a |
| 343 |
colon and the ID of the APPLICATION block in either ASCII or hexadecimal |
| 344 |
representation. E.g. APPLICATION:abcd for the APPLICATION block(s) whose |
| 345 |
textual representation of the 4-byte ID is “abcd” or |
| 346 |
APPLICATION:0xXXXXXXXX for the APPLICATION block(s) whose hexadecimal |
| 347 |
big- endian representation of the 4-byte ID is “0xXXXXXXXX”. For the |
| 348 |
example “abcd” above the hexadecimal equivalalent is 0x61626364 |
| 349 |
</dd> |
| 350 |
<dt><strong>--application-data-format=hexdump|text</strong></dt> |
| 351 |
<dd> |
| 352 |
If the application block you are displaying contains binary data but |
| 353 |
your --data-format=text, you can display a hex dump of the application |
| 354 |
data contents instead using --application-data-format=hexdump. |
| 355 |
</dd> |
| 356 |
<dt><strong>--data-format=binary|binary-headerless|text</strong></dt> |
| 357 |
<dd> |
| 358 |
For use with --list. By default a human-readable text representation of |
| 359 |
the data is isplayed. You may specify --data-format=binary to dump the |
| 360 |
raw binary form of each metadata block. Specify |
| 361 |
--data-format=binary-headerless to omit output of metadata block |
| 362 |
headers, including the id of APPLICATION metadata blocks. |
| 363 |
</dd> |
| 364 |
<dt><strong>--append</strong></dt> |
| 365 |
<dd> |
| 366 |
Insert a metadata block from a file. This must be a binary block as |
| 367 |
exported with --list --data-format=binary. The insertion point is |
| 368 |
defined with --block-number=#. The new block will be added after the |
| 369 |
given block number. This prevents the illegal insertion of a block |
| 370 |
before the first STREAMINFO block. You may not --append another |
| 371 |
STREAMINFO block. It is possible to copy a metadata block from one file |
| 372 |
to another with this option. For example use |
| 373 |
<code>metaflac --list --data-format=binary --block-number=6 file.flac > block</code> |
| 374 |
to export the block, and then import it with |
| 375 |
<code>metaflac --append anotherfile.flac < block</code> |
| 376 |
</dd> |
| 377 |
<dt><strong>--remove-all</strong></dt> |
| 378 |
<dd> |
| 379 |
Remove all metadata blocks (except the STREAMINFO block) from the |
| 380 |
metadata. Unless --dont-use-padding is specified, the blocks will be |
| 381 |
replaced with padding. |
| 382 |
</dd> |
| 383 |
<dt><strong>--merge-padding</strong></dt> |
| 384 |
<dd> |
| 385 |
Merge adjacent PADDING blocks into single blocks. |
| 386 |
</dd> |
| 387 |
<dt><strong>--sort-padding</strong></dt> |
| 388 |
<dd> |
| 389 |
Move all PADDING blocks to the end of the metadata and merge them into a |
| 390 |
single block. |
| 391 |
</dd> |
| 392 |
</dl> |
| 393 |
<h1 id="see-also">SEE ALSO</h1> |
| 394 |
<p><strong>flac(1)</strong></p> |
| 395 |
<div class="copyright"> |
| 396 |
<hr /> |
| 397 |
Copyright (c) 2000-2009 Josh Coalson, 2011-2025 Xiph.Org Foundation |
| 398 |
</div> |
| 399 |
</div> |
| 400 |
</body> |
| 401 |
</html> |