402 lines
20 KiB
HTML
402 lines
20 KiB
HTML
|
<!DOCTYPE html>
|
|||
|
|
<html xmlns="http://www.w3.org/1999/xhtml" lang xml:lang>
|
|||
|
|
<head>
|
|||
|
|
<meta charset="utf-8" />
|
|||
|
|
<meta name="generator" content="pandoc" />
|
|||
|
|
<meta name="viewport" content="width=device-width, initial-scale=1.0, user-scalable=yes" />
|
|||
|
|
<title>metaflac(1) Version 1.5.0 | Free Lossless Audio Codec metadata tool</title>
|
|||
|
|
<style>
|
|||
|
|
code{white-space: pre-wrap;}
|
|||
|
|
span.smallcaps{font-variant: small-caps;}
|
|||
|
|
div.columns{display: flex; gap: min(4vw, 1.5em);}
|
|||
|
|
div.column{flex: auto; overflow-x: auto;}
|
|||
|
|
div.hanging-indent{margin-left: 1.5em; text-indent: -1.5em;}
|
|||
|
|
|
|||
|
|
ul.task-list[class]{list-style: none;}
|
|||
|
|
ul.task-list li input[type="checkbox"] {
|
|||
|
|
font-size: inherit;
|
|||
|
|
width: 0.8em;
|
|||
|
|
margin: 0 0.8em 0.2em -1.6em;
|
|||
|
|
vertical-align: middle;
|
|||
|
|
}
|
|||
|
|
.display.math{display: block; text-align: center; margin: 0.5rem auto;}
|
|||
|
|
</style>
|
|||
|
|
<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>
|
|||
|
|
</head>
|
|||
|
|
<body>
|
|||
|
|
<div class="logo">
|
|||
|
|
<img src="data:image/png;base64,
|
|||
|
|
iVBORw0KGgoAAAANSUhEUgAAAKEAAABQBAMAAACDsQg5AAAAMFBMVEUAAABTAgC1AAMkMh/7AABQ
|
|||
|
|
UQBbYFklgx8nnieiogCZm5i9wLzIysfY29f5+gD7/vuN5xJAAAAEtklEQVRYw92YP4vbPBjA9SKq
|
|||
|
|
wU5I+xX6CQyBDHcX0qEf4F26CwwenJjc1vWFd+n4rt0MhQzOhQsUPLgXEihkSHNcIJAhdyGF7qVQ
|
|||
|
|
uOGS4Nd/ZFmyZV+Sc4dWoER6LP2sP8/z6JEBKD69ePG8WOBfr1+/ynoGNVwkEVlr150VSEQez3V/
|
|||
|
|
BuWaPlg8mYhufKD7AIB85bPvn0y8DIDuBoBKUHgyUQ6B7q4wIhmi6yqHE4X6KEVAFx9BFKUGJY6O
|
|||
|
|
IL58+Zz799OQEmfHryO7nnBNiffFEBEFegpZCDHSHdeyOsUQQ4i7YCrFEJXiiI3IAgsjtiMvISLW
|
|||
|
|
tI6aouj+imcmWG2zEI6od8mWsa4YNkOho2QQeyviJVarO4Unxmq1jXtDag+bQPjs/fv/ohy2iNXb
|
|||
|
|
3SWIsb2T3pxXIUv/7Pv3r17+5uewhZtNlJlnkVc33IQwRUQ5xBLbG6eae8kUEKUcYoXtPE/Ombzm
|
|||
|
|
IGKD7bwRDPFBNOtSDrHNdVdSEs+dCoiVHCI/xb4nueEkfvu09rRziGuu/4zf/NjMsg4tIXHqaPqU
|
|||
|
|
euPkpPtC4k02Ed6GFn1CibSxpfXIpKN19HM462pVI55C09SEXSucK7mnO73xdfNkHTZK20zcIdOb
|
|||
|
|
SUQmc8peNo8nIiJr8AYJjiE2p1M7JrbZIR5FRJfhqkXEoUhnDiISzdqpRLZmDDxJ/LoPkerzJpQh
|
|||
|
|
oRZCz1ai/BiRNzlK3CNYzyAmTI4SwdHEdpIoCYnMOgY5h5gAuvNc4jd2v8VE0n/3ZVAUsUxPEqJE
|
|||
|
|
c/HO7E+MpYgn9o8lXkZDjIpz6OZo+B7EYbxoZUJaP2aF+cSg+5aJBOZRvI4zbSayGzGRCQFlcs7w
|
|||
|
|
3gwqh2k4ZFSlRIjkJN6Fg2yEHtc7BRQuP0LEcYMZjRaCsEoipwJ89+4fNj8y6+DGTW4ns+gt/plU
|
|||
|
|
1ddkrPsT1/R4PKPwy3RIcQAxuiB3unEEUBdEAPsTk67HJyYCqSAU2p9YFhBF096fKImIgsAnQTzP
|
|||
|
|
8Y9DATEpxAfoI91iniinouYDToX4kryLifyGBc3evPnbzyDKOWdhK+rYYYiImfcW5+zM7m4cE6NK
|
|||
|
|
L+y4RKynRTccUEzcdrQqvchuLVqBgbI8KMi9tTRV4aTei3CmXeckvet0RN/YvBTdPw8k7pF+E+I5
|
|||
|
|
m8GvSRotqalC/DEAcbVcIBrTop0q0NSU2ZoRz/rt23M2B1cBW8U1FfhfcW2kAb+o2FBTUCirqUhB
|
|||
|
|
QGuioBYKNcN/rpF1/De5M9L46sOnq9pk4hFbXdO5kK25Xe6OnO6p8xmAZU/GDcn5UkF+i089r6Hs
|
|||
|
|
rGTns3FhZhBR30EjuYUbHtGGPxZINhW7CxZjWDJVAHH9FDcquFkp4xaAPyTDrBtg0AL2AmUTbWl7
|
|||
|
|
bdxdK8Aeg/vWEg1N+3q6aD7AnmfMg4FHrAOPqNQBGoEKLjWBYUyXcwCyiWiEzrAUjPGneaZ7/12g
|
|||
|
|
4pIOHCD1y6e4XVHCMaJ4jOoC9bOIpg0mF7WJE67jste0xnbdGjkXTWcM0LKnT4aSdVuWHMdfR23i
|
|||
|
|
lJxVyfpodLNmDbEKTlSgezuJUQfUOlDHYSGQ6RrWNe8XBTUUCK0atBTUydKePz79Dy84W9TLWTUv
|
|||
|
|
AAAAAElFTkSuQmCC" alt="FLAC Logo" id="logo" />
|
|||
|
|
</div>
|
|||
|
|
|
|||
|
|
<div class="content">
|
|||
|
|
|
|||
|
|
|
|||
|
|
<header id="title-block-header">
|
|||
|
|
<h1 class="title">metaflac(1) Version 1.5.0 | Free Lossless Audio Codec
|
|||
|
|
metadata tool</h1>
|
|||
|
|
</header>
|
|||
|
|
<h1 id="name">NAME</h1>
|
|||
|
|
<p>metaflac - program to list, add, remove, or edit metadata in one or
|
|||
|
|
more FLAC files.</p>
|
|||
|
|
<h1 id="synopsis">SYNOPSIS</h1>
|
|||
|
|
<p><strong>metaflac</strong> [ <em>options</em> ] [ <em>operations</em>
|
|||
|
|
] <em>FLACfile …</em></p>
|
|||
|
|
<h1 id="description">DESCRIPTION</h1>
|
|||
|
|
<p>Use <strong>metaflac</strong> to list, add, remove, or edit metadata
|
|||
|
|
in one or more FLAC files. You may perform one major operation, or many
|
|||
|
|
shorthand operations at a time.</p>
|
|||
|
|
<h1 id="general-usage">GENERAL USAGE</h1>
|
|||
|
|
<p>metaflac is the command-line .flac file metadata editor. You can use
|
|||
|
|
it to list the contents of metadata blocks, edit, delete or insert
|
|||
|
|
blocks, and manage padding.</p>
|
|||
|
|
<p>metaflac takes a set of “options” (though some are not optional) and
|
|||
|
|
a set of FLAC files to operate on. There are three kinds of
|
|||
|
|
“options”:</p>
|
|||
|
|
<ul>
|
|||
|
|
<li><p>Major operations, which specify a mode of operation like listing
|
|||
|
|
blocks, removing blocks, etc. These will have sub-operations describing
|
|||
|
|
exactly what is to be done.</p></li>
|
|||
|
|
<li><p>Shorthand operations, which are convenient synonyms for major
|
|||
|
|
operations. For example, there is a shorthand operation
|
|||
|
|
--show-sample-rate that shows just the sample rate field from the
|
|||
|
|
STREAMINFO metadata block.</p></li>
|
|||
|
|
<li><p>Global options, which affect all the operations.</p></li>
|
|||
|
|
</ul>
|
|||
|
|
<p>All of these are described in the tables below. At least one
|
|||
|
|
shorthand or major operation must be supplied. You can use multiple
|
|||
|
|
shorthand operations to do more than one thing to a file or set of
|
|||
|
|
files. Most of the common things to do to metadata have shorthand
|
|||
|
|
operations. As an example, here is how to show the MD5 signatures for a
|
|||
|
|
set of three FLAC files:</p>
|
|||
|
|
<p><code>metaflac --show-md5sum file1.flac file2.flac file3.flac</code></p>
|
|||
|
|
<p>Another example; this removes all DESCRIPTION and COMMENT tags in a
|
|||
|
|
set of FLAC files, and uses the --preserve-modtime global option to keep
|
|||
|
|
the FLAC file modification times the same (usually when files are edited
|
|||
|
|
the modification time is set to the current time):</p>
|
|||
|
|
<p><code>metaflac --preserve-modtime --remove-tag=DESCRIPTION --remove-tag=COMMENT file1.flac file2.flac file3.flac</code></p>
|
|||
|
|
<h1 id="options">OPTIONS</h1>
|
|||
|
|
<dl>
|
|||
|
|
<dt><strong>-o</strong> <em>filename</em><strong>,
|
|||
|
|
--output-name=</strong><em>filename</em></dt>
|
|||
|
|
<dd>
|
|||
|
|
Output to a new file instead of changing or rewriting the input file.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--preserve-modtime</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Preserve the original modification time in spite of edits. This does
|
|||
|
|
nothing when -o or –output-name are specified.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--with-filename</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Prefix each output line with the FLAC file name (the default if more
|
|||
|
|
than one FLAC file is specified). This option has no effect for options
|
|||
|
|
exporting to a file, like --export-tags-to.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--no-filename</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Do not prefix each output line with the FLAC file name (the default if
|
|||
|
|
only one FLAC file is specified).
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--no-utf8-convert</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Do not convert tags from UTF-8 to local charset, or vice versa. This is
|
|||
|
|
useful for scripts, and setting tags in situations where the locale is
|
|||
|
|
wrong.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--dont-use-padding</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
By default metaflac tries to use padding where possible to avoid
|
|||
|
|
rewriting the entire file if the metadata size changes. Use this option
|
|||
|
|
to tell metaflac to not take advantage of padding this way.
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<h1 id="shorthand-operations">SHORTHAND OPERATIONS</h1>
|
|||
|
|
<dl>
|
|||
|
|
<dt><strong>--show-md5sum</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the MD5 signature from the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-min-blocksize</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the minimum block size from the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-max-blocksize</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the maximum block size from the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-min-framesize</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the minimum frame size from the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-max-framesize</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the maximum frame size from the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-sample-rate</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the sample rate from the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-channels</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the number of channels from the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-bps</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the # of bits per sample from the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-total-samples</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the total # of samples from the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-vendor-tag</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show the vendor string from the VORBIS_COMMENT block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-tag=name</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show all tags where the field name matches ‘name’.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--show-all-tags</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Show all tags. This is an alias for --export-tags-to=-.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--remove-tag=name</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Remove all tags whose field name is ‘name’.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--remove-first-tag=name</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Remove first tag whose field name is ‘name’.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--remove-all-tags</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Remove all tags, leaving only the vendor string.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--remove-all-tags-except=NAME1[=NAME2[=…]]</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Remove all tags, except the vendor string and the tag names specified.
|
|||
|
|
Tag names must be separated by an = character.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--set-tag=field</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Add a tag. The field must comply with the Vorbis comment spec, of the
|
|||
|
|
form “NAME=VALUE”. If there is currently no tag block, one will be
|
|||
|
|
created.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--set-tag-from-file=field</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Like --set-tag, except the VALUE is a filename whose contents will be
|
|||
|
|
read verbatim to set the tag value. Unless --no-utf8-convert is
|
|||
|
|
specified, the contents will be converted to UTF-8 from the local
|
|||
|
|
charset. This can be used to store a cuesheet in a tag (e.g.
|
|||
|
|
--set-tag-from-file=“CUESHEET=image.cue”). Do not try to store binary
|
|||
|
|
data in tag fields! Use APPLICATION blocks for that.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--import-tags-from=file</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Import tags from a file. Use ‘-’ for stdin. Each line should be of the
|
|||
|
|
form NAME=VALUE. Multi-line comments are currently not supported.
|
|||
|
|
Specify --remove-all-tags and/or --no-utf8-convert before
|
|||
|
|
--import-tags-from if necessary. If FILE is ‘-’ (stdin), only one FLAC
|
|||
|
|
file may be specified.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--export-tags-to=file</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Export tags to a file. Use ‘-’ for stdout. Each line will be of the form
|
|||
|
|
NAME=VALUE. Specify --no-utf8-convert if necessary.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--import-cuesheet-from=file</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Import a cuesheet from a file. Use ‘-’ for stdin. Only one FLAC file may
|
|||
|
|
be specified. A seekpoint will be added for each index point in the
|
|||
|
|
cuesheet to the SEEKTABLE unless --no-cued-seekpoints is specified.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--export-cuesheet-to=file</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Export CUESHEET block to a cuesheet file, suitable for use by CD
|
|||
|
|
authoring software. Use ‘-’ for stdout. Only one FLAC file may be
|
|||
|
|
specified on the command line.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--import-picture-from={</strong><em>FILENAME</em><strong>|</strong><em>SPECIFICATION</em><strong>}</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Import a picture and store it in a PICTURE metadata block. More than one
|
|||
|
|
--import-picture-from command can be specified. Either a filename for
|
|||
|
|
the picture file or a more complete specification form can be used. The
|
|||
|
|
SPECIFICATION is a string whose parts are separated by | (pipe)
|
|||
|
|
characters. Some parts may be left empty to invoke default values.
|
|||
|
|
FILENAME is just shorthand for “||||FILENAME”. For details on the
|
|||
|
|
specification, see the section <strong>Picture specification</strong> in
|
|||
|
|
the <strong>flac(1)</strong> man page.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--export-picture-to=file</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Export PICTURE block to a file. Use ‘-’ for stdout. Only one FLAC file
|
|||
|
|
may be specified on the command line. The first PICTURE block will be
|
|||
|
|
exported unless --export-picture-to is preceded by a --block-number=#
|
|||
|
|
option to specify the exact metadata block to extract. Note that the
|
|||
|
|
block number is the one shown by --list.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--add-replay-gain</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Calculates the title and album gains/peaks of the given FLAC files as if
|
|||
|
|
all the files were part of one album, then stores them as FLAC tags. The
|
|||
|
|
tags are the same as those used by vorbisgain. Existing ReplayGain tags
|
|||
|
|
will be replaced. If only one FLAC file is given, the album and title
|
|||
|
|
gains will be the same. Since this operation requires two passes, it is
|
|||
|
|
always executed last, after all other operations have been completed and
|
|||
|
|
written to disk. All FLAC files specified must have the same resolution,
|
|||
|
|
sample rate, and number of channels. Only mono and stereo files are
|
|||
|
|
allowed, and the sample rate must be 8, 11.025, 12, 16, 18.9, 22.05, 24,
|
|||
|
|
28, 32, 36, 37.8, 44.1, 48, 56, 64, 72, 75.6, 88.2, 96, 112, 128, 144,
|
|||
|
|
151.2, 176.4, 192, 224, 256, 288, 302.4, 352.8, 384, 448, 512, 576, or
|
|||
|
|
604.8 kHz.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--scan-replay-gain</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Like --add-replay-gain, but only analyzes the files rather than writing
|
|||
|
|
them to the tags.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--remove-replay-gain</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Removes the ReplayGain tags.
|
|||
|
|
</dd>
|
|||
|
|
<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>
|
|||
|
|
<dd>
|
|||
|
|
Add seek points to a SEEKTABLE block. Using #, a seek point at that
|
|||
|
|
sample number is added. Using X, a placeholder point is added at the end
|
|||
|
|
of a the table. Using #x, # evenly spaced seek points will be added, the
|
|||
|
|
first being at sample 0. Using #s, a seekpoint will be added every #
|
|||
|
|
seconds (# does not have to be a whole number; it can be, for example,
|
|||
|
|
9.5, meaning a seekpoint every 9.5 seconds). If no SEEKTABLE block
|
|||
|
|
exists, one will be created. If one already exists, points will be added
|
|||
|
|
to the existing table, and any duplicates will be turned into
|
|||
|
|
placeholder points. You may use many --add-seekpoint options; the
|
|||
|
|
resulting SEEKTABLE will be the unique-ified union of all such values.
|
|||
|
|
Example: --add-seekpoint=100x --add-seekpoint=3.5s will add 100 evenly
|
|||
|
|
spaced seekpoints and a seekpoint every 3.5 seconds.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--add-padding=length</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Add a padding block of the given length (in bytes). The overall length
|
|||
|
|
of the new block will be 4 + length; the extra 4 bytes is for the
|
|||
|
|
metadata block header.
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<h1 id="major-operations">MAJOR OPERATIONS</h1>
|
|||
|
|
<dl>
|
|||
|
|
<dt><strong>--list</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
List the contents of one or more metadata blocks to stdout. By default,
|
|||
|
|
all metadata blocks are listed in text format. Use the options
|
|||
|
|
<strong>--block-number</strong>, <strong>--block-type</strong> or
|
|||
|
|
<strong>--except-block-type</strong> to change this behavior.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--remove</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Remove one or more metadata blocks from the metadata. Use the options
|
|||
|
|
<strong>--block-number</strong>, <strong>--block-type</strong> or
|
|||
|
|
<strong>--except-block-type</strong> to specify which blocks should be
|
|||
|
|
removed. Note that if both --block-number and --[except-]block-type are
|
|||
|
|
specified, the result is the logical AND of both arguments. Unless
|
|||
|
|
--dont-use-padding is specified, the blocks will be replaced with
|
|||
|
|
padding. You may not remove the STREAMINFO block.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--block-number=#[,#[…]]</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
An optional comma-separated list of block numbers to display. The first
|
|||
|
|
block, the STREAMINFO block, is block 0.
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<p><strong>--block-type=type[,type[…]]</strong></p>
|
|||
|
|
<dl>
|
|||
|
|
<dt><strong>--except-block-type=type[,type[…]]</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
An optional comma-separated list of block types to be included or
|
|||
|
|
ignored with this option. Use only one of --block-type or
|
|||
|
|
--except-block-type. The valid block types are: STREAMINFO, PADDING,
|
|||
|
|
APPLICATION, SEEKTABLE, VORBIS_COMMENT, PICTURE. You may narrow down the
|
|||
|
|
types of APPLICATION blocks selected by appending APPLICATION with a
|
|||
|
|
colon and the ID of the APPLICATION block in either ASCII or hexadecimal
|
|||
|
|
representation. E.g. APPLICATION:abcd for the APPLICATION block(s) whose
|
|||
|
|
textual representation of the 4-byte ID is “abcd” or
|
|||
|
|
APPLICATION:0xXXXXXXXX for the APPLICATION block(s) whose hexadecimal
|
|||
|
|
big- endian representation of the 4-byte ID is “0xXXXXXXXX”. For the
|
|||
|
|
example “abcd” above the hexadecimal equivalalent is 0x61626364
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--application-data-format=hexdump|text</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
If the application block you are displaying contains binary data but
|
|||
|
|
your --data-format=text, you can display a hex dump of the application
|
|||
|
|
data contents instead using --application-data-format=hexdump.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--data-format=binary|binary-headerless|text</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
For use with --list. By default a human-readable text representation of
|
|||
|
|
the data is isplayed. You may specify --data-format=binary to dump the
|
|||
|
|
raw binary form of each metadata block. Specify
|
|||
|
|
--data-format=binary-headerless to omit output of metadata block
|
|||
|
|
headers, including the id of APPLICATION metadata blocks.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--append</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Insert a metadata block from a file. This must be a binary block as
|
|||
|
|
exported with --list --data-format=binary. The insertion point is
|
|||
|
|
defined with --block-number=#. The new block will be added after the
|
|||
|
|
given block number. This prevents the illegal insertion of a block
|
|||
|
|
before the first STREAMINFO block. You may not --append another
|
|||
|
|
STREAMINFO block. It is possible to copy a metadata block from one file
|
|||
|
|
to another with this option. For example use
|
|||
|
|
<code>metaflac --list --data-format=binary --block-number=6 file.flac > block</code>
|
|||
|
|
to export the block, and then import it with
|
|||
|
|
<code>metaflac --append anotherfile.flac < block</code>
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--remove-all</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Remove all metadata blocks (except the STREAMINFO block) from the
|
|||
|
|
metadata. Unless --dont-use-padding is specified, the blocks will be
|
|||
|
|
replaced with padding.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--merge-padding</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Merge adjacent PADDING blocks into single blocks.
|
|||
|
|
</dd>
|
|||
|
|
<dt><strong>--sort-padding</strong></dt>
|
|||
|
|
<dd>
|
|||
|
|
Move all PADDING blocks to the end of the metadata and merge them into a
|
|||
|
|
single block.
|
|||
|
|
</dd>
|
|||
|
|
</dl>
|
|||
|
|
<h1 id="see-also">SEE ALSO</h1>
|
|||
|
|
<p><strong>flac(1)</strong></p>
|
|||
|
|
<div class="copyright">
|
|||
|
|
<hr />
|
|||
|
|
Copyright (c) 2000-2009 Josh Coalson, 2011-2025 Xiph.Org Foundation
|
|||
|
|
</div>
|
|||
|
|
</div>
|
|||
|
|
</body>
|
|||
|
|
</html>
|