Placeholders

 

 

Placeholders are strings of special type which designate tag fields or file parameters. They help significantly to automate editing of tags. Each time you assign any string to a field TagJet scans it and substitutes all met placeholders for values of fields associated with them.

For example, you want to assign the Title to the Filename. In this case you just need to type the placeholder %T (it designates the Title) to the Filename field in the table and the value is assigned. Of course this can be done using Copy/Paste. But if you need to perform this operation for 30 files then it is inefficiently to use Copy/Paste. While you can select all the desired fields, write %T only once and get the desired result very quickly. As you can see placeholders allow you to save a lot of time.

Placeholders are valid only within a single file. This means that if you write the placeholder %T to the Filename field of the first file from the table then theTitle can be read only from the tag of this first file.It is impossible to read a field from another file using a placeholder.

Placeholders are also valid only within the current tag mode. This means that if you are working in ID3v2 tag mode and using the placeholder %T, then the title will be read exactly from the ID3v2 tag. It is impossible to read a field from another tag using a placeholder.

Placeholder always starts with % (percent) character followed by its name. If the name consists of more than one character then it must be followed by closing % character. If the placeholder with the specified name does not exist then the substitution is not performed.Many of the placeholders have long and short notations for the convenience. Which notation to use depends on your preferences.

 

 

List of all placeholders

Long notation

Short notation

Description

%title%

%T

Title

%artist%

%A

Artist

%album%

%L

Album

%year%

%Y

Year

%genre%

%G

Genre

%track%

%T

Track

%comment%

%C

Comment

%filename%

%F

File name

%dir%

%D

Directory that contains file

 

%duration%

%dr%

Duration of audio in the file

%bitrate%

%br%

Bit rate of audio in the file

%mode%

 

Mode of audio in the file: mono, stereo, joint stereo

%frequency%

%freq%

Frequency of audio in the file

%filesize%

%fs%

Size of the file on a drive.

 

%orig_filename%

%of%

Original filename.

%bpm%

 

Beats per minute.

%content_group%

%cg%

Content group

%subtitle%

%st%

Subtitle

%band%

 

Band/Orchestra

%conductor%

 

Conductor

%remixed_by%

 

Interpreted or remixed by

%orig_artist%

%oa%

Original artist

%composer%

%co%

Composer

%Orig_album%

%ol% or oalb%

Original album/movie/show.

%orig_year%

%oy%

Original release year.

%writer%

 

Text writer.

%orig_writer%

 

Original text writer.

%encoded_by%

 

Encoded by.

%publisher%

 

Publisher.

%copyright%

 

Copyright.

%file_owner%

 

File owner.

 

 

%web_file%

 

Official audio file web page.

%web_artist%

 

Official artist web page.

%web_source%

 

Official audio source web page.

%web_com%

 

Commercial info.

%web_copyright%

 

Copyright info.

%web_publisher%

 

Publisher’s official webpage.

%web_payment%

 

A web page where you can pay for the file.

%#

 

The number of a row (file) in the table.

%_

 

To skip a part of a filename that you do not want to assign to any tag field. It is used in "Tags by filenames" window only.

 

In placeholders %R and %# you can use one digit after the % which defines the minimum number of symbols in the return valued. All blank positions are filled with 0.

For example: %3R produces output like 004.

 

You can use placeholders everywhere it the program where it makes sense, notably:

  • Tags table.
  • "Tag" window.
  • "Editor" window.
  • "Rename files" window. Rename patterns are composed from placeholders.
  • "Tags by filenames" window. Patterns are composed from placeholders, which are used to divide into parts filenames and to put down these parts to corresponding tag fields.
  • "Find and replace" dialog. Placeholders can be used in "Replace with" edit line.

 

 

Example 1:

You have a folder with the name Unbreakable (it is the name of the album) opened. And you want to enter the value Unbreakable to the Album field of all tags.

To do this, make a left click on one of the Album columns cell to relocate there the cell cursor. Select the entire Album column, type %D, and press Enter.

The same operation can be performed in the Editor window. You should enter %D value in the Album field and press the Apply button.

 

 

Example 2:

You have:

Filename = Track 1.mp3

Title = Deep dive

Artist = Mike

You want to get:

Filename = Mike - Deep dive.mp3

To do this, make a left click on a cell with a desired name in the table to relocate there the cell cursor. And then enter "%A - %T" value.

 

 

Example 3:

You have:

Filename = Track 1.mp3

Title = Deep dive

Track = 1

You want to get:

Filename = 1 - Deep dive.mp3

To do this, make a left click on a cell with a desired name in the table to relocate there the cell cursor. And then enter "%R - %T" value.

 

 

Example 4:

You have:

Filename = 1 - Deep dive.mp3

You want to get:

Filename = 01 - Deep dive.mp3

To do this, make a left click on a cell with a desired name in the table to relocate there the cell cursor. And then enter "%0F" value.

 

 

Example 5:

You want to swap Album and Artist field values for all tags from the table.

To do this, open the Editor window. Enter "%A" value to the Album field and enter "%L" value to the Artist field. Click the Apply button.

 

 

Example 6:

You have the value "no title" in the Title field of some tags. At the same time the filename contains the correct title. You want to write the file name only to the fields with the value "no title".
To do this, open "Find and Replace" dialog. Enter "no title" to the "Find what" edit line and enter "%F" to the "Replace with" edit line. Click the "Replace All" button.

 

 

Example 7:

You want to add prefix "Dj " to values in the Artist fields of all tags.

To do this, make a left click on one of the Artist columns cell to relocate there the cell cursor. Select the entire Artist column, type "Dj %A", and press Enter.

The same operation can be performed in the Editor window. You should enter "Dj %A" value in the Artist field and press the Apply button.