mp3ql.home
home
about
news
features
manual
project
download
screenshots
 
SourceForge.net Logo

Tag Editor

mp3ql Manual » Windows

Introduction

One of the more advanced features of mp3ql is the Tag Editor. Its primary function is to aid the naming of id3 tags, be it single or multiple files. In order to grasp a full understanding and benefit from it's capabilities it is well worth studying this page ... once the basic ideas have been absorbed there are few limits on what can be achieved, and the often long and tiring process of naming multiple files will be drastically shortened.


Basic Usage

In order to edit tags you must initially select one or multiple files using the view of your choice, which can be one of detail view, icon view or playlist view. The tag editor will load the values of the selected files into the available fields:

  • Artist
  • Album
  • Title
  • Track
  • Total
  • Comment
  • Genre
  • Year
  • Image

In order to change a particular value just type into the corresponding text field. The check box above the text field will be activated automatically to indicate that you changed it's value. Not every field has to be used, they can simply be left unchanged as desired.

Image Icon To embed an album image into a tag, first select the image box button. A square area will appear to the left of the tag value fields. Simply drag or paste an image into the box. If the desired image isn't already copied into your clipboard or you choose to set the image by drag and drop, you have to click the lock button first:

Padlock Icon If the lock is activated, the tag editor's file selection won't change when you browse in the file views. After unlocking, the initial selection will be restored in the file views.

Green Tick Once done, simply click on the green tick and your changes will be applied to all selected files.

Cross IconTo abandon all your changes and collapse the tag editor press the close button.


Notes

Any image format supported by your Qt installation may be used for the image tag. Those normally include PNG, BMP, XBM, XPM and PNM. It may also support JPEG, MNG and GIF

Advanced Usage

To switch to advanced mode click on the mp3ql icon (mp3ql icon), now you will see a secondary field next to all the primary fields (including a Path and File field) which can be activated and deactivated using the smaller mp3ql icons. The secondary fields are used to specify the format of the primary fields using the following escape sequences:

  • %i = Artist
  • %a = Album
  • %t = Title
  • %n = Track Number
  • %c = Comment
Here is an example, let's say your files are named in this format - john doe - the unidentified man - 01 - they don't know who i am.mp3 - we break this down into smaller parts that mp3ql can understand:
  • john doe = Artist
  • the unidentified man = Album
  • 01 = Track Number
  • they don't know who i am = Title
Now we know what the title consists of we need to find out the corresponding escape sequence, in this case: %i - %a - %n - %t, remember to specify the hyphens. So now we have our escape sequence we need to give this to mp3ql, because we are taking this information from the File name we click on the File mp3ql icon and type the escape sequence into there, this tells mp3ql where to extract the information from, then press TAB, and you will notice the relevant fields now have the corresponding character inside them...this way you can check that everything is correct by referring to the list above. If you would like to save the escape sequence for later use press ENTER and you will now see that it is in the drop down list. Now that we have specified the information required all that remains is to press the green tick icon (Green Tick), and you should now see that these details have been written to the tag.

The above process can be used for any of the fields (except for Total, Genre and Year). The rule of the process is that you must first specify to mp3ql the format of the details in order to extract them. As you can hopefully now see, there are many ways this process can be used to speed up the naming of tags.

Limitations

Currently, mp3ql is not able to read or modify ID3 tags of version 2.2. If you encounter such files you have to delete the tags or upgrade them to V2.3 or V2.4 with an external tool. The same might happen ocasionally for files with invalid ID3 Tag frames.



Detail View :: Doc View :: Icon View :: Playlist View :: Shelf :: Tag Editor :: Tree View