Описание команды


mp3ws

Преобразование тегов MP3 файлов.

mp3ws=%L,%WL||cliplist||LISTF<>||PS<>||FOLDC<>||FOLDM<>||LISTC<>||FLST<>||$var_aa||$GLOBALNAME||Path||Mode, ||Dialogs, ||upd<>, ||progres<>, ||infcyrcle<>

Параметры:

1-й обязательный параметр. Может иметь несколько вариантов:
%L,
%WL
Список выделенных файлов mp3.
Также может использоваться путь к файлу списка полных путей файлов %P%N. см. Дополнение №7 или с:\List.txt
cliplistСписок полных путей объектов из буфера обмена.
LISTF<>Список заданных объектов. см. Дополнение №22.
PS<>Список объектов каталога. см. Дополнение №22.
FOLDC<>Список объектов содержимого каталогов. см. Дополнение №22.
FOLDM<>Список выделенных объектов и всех объектов в подпапках. см. Дополнение №22.
LISTC<>Список объектов из выделенных без дубликатов. см. Дополнение №22.
FLST<>Смешанные списки объектов по заданному списку. см. Дополнение №22.
$var_aaМассив. Переменная $var_a... - массив путей, созданный в команде exect.
$GLOBALNAMEМассив. Список путей глобальной переменной см. Дополнение №23.
2-й обязательный параметр.
PathПуть.
Path(!!Flag!!Name.Ext!!Insert). Подпараметры разделяются символами !!
  Может быть от 1-го (обязательного) до 4-х подпараметров.
Path//Flag(//Name.Ext//Insert). Подпараметры разделяются символами // (рекомендуемый).
  Может быть от 2-х (обязательных) до 4-х подпараметров, где:
  Path - путь назначения, где создавать преобразованные mp3 файлы.
    может использоваться параметр listz<List>, где List - список путей файлов назначения (с:\List.txt, $GLOBALNAME).
  Flag :
    0 - не перезаписывать имеющиеся объекты. Добавление счётчика. (по умолчанию).
    1 - перезаписывать имеющиеся объекты.
    2 - дописывать, если существует.
    3 - добавление счётчика к целевому пути, если он существует.
    4 - пропустить при совпадении имени объекта.
  Name.Ext - имя и расширение создаваемого файла.
  Insert - добавление к базовому имени.
    Если Insert начинается с ** то последующая строка заменяет расширение.
    Если Insert начинается с ++ то последующая строка добавляет расширение.
Если Path=x, Name=x, Ext=x , то путь/имя/расширение берётся из пути оригинального файла.
Может использоваться подпараметр rndm - информация случайных данных см. Дополнение №30
Так же поддерживается конструкция пути Path//Flag//RegExp//Replace , где:
  Path - путь назначения (если в параметрах необходимо использовать путь объекта, то используйте два двоеточия ::).
  Flag - см. выше.
  RegExp//Replace - строка разделённая символами // означает изменение пути Path (путь назначения) с регулярными выражениями: первая часть "что искать", вторая "чем заменять" см. Дополнение №2.
