Команда mp3wf

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

mp3wf

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

mp3wf=File, ||Path||Mode, ||...

Параметры:

File	Путь к mp3 файлу. Полный путь к mp3 файлу, возможные варианты: • Абсолютный путь c:\test.mp3 • Путь через параметры %P%N см. Дополнение №7. • Относительный путь %COMMANDER_PATH%\test.mp3 • Относительный путь $f06\test.mp3 см. Дополнение №8. • Путь возвращаемый параметром <xfolder> см. Дополнение №11. • Путь возвращаемый глобальными переменными см. Дополнение №23. • Путь возвращаемый параметром [tc] см. Дополнение №12.
	2-й обязательный параметр.
Path	Путь. Path(!!Flag!!Name.Ext!!Insert). Подпараметры разделяются символами !! Может быть от 1-го (обязательного) до 4-х подпараметров. Path//Flag(//Name.Ext//Insert). Подпараметры разделяются символами // (рекомендуемый). Может быть от 2-х (обязательных) до 4-х подпараметров, где: Path - путь назначения, где создавать преобразованные mp3 файлы. 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
	Дополнительные параметры:
...	Аналог. Остальные параметры те же, что и у команды mp3ws.

Примечания:

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

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

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

Имя переменной Описание
GLOBALMP3WF0 массив входных данных (в первой ячейке путь исходного файла)
GLOBALMP3WF массив выходных данных (в первой ячейке путь изменённого mp3 файла)
GLOBALMP3WF2 массив неуспешных данных (в первой ячейке путь файла, который не участвовал в преобразовании)

См. также:

mp3is, mp3im, mp3ws, txwvf, txwvs

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

bends=@[tc=AA]|[tc=AP]??-4 sends=`GLOBALBENDS<1> textv=GLOBALSENDS<x1>||viewtext<TEXT_MP3|0|0|0|0|Consolas>||pos<1> mp3wf=GLOBALBENDS<1>||GLOBALBENDS<2>//1||75//GLOBALTEXTV<t>||upd<1> ;; получить текст песни из MP3 файла, отредактировать и вставить текст обратно в файл MP3 при нажатии на кнопку "==>"

global mp3wf=%P%N||"%t"//0||-1||upd<3> GLOBALMP3WF0<a> GLOBALMP3WF<a> GLOBALMP3WF2<a> ;; в mp3 файле под курсором удалить ID3v1 теги и сохранить в другую панель и записать результат в глобальные переменные

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

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

mp3wf=%P%N||"%t"//0||22//D:\Test\image.png||upd<3> ;; установить заданное изображение в виде обложки mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||22||upd<3> ;; удалить обложку mp3 файла под курсором и сохранить в другую панель

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

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

mp3wf=%P%N||"%t"//0||38//Мега||upd<3> ;; записать "Мега" в ID3v2 тег "Альбом" mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||38||upd<3> ;; очистить ID3v2 тег "Альбом" mp3 файла под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||39//100||upd<3> ;; записать "100" в ID3v2 тег "Число ударов в минуту" mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||39||upd<3> ;; очистить ID3v2 тег "Число ударов в минуту" mp3 файла под курсором и сохранить в другую панель

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

mp3wf=%P%N||"%t"//0||40//Иванов||upd<3> ;; записать "Иванов" в ID3v2 тег "композитор" mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||40||upd<3> ;; очистить ID3v2 тег "композитор" mp3 файла под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||41//Blues||upd<3> ;; записать "Blues" в ID3v2 тег "жанр" mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||41||upd<3> ;; очистить ID3v2 тег "жанр" mp3 файла под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||42//©Copyright||upd<3> ;; записать "©Copyright" в ID3v2 тег "авторские права" mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||42||upd<3> ;; очистить ID3v2 тег "авторские права" mp3 файла под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||43//2503||upd<3> ;; установить день и месяц (25 03) в ID3v2 тег mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||43||upd<3> ;; очистить ID3v2 тег "день и месяц" mp3 файла под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||46//Пушкин||upd<3> ;; записать "Пушкин" в ID3v2 тег "автора слов песни" mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||46||upd<3> ;; очистить ID3v2 тег "автора слов песни" mp3 файла под курсором и сохранить в другую панель

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

mp3wf=%P%N||"%t"//0||75//D:\Lyrics.txt||upd<3> ;; вставить из заданного файла ID3v2 тег текст песни mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||75||upd<3> ;; удалить текст песни из ID3v2 тега mp3 файла под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||78!!http://tc-image.3dn.ru||upd<3> ;; записать сайт в ID3v2 тег WOAF mp3 файлу под курсором и сохранить в другую панель

mp3wf=%P%N||"%t"//0||78||upd<3> ;; очистить ID3v2 тег WOAF mp3 файла под курсором и сохранить в другую панель

sends=`%P%N textv=GLOBALSENDS<x1>||viewtext<TEXT_MP3|0|0|0|0|Consolas>||pos<1> mp3wf=%P%N||"%p"//1||75//GLOBALTEXTV<t>||upd<1> ;; получить текст песни из MP3 файла, отредактировать и вставить текст обратно в файл MP3 при нажатии на кнопку "==>"

sends=`%P%N??-1||#7 mp3wf=%P%N||"%p"//1||75//GLOBALSENDS<t>||upd<1> ;; в тексте песни MP3 файла под курсором произвести в русских словах замену букв "е" на "ё" и сохранить (ёфикация)

sends=`%P%N??-1||#7 mp3wf=%P%N||"%t"//1||75//GLOBALSENDS<t>||upd<3> ;; в тексте песни MP3 файла под курсором произвести в русских словах замену букв "е" на "ё" и сохранить в другую панель (ёфикация)

Имя переменной	Описание
GLOBALMP3WF0	массив входных данных (в первой ячейке путь исходного файла)
GLOBALMP3WF	массив выходных данных (в первой ячейке путь изменённого mp3 файла)
GLOBALMP3WF2	массив неуспешных данных (в первой ячейке путь файла, который не участвовал в преобразовании)