# mtag

EN: mtag is the command-line tool for media files tagging. It can use the text file template to tag the multiply sets of media files. You can apply the same template for Ogg, MP3, and FLAC album versions. mtag can also extract the tags to the text file and rename files according to their tags.

RU: mtag это утилита для записи тэгов в мультимедийные файлы. mtag использует файл-шаблон с тэгами, который можно применять к нескольким наборам файлов в разных форматах. Иначе говоря, одним шаблоном вы запишете тэги в варианты альбома в MP3, Ogg, FLAC. mtag также умеет извлекать тэги из файлов (в шаблон) и переименовывать файлы на основе записанных в них тэгов.


Usage/Использование:
------------

EN:

1. To tag some files, use the command line:

mtag apply rules_file extension

Example: mtag apply rules.txt flac

To be tagged correctly, the media files names needs to be named in the alphabetical order, i.e. for example:

01-first-song.flac
01-second-song.flac
01-third-song.flac

The rules file must be in UTF-8 encoding. The rules file syntax is simple - the set of blocks with tags. Each block is ended with "###". Example:

@album=testalbum
@artist=SomeRocker
@title=song one
###
@album=testalbum
@artist=SomeRocker
@title=song two
###
@album=testalbum
@artist=SomeRocker
@title=song three
###

So the first block will be applied to the first media file at the current directory, the second block to the second file, etc. 

The list of available tags: @artist, @title, @album, @genre, @comment, @year, @track.

The #filename tag in block is ignored, it is needed just to understand which media file tags you edit now. Only the file order in directory and block order in rules file matters, not the #filename tag.


2. To extract the tags from the media files to the rules file, use the "extract" option:

mtag extract OUTPUTFILE extension [<list of required tags>]

For example:

mtag extract RULES ogg 

or

mtag extract RULES mp3 "@artist,@genre,@album"

<list of required tags> is an optional parameter, it defines which tags will be generated even if such data is not presented in source media file, blank values will be used.


3. To rename files according their tags, use:

mtag rename "template string" extension

The template string can contain any tags macros (i.e. @artist, @title, etc.), @fname macro for the original file name, and # as the numbers counter (the count of # is the leading zeroes count minus 1);

Examples:

mtag rename "## - @title" mp3  
mtag rename "## - @artist @title" mp3  
mtag rename "## - @fname" mp3  

4. To list files tags by the template, use:

mtag list "template string" extension

Example, write to screen:

mtag list "## - @artist @title" mp3  

Example, write to the file:

mtag list "## - @artist @title" mp3  > file.txt


RU:

1. Чтобы записать тэги в файлы, формат командной строки таков:

mtag apply файл_с_правилами расширение

Пример: mtag apply rules.txt mp3

Звуковые файлы должны быть именованы по алфавиту, например:

01-first-song.mp3
01-second-song.mp3
01-third-song.mp3

Файл правил должен быть в кодировке UTF-8. Синтаксис файла прост - файл состоит из блоков тэгов, и каждый блок оканчивается "###". Пример:

#filename: 01-first-song.ogg
@album=проба
@artist=никто
@title=песенка первая
###
@album=проба
@artist=никто
@title=песенка вторая
###
@album=testalbum
@artist=никто
@title=песня третья
###

Первый блок будет применен к первому файлу (с указанным расширением) в текущем каталоге, второй ко второму, и так далее.

Список доступных тэгов: @artist, @title, @album, @genre, @comment, @year, @track.

Тэг #filename в блоке игнонируется, он нужен для понимания того какой медиафайл сейчас редактируется. Только порядок файлов в каталоге и тэгов в списке правил влияет на то какой блок тэгов будет применен к какому файлу, тэг #filename ни на что не влияет.


2. Чтобы извлечь тэги из файлов в файл правил, к командной строке надо добавить ключик "extract":

mtag extract RULES ogg [<список обязательных тэгов>]

<список_обязательных_тэгов> это необязательный параметр, оперделяющий список тэгов, которые будут сгенерированы в файле правил, даже если такие тэги в медиафайле не представлены, значения таких тэгов будут пустыми.

Примеры:

mtag extract RULES ogg 

или

mtag extract RULES mp3 "@artist,@genre,@album"



3. Чтобы переименовать файлы согласно записанным в них тэгам, используйте команду:

mtag rename "строка шаблона" расширение

Строка шаблона может содержать любые тэговые макросы (т.е. @artist, @title, и прочие), @fname в качестве заменителя исходного имени файла, и # как счетчик (количество # означает число дополяющих нулей).

Примеры:

mtag rename "## - @title" mp3  
mtag rename "## - @artist @title" mp3  
mtag rename "## - @fname" mp3  

4. Для вывода тэгов на экран или в файл, по шаблону, используйте команду:

mtag list "шаблон" расширение

Пример вывода на экран:

mtag list "## - @artist @title" mp3  

Пример вывода в файл file.txt:

mtag list "## - @artist @title" mp3  > file.txt



Requirements/Зависимости:
------------

Taglib, C++ 11

Installation/Установка:
------------

EN:

As usual, under the root (mtag will be installed to /usr/local/bin):

make
make install

To uninstall:

make uninstall


RU:

Как обычно, под рутом (mtag будет установлен в /usr/local/bin):

make
make install

А чтобы удалить:

make uninstall


License/Лицуха
-----------

EN: mtag is public domain.

RU: mtag - общественное достояние.


Donate/Поддержать
---------------

If you like this program, you can donate via PayPal: peter.semiletov@gmail.com


Credits/Кредиты
------------

Program site/сайт: https://github.com/psemiletov/mtag

Developers/разработчики:
Petr Semiletov <peter.semiletov@gmail.com>, http://semiletov.org
Additional code/doc by: 
https://github.com/zargener
Michael Vetter (http://iodoru.org)