Если преобразование пути заканчивается обратным слешем, то он является путём назначением, если нет, то файлом.
3-й обязательный параметр.
ModeРежим. Number//String , где:
 Number :

  Удаление всех тегов (при отрицательном числе).

  -1 - удаление всех ID3v1 тегов.
  -2 - удаление всех ID3v2 тегов.
  -3 - удаление всех ID3v1 и ID3v2 тегов.
  -4 - удаление всех APEv2 тегов.
      Может быть суммой флагов (при -7 удаление всех ID3v1, ID3v2 и APEv2 тегов).
      String не указывается.

  Преобразование ID3v1 тегов.

    1 - название (Title).
    2 - исполнитель (Artist).
    3 - альбом (Album).
    4 - год (Year).
    5 - комментарий (Comment).
    6 - номер трека (Track).
    7 - жанр (Genre).

  Преобразование ID3v2 тегов (ID3v2.3.0 и выше).
    Подробную информацию о тегах и их возможных значениях можно прочитать на сайте id3.org
  
    22 (APIC) - встроенная картинка (обложка).
         22//FileImage//PictureType, где:
           FileImage - путь к изображению JPG, JPEG, PNG
             так же может быть строкой параметров таких же как и в Дополнении №24
           PictureType - [необязательный] тип, которому устанавливается изображение, число (по умолчанию 0)

    75 (USLT) - текст песни.
         75//FileLyrics//Code, где:
           FileLyrics - путь к текстовому файлу.
             так же может быть строкой параметров таких же как и в Дополнении №24
         Code - [необязательный] кодировка:
            0 - ANSI 1251 (по умолчанию), 1 - UTF-16 LE 1200, 2 - UTF-16 BE 1201, 3 - UTF-8

    32 (POPM) - рейтинг популярности (может содержать рейтинг, email и счётчик).
         32//Rating//E-Mail//Counter , где:
           Rating - оценка трека: число от 1 до 5, при 0 - без оценки.
           E-Mail - [необязательный] e-mail или имя программы, которая установила рейтинг (по умолчанию пусто).
           Counter - [необязательный] (по умолчанию 0)

    38 (TALB) - название альбома, фильма или шоу, из которого взят данный отрывок.
    39 (TBPM) - содержит число ударов в минуту.
    40 (TCOM) - композитор.
    41 (TCON) - жанр музыки.
    42 (TCOP) - информация об авторских правах.
    43 (TDAT) - дата записи в формате 'DDMM'.
    44 (TDLY) - пауза между произведениями в миллисекундах.
    45 (TENC) - имя человека или организации, которая закодировала звуковой файл.
    46 (TEXT) - автор слов песни.
    47 (TFLT) - тип аудиокодека: MPG/1, MPG/2, MPG/3, MPG/2.5, MPG/AAC, PCM, VQF, MIME.
    48 (TIME) - время записи в формате 'HHMM'.
    49 (TIT1) - описания группы содержимого (например, "Концерт - Фортепьяно", "Погода - Ураган")
    50 (TIT2) - название произведения.
    51 (TIT3) - уточнение к названию произведения.
    52 (TKEY) - тональность произведения.
    53 (TLAN) - язык(и) слов песни.
    54 (TLEN) - длина произведения в миллисекундах.
    55 (TMED) - тип носителя, произвольный текст или код в скобках.
    56 (TOAL) - оригинальное название альбома.
    57 (TOFN) - оригинальное имя файла.
    58 (TOLY) - автор(ы) оригинального текста (можно указать несколько, разделяя их символом '/').
    59 (TOPE) - оригинальный исполнитель(и) (можно указать несколько, разделяя их символом '/').
    60 (TORY) - оригинальный год выпуска.
    61 (TPE1) - основной(ые) исполнитель(и) (можно указать несколько, разделяя их символом '/').
    62 (TPE2) - группа/оркестр/сопровождение.
    53 (TPE3) - уточнение к названию произведения.
    64 (TPE4) - информация о модификации (ремикс и т.д.).
    65 (TPOS) - номер части альбома (если используется несколько носителей, например, двойной CD).
    66 (TPUB) - издатель.
    67 (TRCK) - номер произведения в альбоме.(например, "4/9").
    68 (TRDA) - дата записи.
    69 (TSIZ) - размер.
    70 (TSRC) - международный стандартный код записи (12 символов).
    71 (TSSE) - программное обеспечение/Оборудование и настройки, используемые для кодирования.
    72 (TYER) - год.
      Для 38 - 72 : Number//Value//Code
         Value - значение, которое устанавливается тегу.
           может быть строкой, числом, датой и др. (в зависимости от типа тега)
         Code - [необязательный] кодировка:
            0 - ANSI 1251 (по умолчанию), 1 - UTF-16 LE 1200, 2 - UTF-16 BE 1201, 3 - UTF-8

    29 (MCDI) - содержимое CD-ROM TOC для поиска в cddb и т.п.
    31 (PCNT) - сколько раз игрался этот файл.
    76 (WCOM) - коммерческая информация.
    77 (WCOP) - авторские права/правовая информация.
    78 (WOAF) - официальная веб-страница аудиофайла.
    79 (WOAR) - официальная веб-страница исполнителя.
    80 (WOAS) - официальная веб-страница аудио.
    81 (WPUB) - официальная веб-страница издателей.
      Для 29, 31, 76 - 81 : Number//Value
         Value - строка (значение), которое устанавливается тегу.
 String - строка параметров таких же как и в Дополнении №24
   разделитель между параметрами ;;
   если String не прописан, то данные заданного тега удаляются.
Может быть использовано несколько пар Number//String через разделитель ||

  Number//String||Number//String||...||Number//String
Дополнительные параметры:
DialogsДиалоги. см. Дополнение №18
  Описание
Различные параметры диалогов.
  [input] - диалог ввода информации в InputBox.
  [richinput] - диалог ввода информации в RichInputBox.
  [combo] - диалог выбора информации в ComboBox.
  [group] - диалог выбора информации в GroupBox.
  [check] - диалог выбора информации в CheckBox.
  [edits] - диалог выбора информации в EditBox.
  [sfold] - выбор каталога.
  [zfold] - выбор каталогов.
  [sopen] - выбор файла для открытия.
  [ssave] - выбор файла для сохранения.
  [sicon] - диалог просмотра и выбора значка.
  [msgbx] - окно сообщения MsgBox.
  [updwn] - диалог выбора числовой информации UpDown.
  [image] - диалог выбора изображения.
  [elect] - диалог выбора файлов и папок.
