cannam@86:
cannam@86: |
cannam@86: Shorthand Operations
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-md5sum
cannam@86: |
cannam@86:
cannam@86: Show the MD5 signature from the STREAMINFO block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-min-blocksize
cannam@86: |
cannam@86:
cannam@86: Show the minimum block size from the STREAMINFO block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-max-blocksize
cannam@86: |
cannam@86:
cannam@86: Show the maximum block size from the STREAMINFO block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-min-framesize
cannam@86: |
cannam@86:
cannam@86: Show the minimum frame size from the STREAMINFO block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-max-framesize
cannam@86: |
cannam@86:
cannam@86: Show the maximum frame size from the STREAMINFO block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-sample-rate
cannam@86: |
cannam@86:
cannam@86: Show the sample rate from the STREAMINFO block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-channels
cannam@86: |
cannam@86:
cannam@86: Show the number of channels from the STREAMINFO block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-bps
cannam@86: |
cannam@86:
cannam@86: Show the # of bits per sample from the STREAMINFO block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-total-samples
cannam@86: |
cannam@86:
cannam@86: Show the total # of samples from the STREAMINFO block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-vendor-tag
cannam@86: |
cannam@86:
cannam@86: Show the vendor string from the VORBIS_COMMENT block.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --show-tag=NAME
cannam@86: |
cannam@86:
cannam@86: Show all tags where the the field name matches NAME.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --remove-tag=NAME
cannam@86: |
cannam@86:
cannam@86: Remove all tags whose field name is NAME.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --remove-first-tag=NAME
cannam@86: |
cannam@86:
cannam@86: Remove first tag whose field name is NAME.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --remove-all-tags
cannam@86: |
cannam@86:
cannam@86: Remove all tags, leaving only the vendor string.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --set-tag=FIELD
cannam@86: |
cannam@86:
cannam@86: 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.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --set-tag-from-file=FIELD
cannam@86: |
cannam@86:
cannam@86: 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.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --import-tags-from=FILE
cannam@86: |
cannam@86:
cannam@86: 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.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --export-tags-to=FILE
cannam@86: |
cannam@86:
cannam@86: Export tags to a file. Use - for stdin. Each line will be of the form NAME=VALUE. Specify --no-utf8-convert if necessary.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --import-cuesheet-from=FILE
cannam@86: |
cannam@86:
cannam@86: 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.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --export-cuesheet-to=FILE
cannam@86: |
cannam@86:
cannam@86: 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.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --import-picture-from={FILENAME|SPECIFICATION}
cannam@86: |
cannam@86:
cannam@86: Import a picture and store it in a PICTURE metadata block. See the flac option --picture for an explanation of the SPECIFICATION syntax.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --export-picture-to=FILE
cannam@86: |
cannam@86:
cannam@86: 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.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --add-replay-gain
cannam@86: |
cannam@86:
cannam@86: 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. The sample rate must be one of 8, 11.025, 12, 16, 22.05, 24, 32, 44.1, or 48 kHz.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --remove-replay-gain
cannam@86: |
cannam@86:
cannam@86: Removes the ReplayGain tags.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --add-seekpoint={#|X|#x|#s}
cannam@86: |
cannam@86:
cannam@86: Add seek points to a SEEKTABLE block:
cannam@86:
cannam@86: -
cannam@86: # : a specific sample number for a seek point
cannam@86:
cannam@86: -
cannam@86: X : a placeholder point (always goes at the end of the SEEKTABLE)
cannam@86:
cannam@86: -
cannam@86: #x : # evenly spaced seekpoints, the first being at sample 0
cannam@86:
cannam@86: -
cannam@86: #s : a seekpoint every # seconds; # does not have to be a whole number, it can be, for example, 9.5, meaning a seekpoint every 9.5 seconds
cannam@86:
cannam@86:
cannam@86: 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.
cannam@86: 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.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: |
cannam@86:
cannam@86: --add-padding=#
cannam@86: |
cannam@86:
cannam@86: 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.
cannam@86: |
cannam@86:
cannam@86:
cannam@86: 
cannam@86: 