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 также умеет извлекать тэги из файлов (в шаблон) и переименовывать файлы на основе записанных в них тэгов.
EN:
To tag some files, use the command line:
mtag apply rules_file extension
Example: mtag apply rules.txt ogg
To be tagged correctly, the media files names needs to be named in the alphabetical order, i.e. for example:
01-first-song.ogg
01-second-song.ogg
01-third-song.ogg
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:
#filename: 01-first-song.ogg
@album=testalbum
@artist=Megapunkers
@title=song one
\#\#\#
#filename: 01-second-song.ogg
@album=testalbum
@artist=Megapunkers
@title=song two
\#\#\#
#filename: 01-third-song.ogg
@album=testalbum
@artist=Megapunkers
@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.
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.
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
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:
Чтобы записать тэги в файлы, формат командной строки таков:
mtag apply файл_с_правилами расширение
Пример: mtag apply rules.txt ogg
Звуковые файлы должны быть именованы по алфавиту, например:
01-first-song.ogg
01-second-song.ogg
01-third-song.ogg
Файл правил должен быть в кодировке UTF-8. Синтаксис файла прост - файл состоит из блоков тэгов, и каждый блок оканчивается "###". Пример:
#filename: 01-first-song.ogg
@album=проба
@artist=никто
@title=песенка первая
\#\#\#
#filename: 01-second-song.ogg
@album=проба
@artist=никто
@title=песенка вторая
\#\#\#
#filename: 01-third-song.ogg
@album=testalbum
@artist=никто
@title=песня третья
\#\#\#
Первый блок будет применен к первому файлу (с указанным расширением) в текущем каталоге, второй ко второму, и так далее.
Список доступных тэгов: @artist, @title, @album, @genre, @comment, @year, @track.
Тэг #filename
в блоке игнонируется, он нужен для понимания того какой медиафайл сейчас редактируется. Только порядок файлов в каталоге и тэгов в списке правил влияет на то какой блок тэгов будет применен к какому файлу, тэг #filename
ни на что не влияет.
Чтобы извлечь тэги из файлов в файл правил, к командной строке надо добавить ключик "extract", например:
mtag extract RULES ogg <список_обязательных_тэгов>
или
mtag extract RULES mp3 "@artist,@genre,@album"
<список_обязательных_тэгов> это необязательный параметр, оперделяющий список тэгов, которые будут сгенерированы в файле правил, даже если такие тэги в медиафайле не представлены, значения таких тэгов будут пустыми.
Чтобы переименовать файлы согласно записанным в них тэгам, используйте команду:
mtag rename "строка шаблона" расширение
Строка шаблона может содержать любые тэговые макросы (т.е. @artist, @title, и прочие), @fname в качестве заменителя исходного имени файла, и # как счетчик (количество # означает число дополяющих нулей).
Примеры:
mtag rename "## - @title" mp3
mtag rename "## - @artist - @title" mp3
mtag rename "## - @fname" mp3
Для вывода тэгов на экран или в файл, по шаблону, используйте команду:
mtag list "шаблон" расширение
Пример вывода на экран:
mtag list "## - @artist @title" mp3
Пример вывода в файл file.txt:
mtag list "## - @artist @title" mp3 > file.txt
Taglib, C++ 11
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
EN: mtag is public domain.
RU: mtag - общественное достояние.
Program site/сайт: https://github.com/psemiletov/mtag
Developer/разработчик: Petr Semiletov [email protected], http://semiletov.org