...и другие диалоги.
upd<>Обновление панели.
  Описание
Параметр upd<Number>, где Number - значение обновления панели(ей) Total Commander:
  1 - обновить активную панель.
  2 - обновить обе панели, вернуться в активную.
  3 - обновить другую панель, вернуться в активную.
  4 - обновить активную панель, перейти в другую.
  5 - обновить другую панель, остаться в другой.
  6 - обновить обе панели, остаться в другой.
  7 - не обновлять (по умолчанию, т.е. если параметр не прописан, то панели не обновляются).
progres<>Прогресс бар. Параметр progres<> - если указан, то при операции будет запущен прогресс бар.
Учитывается ключ MsBoxAtTheCompletion в TCIMG.ini в секции [Setting].
infcyrcle<>Условие обработки. Параметр [info] или <info> по умолчанию обрабатывает командную строку 1 раз в самом начале. Для обработки списка в цикле используется параметр infcyrcle<>

Примечания:

Аналог команды для одного файла mp3wf

Просмотреть информацию MP3 файла и ID3 тегов можно командой:

infos=3||14||C:\music.mp3 ;; получить информацию ID3 тегов mp3 заданного файла


Команда имеет возможность передавать другим командам информацию через именные глобальные переменные. см. Дополнение №23

Имя переменнойОписание
GLOBALMP3WS0массив входных данных (список исходных путей mp3 файлов)
GLOBALMP3WSмассив выходных данных (список путей изменённых mp3 файлов)
GLOBALMP3WS2массив неуспешных данных (список путей файлов, которые не участвовали в преобразовании)

Аналог команды для одного объекта mp3im

См. также:

mp3is, mp3im, mp3wf, txwvf, txwvs

Примеры:
 Как создать кнопку?

aends=@[tc=AP] mp3ws=[tc=AM]||GLOBALAENDS<1>//0//<info=o72:://>-@<info=s47>.<info=o71:://>||-3||upd<1>||infcyrcle<> ;; в выделенных mp3 файлах удалить ID3v1 и ID3v2 теги и сохранить в ту же папку с датированным именем

global mp3ws=%WL||"%t"//0||-1||progres<>||upd<3> GLOBALMP3WS0<a> GLOBALMP3WS<a> GLOBALMP3WS2<a> ;; в выделенных mp3 файлах удалить ID3v1 теги и сохранить в другую панель и записать результат в глобальные переменные

imgpr=1 slist=%WL mp3ws=$GLOBALSLIST||<info=f15::>//1||-7 mp3ws=$GLOBALSLIST||"%p"//1||1//##::;;?Fmp3.2||2//##::;;?Fmp3.1||61//##::;;?Fmp3.1||50//##::;;?Fmp3.2||upd<1> ;; в выделенных mp3 файлах удалить все теги и записать ID3v1 и ID3v2 теги "Title" и "Artist" взятые из имени файла

imgpr=1 slist=%WL mp3ws=$GLOBALSLIST||<info=f15::>//1||-7 mp3ws=$GLOBALSLIST||"%p"//1||1//##::;;?Fmp3.2||2//##::;;?Fmp3.1||upd<1> ;; в выделенных mp3 файлах удалить все теги и записать ID3v1 теги "Title" и "Artist" взятые из имени файла

imgpr=1 slist=%WL sends=<info=f61%P%N//>!!-8~~-~~ mp3ws=$GLOBALSLIST||<info=f15::>//1||-7 mp3ws=$GLOBALSLIST||"%p"//1||6//##::;;?Fmp3.1||1//##::;;?Fmp3.2||6//##::;;?Fmp3.1||2//##GLOBALSENDS<x1>||3//##GLOBALSENDS<x2>||67//##::;;?Fmp3.1||50//##::;;?Fmp3.2||61//##GLOBALSENDS<x1>||38//##GLOBALSENDS<x2>||upd<1> ;; в выделенных mp3 файлах удалить все теги и записать ID3v1 и ID3v2 теги "Track" и "Title" взятые из имени файла и "Artist" и "Album" взятые из имени родительской папки

mp3ws=%WL||"%P"//1||-7||upd<1> ;; в выделенных mp3 файлах удалить ID3v1, ID3v2 и APEv2 теги

