IdEst – ID3 Editing and Scripting Tool (split by chapter):   Section:   Chapter:FastBack: Backups   Up: Top   FastForward: Reporting Bugs   Contents: Table of ContentsIndex: Concept Index

12 Invocation Summary

This chapter summarizes all available command line options. Options are listed in alphabetical order. Optional arguments are enclosed in square brackets.

-a
--all

Query all frames. See all-frames query.

--backup[=control]

backup before modifying, choose version control. See Backups.

--backup-directory=dir

Backup to given directory. See Backups.

--backup-suffix=suf

Set backup suffix, instead of the default ‘~’. See Backups.

--broken-8bit-encoding=charset

Textual frames are stored as ‘ISO-8859-1’ strings, but are actually using the specified 8bit charset. Use this option to properly convert such frames (see broken 8bit encoding), or to fix them (see fixing broken 8bit strings).

-C version
--convert=version

Create tags in given version, and convert existing ones to version. Argument is a comma-separated list of major version numbers. See ID Versioning.

-c file
--copy=file

Copy tags from file to destination files. See Copy.

--charset=name

In query mode – convert textual strings to character set name on output.

In modify mode – input strings are written using character set name.

By default, character set is deduced from the locale settings in both cases.

-d[flist]
--delete[=flist]

Delete ID3 tags. The flist is a comma-separated list of the names of frames to delete. If flist is not given, all frames are deleted. See Delete.

-D
--describe

Print verbose frame descriptions instead of short names. See describe.

--encoding=name

Specifies encoding for storing textual fields in ID3 tags. Valid only in modify mode. Valid encoding names are:

iso-8859-1
latin1
utf-8

This is the default.

utf-16

UTF-16, little-endian

utf-16be

UTF-16, big-endian

-F flist
--filter=flist

Operate only on frames from flist. This option affects the following options: --copy (see filter in copy mode), --query (see filter in query mode), --delete (see filter in delete mode) and --list-frames (see filter--list-frames).

--fixup

Attempt to fix the ID tags so that they are understood by most devices.

-h
--help

Print a short help list.

-i
--info

Show tag structure information. See Structure.

--latin1

Same as --encoding=latin1.

-L
--list-frames

List the supported ID3v2 frames. See list-frames.

-P path
--load-path=path

Append path to the Guile load path (see load-path). The argument is a list of directory names separated by colons.

-p path
--prepend-load-path=path

Add path to the beginning of the Guile load path (see load-path). The argument is a list of directory names separated by colons.

-N
--no-init-files

Do not load Scheme init files (see startup files).

-n
--dry-run

Initiate the dry-run mode. See dry-run.

-q[flist]
--query[=flist]

Query mode. The flist is a comma-separated list of the names of frames to query. If not given, it defaults to ‘title,album,track,comment,artist,year,genre’. See View.

-S file
--script=file

Guile script name. See Scripting.

-s field=value
--set=field=value

Set field ID3 field to the given value. See Modify.

--trace[=level]

Start with debugging evaluator and backtraces. See Scripting.

-V version
--id-version=version

Write new and changed tags in the given ID3 version. Argument is a comma-separated list of major version numbers. See ID Versioning.

-U version
--default-id-version=version

Create new tags in the given version. Argument is a comma-separated list of major version numbers. See ID Versioning.

--version

Print program version and copyright information.

--usage

Print a short usage message.

IdEst – ID3 Editing and Scripting Tool (split by chapter):   Section:   Chapter:FastBack: Backups   Up: Top   FastForward: Reporting Bugs   Contents: Table of ContentsIndex: Concept Index