IdEst
	ID3 Editing and Scripting Tool	Sergey Poznyakoff

• Main
• Downloads
• Documentation

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.