mp3ws=%WL||"%t"//0||1//##::;;?Fmp3.2||2//##::;;?Fmp3.1||upd<3> ;; в выделенных mp3 файлах заменить ID3v1 теги "Title" и "Artist" на исполнителя и названия, взятые из имени файла и сохранить в другую панель

mp3ws=%WL||"%t"//0||1//##Название~~трека||upd<3> ;; в выделенных mp3 файлах заменить ID3v1 тег "Title" (название) заданной фразой и сохранить в другую панель

mp3ws=%WL||"%t"//0||1//^^В~~начало~~названия||upd<3> ;; в выделенных mp3 файлах добавить в начало ID3v1 тега "Title" (название) заданную фразу и сохранить в другую панель

mp3ws=%WL||"%t"//0||1||upd<3> ;; в выделенных mp3 файлах удалить ID3v1 тег "Title" (название) и сохранить в другую панель

mp3ws=%WL||"%t"//0||-1||upd<3> ;; в выделенных mp3 файлах удалить ID3v1 теги и сохранить в другую панель

mp3ws=%WL||"%t"//0||-2||upd<3> ;; в выделенных mp3 файлах удалить ID3v2 теги и сохранить в другую панель

mp3ws=%WL||"%t"//0||3||5||upd<3> ;; в выделенных mp3 файлах очистить информацию об альбоме (3) и комментарий (5)

mp3ws=%WL||"%t"//0||-3||upd<3> ;; в выделенных mp3 файлах удалить ID3v1 и ID3v2 теги и сохранить в другую панель

mp3ws=%WL||"%t"//0||32//0||upd<3> ;; выделенным mp3 файлам удалить оценку и сохранить в другую панель

mp3ws=%WL||"%t"//0||32//5||upd<3> ;; выделенным mp3 файлам установить оценку "5" и сохранить в другую панель

mp3ws=%WL||"%t"//0||-4||upd<3> ;; в выделенных mp3 файлах удалить APEv2 теги и сохранить в другую панель

mp3ws=%WL||"%t"//0||5//##@@s43||upd<3> ;; в выделенных mp3 файлах заменить ID3v1 тег "Comment" (комментарий) на системную дату и сохранить в другую панель

mp3ws=%WL||"%t"//0||5//##http:**tc-image.3dn.ru;;*!!/||upd<3> ;; в выделенных mp3 файлах заменить ID3v1 тег "Comment" (комментарий) на http://tc-image.3dn.ru и сохранить в другую панель

mp3ws=%WL||"%t"//0||5//^^Комментарий@CRLFстрока2@CRLFстрока3||upd<3> ;; в выделенных mp3 файлах добавить в начало ID3v1 тега "Comment" (комментарий) заданную фразу и сохранить в другую панель

mp3ws=%WL||"%t"//0||-5||upd<3> ;; в выделенных mp3 файлах удалить ID3v1 и APEv2 теги и сохранить в другую панель

mp3ws=%WL||"%t"//0||-6||upd<3> ;; в выделенных mp3 файлах удалить ID3v2 и APEv2 теги и сохранить в другую панель

mp3ws=%WL||"%t"//0||-7||upd<3> ;; в выделенных mp3 файлах удалить ID3v1, ID3v2 и APEv2 теги и сохранить в другую панель

mp3ws=%WL||<info=f15::>//1||22||upd<1> ;; у выделенных mp3 файлов удалить обложки (изменив оригинальные mp3 файлы)

mp3ws=%WL||listz<C:\ListMp3.txt>//0||-1 ;; в выделенных mp3 файлах удалить ID3v1 теги и сохранить по заданным путям в ListMp3.txt (количество выделенного должно совпадать со списком)

mp3ws=[tc=AM]||"%t"//0//<info=o72::>-@<info=s47>.x||-3||progres<>||upd<3> ;; в выделенных mp3 файлах удалить ID3v1 и ID3v2 теги и сохранить в другую панель с заданными именами

mp3ws=PS<"%p"//1//0>||<info=f15::>//1||-7||upd<1> ;; в активном каталоге в mp3 файлах удалить ID3v1, ID3v2 и APEv2 теги

slist=[tc=TL] GLOBALSLIST<a> mp3ws=%WL||<info=f15::>//1||22//GLOBALSLIST<:NUMBER:>||upd<1> ;; выделенным mp3 файлам установить обложки из выделенных файлов изображений другой панели (изменив оригинальные mp3 файлы)

slist=[tc=TL] GLOBALSLIST<a> mp3ws=%WL||C:\Sound\//0||22//GLOBALSLIST<:NUMBER:> ;; выделенным mp3 файлам установить обложки из выделенных файлов изображений другой панели, сохранив их в папку C:\Sound\


© Аверин Андрей для Total Commander Image  Averin-And@yandex.ru