Export

Settings
Description of the export configuration file format
Placeholders for export configurations
Global placeholders used in export configurations
Built in scripting commands

Settings

The list shows the available export configurations. You can activate an export configuration by selecting it. This export configuration will be used when running the export command.

You can create a new export configuration by pressing the New configuration button.

You can edit the selected export configuration by pressing the Edit configuration button.

You can delete the selected export configuration by pressing the Delete configuration button.

Export file name

You can enter the filename of the export file here. If the filename contains some placeholders, Mp3tag will replace them with the specific data at runtime.

Directory of export configurations

Specify the directory of export configurations here.

Append data

Enable this option, if you want Mp3tag to append data at an existing export file.

One file per directory

If this option is enabled, Mp3tag creates one export file for each directory.

Show selection dialog

If this option is enabled, Mp3tag shows a dialog with the available export configurations at Export.

Don't create directories

Since you can also use relative and absolute file paths as export file names - e.g. %artist%\%album%.html - this option prevents Mp3tag from creating any directories during the export process.

Write BOM

Mp3tag exports data in Unicode format encoded as UTF-8 by default. This option enables writing of a Byte Order Marker which is required by some applications.

Back to main page

Export configurations

You can specify any text, any of the many placeholders below and instructions for loops in your export configuration.

You can set the filename of the exported file with the function $filename(name[,enc]). The optional second parameter sets the encoding of the export file. Possible values are ansi, utf-8 and utf-16.

$filename(test.txt)
$filename(test.txt,ansi)
$filename(test.txt,utf-8)
$filename(test.txt,utf-16)


$loop(%fieldname%) starts a new loop. The loop data is sorted by the fieldname.
$loopend() ends a loop.
If you want to limit the loop to a certain number of entries per loop partition, simply use $loop(%fieldname%,num). This is useful to eliminate duplicate records (num=1).

Back to main page

Placeholders for export configurations

You can use these placeholders within the export configurations and the filename of the export file:

Metadata
%artist%	Artist
%album%	Album
%comment%	Comment
%genre%	Genre
%title%	Title
%track%	Track-Number
%_total%	Total number of tracks from xx/XX track-number field
%year%	Year
%fieldname%	Fieldname
Technical info
%_bitrate%	Bitrate
%_codec%	Codec
%_length%	Length (formatted)
%_length_seconds%	Length (in seconds)
%_mode%	Mode
%_samplerate%	Samplerate
%_tag%	Available tag types in file
%_tag_read%	Displayed tag type
%_tag_size%	Size of all tags in bytes
%_tag_size_appended%	Size of all appended tags in bytes
%_tag_size_prepended%	Size of all prepended tags in bytes
%_vbr%	VBR
File name / path info
%_crc%	CRC32 value of file content
%_directory%	Directory name
%_extension%	File extension without dot
%_filename%	File name without extension
%_filename_ext%	File name with extension
%_filename_rel%	Relative file name
%_file_mod_date%	Short modification date
%_file_mod_datetime%	Long modification date
%_file_size%	File size in human readable format
%_file_size_bytes%	File size in bytes
%_file_size_kb%	File size in kilobytes
%_file_size_mb%	File size in megabytes
%_path%	File name with path
%_folderpath%	Path without file name
%_folderpath_rel%	Relative path without file name
%_parent_directory%	Name of parent directory
%_md5%	MD5-Hash of the file (slow!)
%_md5audio%	MD5-Hash of the audio part of the file (slow!)
%_volume%	Volume label
%_workingdir%	Name of current working directory
%_workingpath%	Path of current working directory
System
%_app%	Mp3tag, e.g. Mp3tag v2.38
%_counter%	Counter for files per loop
%_date%	Short date
%_datetime%	Long date
%_max_counter%	Maximum value of counter of the last closed loop.
Global placeholders (calculated per loop)
%_total_files%	Total number of files
%_total_size%	Total file size (formatted output)
%_total_size_raw%	Total file size in bytes
%_total_time%	Total playing time (formatted output)
%_total_time2%	Total playing time (formatted output without days)
%_total_time_raw%	Total playing time in seconds

Back to main page