Показать справку о параметрах.

Показать сведения об авторах приложения.

Показать сведения о версии приложения.

Показать сведения о лицензии приложения.

Имя файла .desktop (без пути) для этого приложения.

Смотрите qt5options(7).

Активировать интерфейс D-Bus.

Выполнить команду. Предусмотрена возможность использования нескольких параметров -c для одной команды, и они будут выполняться последовательно. Описание доступных команд приводится в разделе «kid3-cli».

Показать справку о параметрах и командах.

Список файлов содержит имена всех файлов в открытом каталоге, которые соответствуют выбранному фильтру имён (обычно это *.mp3 *.ogg *.opus *.dsf *.flac *.mpc *.aac *.m4a *.m4b *.m4p *.mp4 *.mp2 *.spx *.tta *.wv *.wma *.wav *.aiff *.ape). Возможно выбрать один или несколько файлов. Чтобы снять выделение, щёлкните левой кнопкой мыши в пустом месте под пунктами списка. Выделение определяет файлы, над которыми будут выполняться действия после нажатия кнопок, описание которых приводится далее.

Параметры файла отображаются не только в столбце Имя, но и в столбцах Размер, Тип, Дата изменения. Чтобы скрыть эти столбцы, снимите флажок в соответствующем пункте контекстного меню строки заголовков списка. Чтобы изменить порядок столбцов, воспользуйтесь функцией перетаскивания. Порядок сортировки файлов переключается щелчком левой кнопкой мыши по заголовку столбца.

Слева от названий может отображаться значок дискеты, указывающий на наличие изменений в файле, либо значок, отображающий информацию о том, какие теги используются (V1, V2, V1V2 или NO TAG; значок не будет отображаться, если чтение данных из файла ещё не было произведено).

Каталоги отображаются со значком в виде папки. При открытии каталога его содержимое отображается в виде иерархического дерева. При выборе файлов из вложенных каталогов возможно выполнять действия над файлами, которые хранятся в разных каталогах. Это удобно, когда музыкальная коллекция организована так, что каталог каждого исполнителя содержит вложенные каталоги с его альбомами.

При щелчке правой кнопкой мыши внутри списка файлов появится контекстное меню, содержащее следующие команды:

Возможно создать как пустой список воспроизведения, так и уже содержащий дорожки из определённого каталога, подробные сведения об этом доступны в описании функции «Создать список воспроизведения». Чтобы изменить список воспроизведения, созданный таким образом, дважды щёлкните по нему левой кнопкой мыши, либо воспользуйтесь пунктом контекстного меню списка файлов Правка. Отобразится диалог с содержимым списка воспроизведения. Возможно открывать сразу несколько разных списков воспроизведения.

Чтобы добавить новые записи, перетащите нужные файлы из списка файлов, диспетчера файлов или из другого списка воспроизведения. Если перетащить запись из другого списка воспроизведения, в зависимости от системы, она будет либо перемещена, либо скопирована. Чтобы вызвать другие действия, нажмите клавишу Shift, Ctrl или Alt (в macOS® — для копирования вместо перемещения). Чтобы упорядочить записи в списке воспроизведения, также воспользуйтесь функцией перетаскивания. Кроме того, для перемещения записей в списке предусмотрены комбинации клавиш Ctrl+Shift+Вверх и Ctrl+Shift+Вниз (в macOS® вместо клавиши Ctrl следует использовать Command). Чтобы удалить запись, нажмите клавишу Delete.

Обратите внимание на следующее: чтобы перетащить записи из списка файлов, их следует захватывать с левой стороны (рядом со значком), так как захват с правой стороны выполняет функцию выделения нескольких файлов. Поэтому, чтобы перетащить сразу несколько файлов, потребуется выполнить оба этих действия.

После внесения изменений в список воспроизведения нажмите кнопку Сохранить для сохранения изменений или кнопку Отмена для их отмены. При закрытии окна приложения будет предложено сохранить несохранённые изменения, если таковые имеются.

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

Чтобы выполнить те или иные действия над списком воспроизведения, следует выделить его файл в списке файлов. Пункт контекстного меню Изменить открывает диалог, описанный в этом разделе, а пункт Воспроизвести запустит проигрыватель с дорожками из списка воспроизведения. Над списками воспроизведения возможно выполнять пользовательские действия, например, Экспорт списка воспроизведения для копирования файлов из списка воспроизведения в каталог.

В списке каталогов содержатся названия подкаталогов открытого каталога, а также пункты текущего (.) и родительского (..) каталога. Этот список позволяет быстро сменить каталог без использования кнопки Открыть или функции перетаскивания.

Сведения о настройке видимости столбцов, порядка столбцов и сортировки записей в столбцах доступны в разделе о списке файлов.

Отображает информацию о кодировке (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4, AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), скорости передачи, частоте дискретизации, каналах и длине файла.

Поле для редактирования Имя содержит название файла (только если выделен один файл). При изменении имени файла для сохранения следует использовать команду сохранения изменений.

Раскрывающийся список Формат и поле для редактирования содержат информацию о формате, который будет использоваться при создании имени файла из первого или второго тега. Имя файла может содержать произвольные символы, даже часть каталога, отделённую от имени файла косой чертой (но переименование будет успешно выполнено только в том случае, если эта папка уже существует). Следующие специальные коды используются для вставки значений тегов в имя файла:

Коды формата не ограничены приведёнными выше примерами. Возможно использовать любые названия фреймов, например, унифицированные названия фреймов наподобие %{albumartist}, %{discnumber.1}, %{bpm} или специфичные для форматов названия наподобие %{popm}.

Чтобы добавить строки к началу или концу строки для замены кода формата, следует добавить соответствующие строки в двойных кавычках внутри фигурных скобок кода формата. Такие строки добавляются в строку-результат, только если код формата имеет непустое значение. Например, если имя файла содержит как заголовок, так и подзаголовок, используйте в строке формата запись %{title} [%{subtitle}]. Но использование такой записи приведёт к завершению строки символами [], если в файле отсутствует фрейм подзаголовка. Чтобы избежать добавления таких пустых квадратных скобок, следует использовать запись вида %{title}%{" ["subtitle"]"}. В этом случае скобки, начальный пробел и подзаголовок будут опущены, если подзаголовка не существует.

Настройка списка доступных форматов осуществляется в диалоге, вызываемом кнопкой Имя файла из тега на вкладке Файлы окна настройки параметров.

Второй раскрывающийся список Формат (со стрелкой вниз) используется для создания тегов из имени файла. Если формат имени файла не соответствует этому шаблону, будет предпринята попытка использовать другие распространённые форматы.

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

Настройка списка доступных форматов осуществляется в диалоге, вызываемом кнопкой Тег из имени файла на вкладке Файлы окна настройки параметров.

На внутреннем уровне регулярное выражение состоит из кодов формата. Если требуются расширенные регулярные выражения, формат для создания тегов из имён файлов может быть задан как полное регулярное выражение с частями, которым предшествуют коды формата. Например, для извлечения номеров дорожек без удаления нулей в начале следует использовать формат наподобие «/%{track}(\d+) %{title}(.*)».

Из: Тег 1, Тег 2: установка имени файла с использованием выбранного формата и, соответственно, первого или второго тега.

В: Тег 1, Тег 2: создание тегов из имени файла. Сначала используется формат, указанный в поле Формат. Если существующее имя файла не соответствует этому формату, предпринимается попытка использовать следующие форматы:

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

Строки редактирования Заголовок, Исполнитель, Альбом, Комментарий, Дата, Номер дорожки и Жанр используются для изменения соответствующего значения первого тега выделенных файлов. Значение будет изменено при изменении выделения файлов, перед такими действиями, как Сохранить и Выход, а также при установке соответствующего флажка слева от имени поля. Это позволяет изменить только некоторые значения, оставив остальные значения без изменений.

Если выбран один файл, будут установлены все флажки, а строки будут заполнены данными, полученными из тегов этого файла. Если теги отсутствуют, будет отображаться соответствующее пустое значение: пустая строка в текстовых полях Заголовок, Исполнитель, Альбом и Комментарий, 0 в числовых полях Дата и Номер дорожки и пустое значение в раскрывающемся списке Жанр. Эти значения возможно изменить, и, если установлен соответствующий флажок, они будут установлены для выбранного файла после изменения выделения. В таком случае файл в списке файлов будет отмечен значком дискеты, но изменения не будут применены, пока не будет выполнена команда Сохранить.

Если выбрано несколько файлов, будут отображены только значения, идентичные во всех файлах. Во всех остальных полях будут показаны пустые значения, как было описано выше. Все флажки будут сняты во избежание нежелательных изменений. Если требуется установить значение для всех выделенных файлов, отредактируйте его, и приложение автоматически установит соответствующий флажок. Значения для выбранных файлов будут установлены при изменении выделения, и эти изменения будет возможно сохранить с помощью команды Сохранить.

Флажки позволяют управлять большинством команд, включая копирование, вставку и перенос данных между тегами 1 и 2. Чтобы упростить одновременную работу с несколькими файлами, когда все флажки сняты, эти команды работают одинаково независимо от того, установлены или сняты все флажки.

Из тега 2: значения полей тега 1 устанавливаются из соответствующих значений тега 2. Если выбран один файл, пункты графического интерфейса будут заполнены значениями из тега 2. Если выбрано несколько файлов, устанавливаются непосредственно теги этих файлов.

Копировать: скопировать в буфер обмена значения тега 1. В следующих командах вставки будут использоваться только значения из пунктов с установленным флажком.

Вставить: вставить данные из буфера обмена в пункты графического интерфейса.

Убрать: очистить все значения пунктов графического интерфейса. Если после этого действия сохранить редактируемый файл, в нём будет отсутствовать тег 1.

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

При заполнении поля тега 2 Жанр также возможно использовать собственные названия помимо жанров, указанных в раскрывающемся списке; достаточно просто ввести название жанра в строку редактирования.

Тег 2 не может содержать только те же значения, что и тег 1. Формат гибко строится из нескольких фреймов, которые сами состоят из нескольких полей. Таблица тега 2 показывает все фреймы, которые доступны в выбранном файле.

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

Добавить: открывает окно для указания типа фрейма, который можно будет изменить и добавить в файл. Эта функция также работает при выборе нескольких файлов.

Удалить: удаляет выбранный фрейм в выбранных файлах.

Надпись Перетащите сюда обложку альбома отобразится в том случае, если в файле отсутствует встроенная обложка альбома. Чтобы добавить изображение, перетащите его мышью из браузера или диспетчера файлов; после этого оно отобразится вместо надписи. Чтобы изменить или добавить фрейм, дважды щёлкните левой кнопкой мыши по соответствующему полю.

Некоторые файлы могут содержать более двух тегов. В этом случае будет отображаться раздел третьего тега. Раздел Тег 3 могут иметь следующие типы файлов:

Пункты графического интерфейса работают так же, как и в разделе Тег 2.

Для изменения информации, синхронизирующейся с аудиоданными, предусмотрен специальный редактор. Эти фреймы поддерживаются в тегах ID3v2.3.0 и ID3v2.4.0. Чтобы добавить такой фрейм, выберите его название из списка, который появляется после нажатия кнопки Добавить — Синхронизированный текст или Коды привязки ко времени событий, соответственно. Для обоих типов используется один и тот же редактор, однако для кодов привязки ко времени событий предусмотрен только предварительно определённый набор событий, а для синхронизированного текста песни придётся ввести сам текст. Далее рассматривается пример редактирования синхронизированного текста песни.

Допустим, выбран файл с тегом ID3v2 и с помощью кнопки Добавить запущен редактор текста с опцией Синхронизированный текст. Если синхронизированный текст уже существует, выберите его и нажмите кнопку Изменить. После этого текущий файл будет автоматически открыт в проигрывателе, что позволит воспроизводить его и синхронизировать текст.

Параметры в верхней части окна редактора SYLT, как правило, не требуют внесения изменений. Если текст песни содержит символы, которых нет в наборе символов «Латиница 1», рекомендуется изменить кодировку текста на UTF16 (или UTF8 для ID3v2.4.0). Если текст песни написан на английском языке и требуется сохранить максимальную совместимость, рекомендуется использовать кодировку ISO-8859-1.

Раздел Текст содержит шесть кнопок в верхней части окна. Кнопка Добавить позволяет добавить в таблицу новое временное событие. Значение времени берётся из позиции в проигрывателе, поэтому добавление записи во время воспроизведения дорожки добавит строку для текущей позиции воспроизведения. События в таблице должны располагаться в хронологическом порядке, поэтому строки будут добавляться соответствующим образом. Записи с некорректными метками времени обрабатываются особым образом: если текущая выделенная строка содержит некорректное время, будет выполнена замена этой метки на текущее время, а не добавление новой строки. Если текущее время является корректным, будет использоваться первая строка с некорректным временем, если таковая имеется. Такой принцип работы должен упростить добавление меток времени, если в таблице уже есть текст песни, но отсутствуют метки (так происходит при импорте несинхронизированного текста). Обратите внимание, что некорректное время обозначается как 00:00.00, то есть так же, как и время самого начала дорожки, которое не является некорректным. Чтобы сделать время некорректным, нажмите клавишу Delete или воспользуйтесь пунктом вызываемого правой кнопкой мыши контекстного меню Очистить. Новые строки, созданные путём вставки с помощью пункта контекстного меню Вставить строку или при импорте несинхронизированного текста с помощью кнопок Из буфера обмена или Импорт..., также содержат некорректные метки времени. Чтобы удалить строки из таблицы, воспользуйтесь кнопкой Удалить или пунктом контекстного меню Удалить строки.

Чтобы импортировать синхронизированный текст из файла, воспользуйтесь кнопкой Импорт.... Ожидаемым форматом файла является простой или усовершенствованный формат LRC. Если первая строка в выбранном файле начинается не с квадратной скобки, приложение распознает файл как простой текстовый файл с несинхронизированным текстом. Строки из такого файла будут импортированы с некорректными метками времени. Данные времени возможно добавить с помощью кнопки Добавить или ввести вручную. Также возможно импортировать текст путём копирования со вставкой с помощью кнопки Из буфера обмена. Чтобы записать синхронизированный текст в файл формата LRC, воспользуйтесь кнопкой Экспорт.... Обратите внимание, что экспортируются лишь записи с корректными метками времени, при этом сами записи будут упорядочены по времени. Записи с некорректными метками времени не сохраняются во фрейме SYLT, поэтому перед закрытием диалогового окна убедитесь, что указаны все данные времени.

Спецификация ID3[5] предлагает использование метки времени для каждого слога. Однако большинство проигрывателей поддерживают только разделение текста на уровне строки или предложения. Чтобы обеспечить поддержку обоих способов использования, Kid3 следует тем же принципам, что и редактор SYLT[6]. Введённый в таблицу текст считается началом новой строки, если он не начинается с пробела или дефиса. Из этого правила есть исключения: возможно начать строку с символа подчёркивания («_») для принудительного продолжения строки или с символа решётки («#») для принудительного разрыва строки. Эти спецсимволы не сохраняются во фрейме SYLT. Внутри фрейма SYLT новые строки начинаются с символа перевода строки (шестнадцатеричного 0A), а продолжение строк — нет. При чтении фреймов SYLT Kid3 проверяет, начинается ли первая запись с символа перевода строки. Если это не так, приложение предполагает, что все записи являются отдельными строками, а продолжение по слогам не используется.

При воспроизведении дорожки будет подсвечиваться строка, соответствующая воспроизводимой позиции, что позволяет проверить правильность синхронизации информации. Если требуется добавить смещение на одну или несколько меток времени, воспользуйтесь пунктом вызываемого правой кнопкой мыши контекстного меню Добавить смещение.... Отрицательные значения позволяют уменьшить значения меток времени. Пункт контекстного меню Прокрутка до положения позволяет установить позицию воспроизведения в значение времени выбранной строки.

Рекомендуемый порядок действий для синхронизации текста песни

Открывает каталог. В списке файлов будут отображаться все файлы, соответствующие выбранному фильтру имён файлов, а выбранный файл будет выделен.

Открывает последний открытый каталог.

Открывает каталог. В списке файлов будут отображаться все файлы, соответствующие выбранному фильтру имён файлов.

Обновляет каталог. Перед обновлением следует сохранить изменённые файлы. Развёрнутые вложенные папки будут свёрнуты.

Сохраняет все изменённые файлы в каталоге. Изменённые файлы отмечены значком дискеты в списке файлов. Если были изменены названия файлов, файлы будут соответствующим образом переименованы.

Отменяет изменения одного или нескольких файлов. Если в списке файлов не было выделено ни одного файла, будут отменены изменения всех файлов. Если же в списке имеются выделенные файлы, будут отменены изменения только этих файлов.

Диалог импорта позволяет импортировать данные непосредственно с сервера freedb.org, сервера MusicBrainz, Discogs, Amazon или из других источников списков воспроизведения в альбомах, которые предоставляют данные в текстовом формате.

Чтобы импортировать данные с сервера freedb.org, в диалоге импорта выберите в меню С сервера... вариант gnudb.org. В появившемся диалоговом окне введите в два верхних поля данные для поиска исполнителя и названия альбома; альбомы, соответствующие запросу, будут отображены после нажатия кнопки Найти и получения результатов с сайта www.gnudb.org[7]. Импорт данных дорожек для альбома выполняется двойным щелчком левой кнопкой мыши по альбому в списке. Для импорта данных возможно выбрать как сервер freedb.org, так и путь CGI. Импортированные данные будут отображаться в таблице предварительного просмотра диалога импорта. Если отображаемые результаты удовлетворяют требованиям, запустите процесс импорта, закрыв диалоговое окно с помощью кнопки OK.

Чтобы выполнить поиск на сервере Discogs, выберите в раскрывающемся списке вариант Discogs. Как и в диалоге поиска gnudb.org, следует указать исполнителя и название альбома, а затем выбрать нужный вариант из списка альбомов. Возможно ввести Токен, чтобы использовать программный интерфейс RESTful Discogs API вместо веб-интерфейса, который часто меняется, тем самым нарушая работу анализатора импорта. Потребуется создать учётную запись на сайте Discogs[8], затем там же сгенерировать токен (Настройки/Разработчикам, Сгенерировать токен). Не забудьте нажать кнопку Сохранить параметры после ввода токена, чтобы использовать его и в последующих запросах. Если установлен флажок Стандартные теги, будет импортирована стандартная информация, например, об исполнителе, альбоме и названиях дорожек. Если установлен флажок Дополнительные теги, будет также импортирована доступная дополнительная информация, например, об аккомпанементе, аранжировщиках или издателе. Если установлен флажок Обложка, также будет загружено изображение обложки альбома (если оно доступно).

Чтобы выполнить поиск на Amazon, выберите в раскрывающемся списке вариант Amazon. Как и в диалоге поиска gnudb.org, следует указать исполнителя и название альбома, а затем выбрать нужный вариант из списка альбомов. Если установлен флажок Дополнительные теги, будет импортирована доступная дополнительная информация, например, об аккомпанементе, аранжировщиках или издателе. Если установлен флажок Обложка, также будет загружено изображение обложки альбома (если оно доступно).

Таким же образом производится поиск в базе данных альбомов MusicBrainz (выберите в раскрывающемся списке вариант MusicBrainz (релиз)). Рабочий процесс аналогичен процессу, описанному для функции импорта с сервера gnudb.org.

Чтобы импортировать данные с сервера MusicBrainz, воспользуйтесь диалогом, который появляется при выборе в меню варианта MusicBrainz (отпечаток). Выбор сервера аналогичен выбору в диалоге импорта из freedb. Ниже располагается таблица, отображающая импортированные данные дорожек. Правый столбец содержит состояние запроса MusicBrainz (при первом открытии диалога — «В ожидании»). Производится поиск отпечатка, и, если результата не будет, приложение попробует провести другой поиск с использованием тегов файла. Таким образом, для успешного поиска в MusicBrainz желательно сохранить имеющиеся данные (например, данные об исполнителе и альбоме) в метках перед импортом. Если соответствующая запросу запись была найдено, поиск завершится с состоянием «Распознано». Если же найти такую запись не удастся, будет показано уведомление об отсутствии результатов или несколько неточных соответствий, из которых пользователю потребуется выбрать нужный вариант. Кнопки OK и Применить позволяют использовать импортированные данные, а кнопка Отмена закрывает диалог. Закрытие может занять некоторое время, так как потребуется отключить весь механизм MusicBrainz.

Для импорта текстовых данных предназначен вложенный диалог, который вызывается нажатием кнопки Из файла или буфера обмена.... В этом диалоге доступны несколько предустановленных форматов импорта. Первые два, «CSV unquoted» и «CSV quoted», используются для импорта данных, которые ранее были экспортированы с помощью диалога экспорта. Эти данные возможно редактировать с помощью электронной таблицы. Они должны быть сохранены с использованием символов табуляции в качестве разделителей. После такой обработки данные возможно импортировать с использованием формата «CSV quoted». Этот формат позволяет выполнять более тонкую настройку, чем «CSV unquoted», однако его поля не должны содержать двойных кавычек. Если производится только экспорт из Kid3 для дальнейшего импорта, рекомендуется использовать формат «CSV unquoted». Обратите внимание, что в контекстном меню списка файлов также есть пункты «Экспорт CSV» и «Импорт CSV», предусматривающие использование сценариев для более полной, эффективной и гибкой обработки данных CSV при экспорте и импорте.

Ещё один формат, «freedb HTML text», используется для копирования информации с HTML-страницы freedb.org[9]. Найдите альбом во freedb и, если нужная информация отобразится в браузере, скопируйте содержимое в буфер обмена. Затем нажмите кнопку Из буфера обмена, и в таблице предварительного просмотра в верхней части диалога будут отображены импортированные дорожки. Если импортированные данные соответствуют ожидаемому результату, закройте диалог с помощью кнопки OK, что позволит вставить данные в теги в текущем каталоге. Место назначения (Тег 1, Тег 2 или Тег 1 и тег 2) указывается с помощью раскрывающегося списка. Для корректного присваивания тегов файлы должны быть расположены в правильном порядке. Обеспечить такой порядок возможно путём нумерации файлов.

Следующий предустановленный формат импорта — это «freedb HTML source». Этот формат возможно использовать, когда данные хранятся в формате HTML. Импорт производится с помощью кнопки Из файла, которая открывает окно выбора файла, или путём копирования содержимого файла из редактора с последующим импортом из буфера обмена. Этот формат может быть полезен для автономного импорта, хотя документ HTML также возможно открыть в браузере, а затем импортировать в первом формате с помощью буфера обмена.

Доступны и другие предустановленные форматы, например, «Track Title Time». Чтобы создать собственный формат и позже настроить его, воспользуйтесь кнопкой Добавить. В двух строках под названием формата возможно указать регулярные выражения для захвата полей из импортируемого текста. Первое регулярное выражение будет проанализировано один раз для каждого документа для получения таких данных о каждом альбоме, как имя исполнителя, название альбома, год выхода и жанр. Вторая строка анализируется с начала документа и до конца, чтобы получить данные дорожки (её номер и заголовок). Регулярные выражения включают в себя все функции, предоставляемые Qt(TM), то есть большинство возможностей регулярных выражений Perl. Использование скобок «(..)» позволяет создать буферы захвата для полей для импорта. Перед ними возможно указывать специальные коды Kid3 для захвата конкретных полей. Эти коды аналогичны кодам для формата имён файлов, и помимо кодов, перечисленных далее, возможно использовать любое название фрейма:

Например, регулярное выражение дорожки (вторая строка) для импорта из списка воспроизведения .m3u может выглядеть как «%{track}(\d+)\s+%{title}(\S[^\r\n]*)\.mp3[\r\n]». Все форматы возможно изменить путём редактирования регулярных выражений и названия и последующего нажатия кнопки Сохранить параметры. Они будут храниться в файле kid3rc в каталоге конфигурации. Этот файл возможно отредактировать напрямую для получения большего количества форматов импорта или удалить для возврата к форматам по умолчанию. Чтобы удалить форматы, воспользуйтесь кнопкой Убрать.

Параметр Точность отображает оценку того, насколько хорошо импортированные данные соответствуют заданным дорожкам. Степень соответствия в процентах основана на длительности дорожек или названиях файлов. Параметр Обложки показывает URL-адреса изображений обложек альбомов, которые будут загружены.

Чтобы проверить, соответствуют ли импортированные данные дорожек текущему набору файлов, следует сравнить длительность импортированных дорожек с длительностью этих файлов. Для этого служит флажок Проверять максимальную допустимую разницу во времени (в секундах):, который позволяет указать максимально допустимую погрешность в секундах. Если приложение обнаружит несоответствие длительности, данные о длительности будут обозначены красным фоном в таблице предварительного просмотра.

Если файлы расположены не в же порядке, что и импортированные дорожки, потребуется изменить назначенные этим файлам дорожки. Эту задачу упрощает опция Сопоставлять с: с кнопками Длительность, Дорожка и Название. Эти кнопки позволяют переупорядочить дорожки в соответствии с нужным полем. Чтобы отредактировать порядок дорожек вручную, перетащите дорожку на новое место с помощью левой кнопки мыши в сочетании с клавишей Ctrl.

Открытый диалог импорта содержит данные тегов. Тип тега («Тег 1», «Тег 2», «Тег 1 и тег 2») выбирается в раскрывающемся списке Место назначения. Кнопка справа от раскрывающегося списка позволяет отменить изменения, чтобы вновь показать в таблице текущее содержимое тегов. Флажки в первом столбце таблицы позволяют выбрать дорожки, для которых будут импортированы данные. Это может быть полезно, например, если папка содержит дорожки с обоих компакт-дисков двойного компакт-диска, а импортировать следует только данные второго компакт-диска.

Чтобы идентифицировать дорожки, данные которых будут импортированы, возможно включить показ названий файлов или полного пути к файлам с помощью контекстного меню заголовка таблицы. Значения в таблице импорта доступны для редактирования. Кнопка отмены изменений, расположенная справа от раскрывающегося списка Место назначения, служит для восстановления содержимого тегов. Ей также возможно воспользоваться после изменения содержания пункта Место назначения.

Почти во всех диалогах присутствует кнопка Сохранить параметры, позволяющая сохранить параметры конкретного диалога и размеры окна.

Кнопка Из тегов... открывает вложенный диалог для заполнения данных фреймов тегов на основе других фреймов тегов. Эта функция позволяет просто скопировать информацию из одного тега в другой или извлечь часть фрейма и вставить её в другой фрейм.

Как и в диалоге импорта из файла или буфера обмена, здесь представлены легко настраиваемые форматы для выполнения различных действий. Предусмотрены предустановленные форматы для копирования значения названия альбома в поля исполнителя, композитора или дирижёра, а также для извлечения номера дорожки из полей заголовка, содержащих число. Также предусмотрен формат для получения значения подзаголовка из поля заголовка.

Следующий пример описывает алгоритм добавления пользовательского формата, который будет вставлять информацию из поля «Подзаголовок» в поле «Комментарий». Создайте новый формат с помощью кнопки Добавить и укажите новое название, например, «Подзаголовок в комментарий». Затем введите «%{subtitle}» в поле Источник и «%{comment}(.*)» в Извлечение, а затем нажмите кнопку Сохранить параметры.

Выражение в поле Источник может содержать коды формата для произвольных фреймов тегов. Использование нескольких кодов позволяет комбинировать содержимое разных фреймов. Для каждой дорожки текст генерируется из её тегов с использованием формата Источник, а затем к этому тексту применяется регулярное выражение из поля Извлечение для установки новых значений тегов. Коды формата используются перед захватывающими круглыми скобками, чтобы указать фрейм тега, в котором будет сохранён захваченный текст. Всё это работает таким же образом, как и в функции импорта из файла или буфера обмена.

Функцией Импорт из тегов... также возможно воспользоваться непосредственно в меню Файл. Разница между этими двумя инструментами заключается в том, что вложенный диалог функции импорта работает со всеми файлами в текущем каталоге, тогда как функция в меню работает с выбранными файлами (которые могут находиться в разных каталогах). Функция в меню поддерживает дополнительный код «%{__return}» для возврата полученного значения, что может быть полезно при работе с интерфейсами командной строки и QML.

Импорт с сервера freedb.org с помощью поиска по альбомам в gnudb.org. Этот пункт меню открывает то же окно импорта, что и пункт меню Импорт..., но при этом сразу появляется диалог gnudb.org.

Импорт с сервера Discogs. Этот пункт меню открывает то же окно импорта, что и пункт меню Импорт..., но при этом сразу появляется диалог Discogs.

Импорт из Amazon. Этот пункт меню открывает то же окно импорта, что и пункт меню Импорт..., но при этом сразу появляется диалог Amazon.

Импорт из базы данных альбомов MusicBrainz. Этот пункт меню открывает то же окно импорта, что и пункт меню Импорт..., но при этом сразу появляется диалог MusicBrainz (релиз).

Импорт с сервера MusicBrainz. Этот пункт меню открывает то же окно импорта, что и пункт меню Импорт..., но при этом сразу появляется диалог MusicBrainz (отпечаток).

Аналогично кнопке «Из тегов...», но импорт применяется к выделенным файлам.

Автоматический импорт позволяет импортировать данные для нескольких альбомов с различных веб-сервисов. Если в списке файлов выбраны каталоги, будут импортированы данные дорожек для выделенных каталогов. Если не выделен ни один каталог, будут импортированы данные для всех каталогов в списке файлов.

Тип тега («Тег 1», «Тег 2», «Тег 1 и тег 2») выбирается в раскрывающемся списке Место назначения.

Профили указывают, к каким серверам следует обратиться, чтобы получить информацию об альбоме. Некоторые профили предустановлены («All», «MusicBrainz», «Discogs», «Cover Art»); чтобы добавить дополнительные профили, воспользуйтесь кнопкой Добавить, расположенной справа от раскрывающегося списка Профиль.

В таблице ниже приведён список серверов, которые будут использоваться при импорте информации об альбоме с помощью выбранного профиля. Процесс импорта данных альбома завершается после получения всей необходимой информации, поэтому порядок строк в таблице имеет значение. Изменить порядок позволяют кнопки Переместить вверх и Переместить вниз. Кнопка Изменить... позволяет внести изменения в существующую запись. В столбце Сервер представлены те же серверы, что и в функциях импорта. Флажки Стандартные теги, Дополнительные теги, Обложки определяют информацию, которая будет получена с сервера. В столбце Точность указывается точность, которой требуется достичь при импорте данных. Если заданный уровень точности не будет достигнут, приложение попытается получить данные со следующего сервера. Аналогичный диалог со свойствами сервера появляется при нажатии кнопки Добавить... для добавления новой записи сервера. Кнопка Убрать позволяет удалить существующие записи.

Чтобы запустить автоматический пакетный импорт с выбранным профилем, нажмите кнопку Начать. Подробные сведения о запущенном импорте отображаются в верхней части диалогового окна. Чтобы прервать процесс, нажмите кнопку Прервать.

Диалог «Найти обложки» позволяет найти и загрузить обложки альбомов. Поля Исполнитель и альбом заполняются автоматически, если в тегах доступны соответствующие данные. В разделе Источник доступно большое количество веб-сайтов с обложками. Под названием источника расположена URL-ссылка, в которой в качестве параметров указаны исполнитель и альбом. Чтобы вставить значения артиста и альбома в кодировке URL, воспользуйтесь командами «%u{artist}» и «%u{album}». Команды для вставки других значений из тегов доступны в разделе «Настройка Kid3» (описание вкладки Команды пользователя). Чтобы добавить дополнительные источники обложек, замените запись «Custom Source» названием нового источника и нажмите клавишу Enter; после этого следует указать URL-адрес и нажать кнопку Сохранить параметры. Результат будет отображён в верхней части диалога, а чтобы открыть соответствующий адрес в браузере по умолчанию, указанном в параметрах, воспользуйтесь кнопкой Браузер. Изображение обложки возможно перетащить из окна браузера в окно Kid3, после чего оно будет сохранено во фрейме изображения выбранных файлов.

Так как не все браузеры поддерживают функцию перетаскивания изображений, а многие изображения на веб-сайтах представлены в виде URL-адресов, в таких случаях Kid3 получит не изображение, а его URL-адрес. Если URL-адрес указывает на изображение, оно будет загружено, но, если URL-адрес указывает на какой-либо интернет-источник, его придётся преобразовать в соответствующее изображение. Такие привязки указаны в таблице Извлечение URL-адреса. Левый столбец Соответствие содержит регулярные выражения, которые сравниваются с URL-адресами. Если программе удаётся установить соответствие, захваченные выражения в скобках вставляются в шаблон в правый столбец URL-адрес изображения (в позиции, указанные заменителями \1 и так далее). Заменённое регулярное выражение содержит URL-адрес изображения. Такой способ позволяет импортировать обложки из Amazon, Google Images и так далее. Также возможно указать собственные соответствия.

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

Параметры форматирования аналогичны параметрам диалога «Импорт»: верхнее поле содержит название формата (например, «CSV unquoted»), следом идёт заголовок, который будет создан в начале файла. Далее следуют данные дорожки (используются для каждой дорожки). Последнее поле позволяет создать какой-либо завершающий текстовый фрагмент.

В полях форматирования не должно содержаться регулярных выражений, как в диалоговом окне «Импорт»; там должны быть только выражения форматирования результата со специальными заменителями с символом «%», которые будут заменены значениями из соответствующих тегов. Всё это работает так же, как форматирование названия файла, то есть используются те же коды вместе с дополнительными. Могут использоваться не только коды, перечисленные далее, но и коды с названиями фреймов тегов.

Предустановлено несколько форматов. В формате «CSV unquoted» поля разделяются символами табуляции. Данные в этом формате возможно снова импортировать в Kid3 с использованием одноимённого формата импорта. В формате «CSV quoted» поля дополнительно заключаются в двойные кавычки, что упрощает импорт в приложения для работы с таблицами. Однако, если используется этот формат, эти поля не должны содержать двойные кавычки. Форматы «Extended M3U» и «Extended PLS» позволяют создавать списки воспроизведения с расширенными атрибутами и абсолютными путями к файлам. Формат «HTML» позволяет создавать HTML-страницы с гиперссылками на дорожки. Формат «Kover XML» создаёт файл, который возможно импортировать в программу для печати обложек компакт-дисков Kover. Формат «Technical Details» позволяет предоставить информацию о скорости передачи, частоте дискретизации, каналах и так далее. Наконец, пункт «Custom Format» намеренно оставлен пустым для определения пользовательского формата. Дополнительные пользовательские форматы задаются путём добавления строк в файл kid3rc в каталоге конфигурации. Остальные форматы возможно изменить в соответствии с потребностями пользователя.

Источник тегов для создания экспортируемых данных (Тег 1 или Tег 2) выбирается в раскрывающемся списке. Кнопки В файл... или В буфер обмена позволяют поместить данные в файл или буфер обмена. Кнопки OK и Отмена закрывают диалог, при этом кнопка OK позволяет сохранить текущие параметры диалога.

Создаёт список воспроизведения. Формат и содержимое списка воспроизведения возможно настроить с помощью различных параметров.

Чтобы указать название списка воспроизведения, выберите вариант Совпадает с именем каталога или Формат со значениями из тегов, например, «%{artist} - %{album}» (в этом случае название списка воспроизведения будет складываться из имени исполнителя и названия альбома). Коды формата аналогичны кодам для экспорта. Кнопка-переключатель Создать список воспроизведения позволяет создать пустой список воспроизведения с заданным названием. Расширение зависит от указанного формата списка воспроизведения.

Расположение создаваемого списка воспроизведения указывается в раскрывающемся списке Создать в.

Текущем каталоге

Каждом каталоге

Каталоге верхнего уровня

Формат списка воспроизведения может быть следующим: M3U, PLS или XSPF.

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

Параметр Упорядочить по имени файла представляет собой обычный метод сортировки, когда файлы упорядочиваются по имени в алфавитном порядке. Параметр Упорядочить по полю тега позволяет отсортировать файлы по строке формата со значениями из полей тега. Например, «%{track.3}» позволит упорядочить файлы по номеру дорожки («.3» используется для получения трёх цифр с нулями в начале, потому что строки используются для сортировки). Также возможно указать несколько полей, например, «%{genre}%{year}» для сортировки на основе строки с жанром и годом.

Записи в списке воспроизведения могут содержать относительные или абсолютные пути к файлам в зависимости от того, какой параметр установлен: Использовать относительный путь для файлов в списке воспроизведения или Использовать абсолютный путь для файлов в списке воспроизведения.

Когда выбрана опция Записать только список файлов, список воспроизведения будет содержать только пути к файлам. Чтобы создать расширенный список воспроизведения с дополнительной информацией, укажите строку формата с помощью параметра Записать информацию, используя.

Закрывает приложение.

Выделяет все файлы.

Снимает выделение со всех файлов.

Выделяет все файлы в текущем каталоге.

Выделяет предыдущий файл.

Выделяет следующий файл.

Производит поиск строк в именах файлов и тегах. Диалог Найти — это часть диалога Заменить, описание которого приводится далее.

Этот пункт меню открывает диалог для поиска и замены строк в именах файлов и тегах. Чтобы ограничить набор фреймов для проведения поиска, снимите флажок Выбрать все и выделите фреймы, в которых нужно провести поиск. Также доступны параметры для поиска в обратном направлении, с учётом регистра и использованием регулярных выражений.

В зависимости от количества файлов поиск может занять некоторое время; чтобы прервать поиск, закройте диалог.

Когда в диалоге настройки отключён параметр Автоматически применять формат для формата имени файла, этот пункт меню позволяет применить указанный формат к именам выбранных файлов. Эта функция также позволяет проверить соответствие имён файлов настроенному формату путём применения формата ко всем сохранённым файлам и последующей проверки того, были ли какие-либо файлы изменены (и, следовательно, отмечены значком дискеты в списке файлов).

Когда в диалоге настройки отключён параметр Автоматически применять формат для формата тега, этот пункт меню позволяет применить указанный формат к тегам выбранных файлов. Эта функция также позволяет проверить соответствие тегов настроенному формату путём применения формата ко всем сохранённым файлам и последующей проверки того, были ли какие-либо файлы изменены (и, следовательно, отмечены значком дискеты в списке файлов).

При использовании этой функции устанавливается Кодировка текста, указанная на вкладке Настройка → Настроить Kid3... → Теги → Тег 2 для всех выбранных файлов. Если выбрана кодировка UTF8, для тегов ID3v2.3.0 будет использоваться UTF16, потому что этот формат не поддерживает UTF8.

Этот диалог позволяет автоматически переименовать текущий открытый каталог в соответствии с тегами в файлах. Предварительно настроено несколько форматов для включения в название каталога информации об исполнителе, альбоме и годе выпуска. Также возможно указать собственный формат и воспользоваться кнопкой Изменить... для редактирования имеющихся форматов. Следующие специальные коды используются для вставки значений тегов в имя каталога:

Если в формате присутствует разделитель каталогов «/», будет создано несколько каталогов. Если требуется не переименовать текущий каталог, а создать новый, воспользуйтесь раскрывающимся списком Действие и выберите вариант Создать каталог вместо Переименовать каталог. Источник данных тега возможно установить в одно из следующих значений: Тег 1 и тег 2, Тег 1 или Тег 2. Предварительный просмотр действия по переименованию первого файла доступен в разделах диалога Из и В.

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

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

Также в тегах будет указано количество дорожек, если установлен флажок Всего дорожек.

Возможно пронумеровать дорожки в нескольких каталогах. Нужные каталоги следует развернуть и выделить.

Если установлен флажок Начинать заново в каждой папке, в каждом выделенном каталоге нумерация дорожек будет начата заново с указанного номера.

Диалог нумерации дорожек также позволяет отформатировать уже присвоенные номера без изменения их значений, если снят флажок Начальный номер. Общее количество дорожек будет добавлено, если установлен соответствующий флажок, который предназначен для установки общего количества для всех выбранных дорожек. Если требуется выполнить только форматирование существующих номеров, этот флажок также необходимо снять.

Фильтр предоставляет возможность отображения только тех файлов, которые соответствуют определённым требованиям. Эта функция полезна при работе с большой коллекцией, она позволяет отредактировать только определённые файлы. В выражении, определяющем, какие файлы будут показаны, используются те же коды формата, что и для формата имени файла, импорта и экспорта.

Эти коды заменяются значениями для файла, и полученные строки можно будет сравнивать со следующими операциями:

Выражения, вычисление которых даёт значение true, будут заменены на 1, а те, которые дают false, — на 0. Значение ИСТИНА (true) может быть представлено как 1, true, on и yes, значение ЛОЖЬ — 0, false, off и no. Логические операции not, and, or (в таком порядке приоритета) возможно группировать с помощью скобок.

Некоторые правила фильтрации уже предустановлены и могут служить примерами для пользовательских выражений:

All

Filename Tag Mismatch

No Tag 1

No Tag 2

ID3v2.3.0 Tag

ID3v2.4.0 Tag

Tag 1 != Tag 2

Tag 1 == Tag 2

Incomplete

No Picture

Marked

Custom Filter

Если в выделенных файлах содержатся теги ID3v2.3, они будут преобразованы в теги ID3v2.4. Фреймы, которые не поддерживаются библиотекой TagLib, не будут учитываться. Преобразовываются только файлы без несохранённых изменений.

Если в выделенных файлах содержатся теги ID3v2.4, они будут преобразованы в теги ID3v2.3. Преобразовываются только файлы без несохранённых изменений.

Открывает простую панель инструментов для воспроизведения аудиофайлов. Панель содержит кнопки для стандартных действий (Воспроизвести или приостановить, Остановить воспроизведение, Предыдущая дорожка, Следующая дорожка, Закрыть), ползунки для регулирования позиции и громкости, а также индикатор текущей позиции. Если выбрано несколько файлов, будут воспроизводиться выбранные дорожки. Если же ничего не выбрано, будут воспроизводиться все файлы.

Переключает отображение панели инструментов.

Переключает отображение строки состояния, в которой показаны более длительные действия, такие как открытие или сохранение каталога.

Переключает отображение обложки.

Если флажок установлен, пустые теги будут скрыты автоматически. Кнопки -/+ позволяют вручную свернуть или развернуть разделы Файл, Тег 1 и Тег 2.

Открывает диалог настройки комбинаций клавиш для большинства функциональных возможностей программы. Доступны даже функции без соответствующего пункта меню или кнопки, например, переход к следующему файлу, предыдущему файлу, выбор всех файлов.

Открывает диалог настройки параметров приложения, который содержит разделы для настройки тегов, файлов, команд пользователя и параметров сети.

Параметры тегов доступны в разделе Теги, который разделён на четыре вкладки: Тег 1, Тег 2, Тег 3 и Все теги.

Если установлен флажок Отмечать усечённые поля, усечённые поля ID3v1.1 будут отмечены красным цветом. Текстовые поля тегов ID3v1.1 могут иметь не более 30 символов, а комментарии — не более 28. Также ограничено количество символов в полях жанра и нумерации дорожек, поэтому поля могут быть усечены при импорте или преобразовании из ID3v2. Усечённые поля и сам файл будут отмечены красным цветом. После редактирования поля такое выделение цветом будет снято.

Параметр Кодировка текста для тегов ID3v1 позволяет установить набор символов, используемый в тегах ID3v1. Стандартной кодировкой является ISO-8859-1, поэтому рекомендуется не менять это значение. Однако существуют теги с другой кодировкой; такую кодировку возможно указать с помощью этого параметра, чтобы затем скопировать теги ID3v1 в ID3v2, где предусмотрена поддержка Unicode.

Флажок Использовать формат «номер дорожки / всего дорожек» определяет, будет ли поле номера дорожки тегов ID3v2 содержать просто номер дорожки или также и общее количество дорожек в каталоге.

Если установлен флажок Жанр как текст (вместо числовой строки), все жанры в тегах ID3v2 будут сохранены в виде текстовой строки, даже если существует соответствующий код для жанров в тегах ID3v1. Если этот флажок снят, жанры, для которых существует код в тегах ID3v1, будут сохранены в формате числа — кода жанра (в скобках для тега ID3v2.3). Таким образом, жанр Metal будет сохранён как «Metal» или «(9)» в зависимости от значения этого параметра. Жанры, которых нет в списке жанров в тегах ID3v1, всегда сохраняются в виде текстовой строки. Цель этой опции — улучшить совместимость с устройствами, которые неправильно интерпретируют коды жанров.

Если установлен флажок Файлы WAV с блоком id3 в нижнем регистре, блок RIFF, используемый для хранения тегов ID3v2 в файлах WAV, будет называться «id3» вместо «ID3». По умолчанию Kid3 и другие приложения, использующие TagLib, принимают как строчные, так и прописные варианты при чтении файлов WAV, но при записи тегов ID3v2 в файлы WAV они используют вариант «ID3». Поскольку существуют другие приложения, которые принимают только вариант «id3» (например, JRiver Media Center и foobar2000), эта опция позволяет создавать теги, которые могут быть прочитаны такими приложениями.

Если установлен флажок Отмечать нарушения стандарта, поля тегов ID3v2, нарушающие стандарт, будут отмечены красным. Подробная информация о нарушении отображается во всплывающей подсказке:

Документы по стандартам ID3, доступные в сети:

Кодировка текста определяет кодировку по умолчанию для фреймов ID3v2: ISO-8859-1, UTF16 или UTF8. UTF8 не поддерживается фреймами ID3v2.3.0; если указана эта кодировка, вместо неё будет использоваться кодировка UTF16. Для фреймов ID3v2.4.0 возможно использовать все три типа кодировки.

Версия, используемая для новых тегов позволяет указать, в какой версии должны создаваться новые теги ID3v2: 2.3.0 или 2.4.0.

Количество цифр в номере дорожки — это количество цифр в полях «Номер дорожки». Для заполнения используются нули в начале. Например, при значении 2 номер дорожки 5 устанавливается как «05».

Раскрывающийся список Имя поля комментария предназначен только для файлов Ogg/Vorbis и FLAC и задаёт имя поля, используемого для комментариев. Разные приложения используют разные названия, например, «COMMENT» используется приложением XMMS, а Amarok использует название «DESCRIPTION».

Формат изображений в файлах Ogg/Vorbis указывается в раскрывающемся списке Имя поля изображения, значениями которого могут быть «METADATA_BLOCK_PICTURE» или «COVERART». Первое значение — это официальный стандарт, использующий тот же формат, что и изображения в тегах FLAC. «COVERART» — это более ранний неофициальный способ включения изображений в комментарии Vorbis. Он позволяет обеспечивать совместимость с устаревшими проигрывателями.

Если установлен флажок Отмечать, если размер больше, чем (в байтах), файлы, содержащие встроенную обложку, размер которых превышает указанное значение в байтах, будут отмечены красным. Эта функция позволяет найти файлы, содержащие слишком большие изображения, которые могут не поддерживаться некоторыми приложениями или проигрывателями. Значение по умолчанию — 131072 байта (128 КБ).

Раздел Пользовательские жанры позволяет указывать жанры, отсутствующие в стандартном списке жанров, например, «Gothic Metal». Такие пользовательские жанры появятся в раскрывающемся списке Жанр в разделе Тег 2. В тегах ID3v1.1 возможно указывать только предустановленные жанры.

Список пользовательских жанров также возможно использовать для сокращения количества вариантов в раскрывающемся списке Жанр до тех, которые используются чаще всего. Например, если коллекция в основном содержит музыку в жанрах «Metal», «Gothic Metal», «Ancient» и «Hard Rock», внесите жанры в этот список и установите флажок Показывать только пользовательские жанры. Тогда раскрывающийся список Жанр в разделе Тег 2 будет содержать только эти четыре жанра, и искать их в полном списке не понадобится. В таком примере в списке жанров тега 1 будут отображаться только «Metal» и «Hard Rock», потому что эти два пользовательских жанра являются стандартными жанрами. Если флажок Показывать только пользовательские жанры не установлен, пользовательские жанры будут расположены в конце списка жанров.

Раздел Фреймы быстрого доступа позволяет указать, какие типы фреймов следует всегда отображать в разделе Тег 2. Такие фреймы затем можно будет добавить без предварительного использования кнопки Добавить. Чтобы изменить порядок фреймов быстрого доступа, воспользуйтесь функцией перетаскивания

Значение в раскрывающемся списке Имя поля номера дорожки используется только для данных RIFF INFO. С его помощью возможно указать название поля, используемого для номеров дорожек. Название поля номера дорожки не определено в исходном стандарте RIFF. В некоторых программах используется «ITRK», в других — «IPRT».

Раздел Формат тега содержит параметры для форматирования тегов. Если установлен флажок Автоматически применять формат, заданные параметры форматирования будут автоматически применяться при правке текста в строках редактирования. Флажок Проверка включает или отключает средства проверки значений номера дорожки по общему количеству дорожек и значений даты и времени. Раскрывающийся список Преобразование регистра позволяет выбрать один из вариантов изменения регистра: Нет изменений, Все строчные, Все прописные, Первая буква — прописная или Все первые буквы — прописные. Чтобы использовать локаль для преобразования букв между верхним и нижним регистром, воспользуйтесь расположенным ниже раскрывающимся списком. Список заменителей позволяет настроить произвольное преобразование строк. Чтобы добавить новое сопоставление, выделите ячейку в столбце Из, вставьте в неё текст, который следует заменить, затем перейдите к соответствующей ячейке в столбце В и вставьте в неё замещающий текст. Если текст, который следует заменить, начинается и заканчивается символом косой черты «/», предполагается, что использовано регулярное выражение. Для регулярных выражений, содержащих группы захвата в круглых скобках, соответствующие им заменители \1, \2, ... в ячейке столбца В заменяются строкой, захваченной соответствующей группой захвата. Чтобы удалить соответствие, укажите в поле Из пустое значение (например, нажав клавишу пробела, а затем клавишу Backspace). Добавить или удалить строки также возможно с помощью контекстного меню, которое вызывается щелчком правой кнопки мыши. Замена выполняется только в том случае, если установлен флажок Замена строк.

Таблица в разделе Рейтинг содержит сопоставления рейтинга (в звёздах) с текущими значениями, хранящимися в теге. Фреймы с данными рейтинга содержатся в строке «Рейтинг» списка фреймов. Для этих фреймов рейтинг устанавливается путём присвоения определённого количества звёзд из пяти звёзд. В разных форматах тегов и разных приложениях используются разные значения для привязки этой оценки в звёздах к значению, хранящемуся в теге. Чтобы отображать количество присвоенных звёзд корректно, программа Kid3 обращается к этой таблице. Ключом для поиска соответствующей информации является название фрейма, например, в комментариях Vorbis это будет «RATING», а в RIFF INFO — «IRTD». Для тегов ID3v2 используется комбинированный ключ, содержащий идентификатор «POPM» фрейма Popularimeter и поле «Email», отделённое точкой. Таким образом, для тегов ID3v2 существуют разные ключи, например, «POPM.Windows Media Player 9 Series» для привязки, используемой приложениями Windows Media Player и Explorer, и просто «POPM» для фреймов POPM с пустым полем «Email». Так как для «POPM» может существовать несколько записей, их порядок важен. Когда Kid3 добавляет новый фрейм Popularimeter, для определения значения, которое будет записано в поле «Email», используется первая запись «POPM». Это значение затем укажет привязку, которая будет использоваться для оценки в звёздах. Первая запись также используется как запись по умолчанию в случаях, когда ключ не был найден.

Помимо столбца Имя, содержащего ключи, в таблице представлены столбцы от 1 до 5 для значений параметров, которые будут записаны в тег, если дорожке будет назначена соответствующая оценка в звёздах. И наоборот, эти значения определяют количество звёзд, которые будут отображаться для значения, хранящегося во фрейме. Например, строка таблицы ниже содержит значения 1, 64, 128, 196, 255. Пороговые значения количества звёзд, которые будут показаны для оценок, лежащих между этими значениями, совместимы с используемыми в Windows® Explorer.

Таблица 1. Запись в таблице оценок

Флажок Загружать при запуске файлы, открытые при последнем выходе, расположенный на вкладке Файлы, позволяет Kid3 при следующем запуске открывать файл, который был открыт при последнем выходе. Флажок Сохранять метки времени изменения файлов позволяет сохранять метку времени изменения файла. Поле ввода Имя файла обложки предназначено для указания имени, которое будет предложено при экспорте встроенного изображения в файл. Раскрывающийся список Кодировка текста (экспорт, список воспроизведения) позволяет указать кодировку, используемую при записи файлов. Стандартный вариант System возможно изменить, например, если списки воспроизведения будут использоваться на другом устройстве.

Если установлен флажок Отмечать изменения, изменённые поля будут отмечены светло-серым фоном.

Раздел Список файлов позволяет указать, какие файлы следует отображать в списке файлов. С помощью раскрывающегося списка Фильтр возможно задать отображение в списке только тех файлов, которые имеют поддерживаемые расширения. Чтобы явным образом указать, какие каталоги следует отображать или исключить в списке файлов, воспользуйтесь полями ввода Включить папки и Исключить папки. Эти поля могут содержать выражения с подстановочными знаками, например, */Музыка/* для включения только каталога Музыка или */iTunes/* для исключения каталога iTunes из списка файлов. Если необходимо использовать несколько таких выражений, их следует разделить пробелами или точками с запятой.

Кнопки Имя файла из тега... и Тег из имени файла... в разделе Формат открывают диалоги для редактирования форматов, доступных в раскрывающихся списках Формат (со стрелками вверх и вниз), которые расположены в разделе «Файл» главного окна.

Формат имени файла содержит параметры формата имён файлов. Доступны те же параметры, что и в разделе Формат тега.

Вкладка Команды пользователя содержит таблицу со списком команд, доступных в контекстном меню списка файлов. Для важных действий наподобие удаления файлов рекомендуется установить флажок Подтвердить, чтобы перед выполнением команды появлялось всплывающее окно для подтверждения действия. Флажок Вывод позволяет отображать для просмотра вывод консольных команд (стандартный вывод и стандартные ошибки). В столбце Имя указано имя для отображения в контекстном меню. Столбец Команда содержит команду для выполнения. Для передачи аргументов доступны следующие коды:

Cпециальный код, @separator, возможно использовать в качестве команды, добавляющей разделитель в контекстное меню команд пользователя. Чтобы добавить пункты меню как вложенное меню, перед ними следует указать команду @beginmenu, а после них — команду @endmenu. Название меню будет определяться столбцом Имя команды @beginmenu.

Чтобы выполнить сценарии QML, используйте @qml в качестве названия команды. Путь к сценарию QML передаётся в качестве параметра. Соответствующие сценарии расположены в каталоге %{qmlpath}/script/ (в Linux® это обычно путь /usr/share/kid3/qml/script/, в Windows — qml/script/ внутри папки установки, в macOS® — в каталоге приложения kid3.app/Contents/Resources/qml/script/). Пользовательские сценарии возможно хранить в любом каталоге. Если в коде QML задействованы компоненты графического интерфейса, вместо @qml следует использовать @qmlview. Дополнительные параметры передаются в сценарий QML, где они будут доступны с помощью функции getArguments(). Обзор некоторых функций и свойств, доступных в QML, доступен в приложении Интерфейс QML.

Команда, которая будет вставлена вместо %{browser}, указывается в строке Веб-браузер. Команды, которые начинаются с символов %{browser}, используются для получения информации об аудиофайлах из Интернета. Например, команда

%{browser} http://lyricwiki.org/%u{artist}:%u{title}

проведёт поиск текста текущей песни на сайте LyricWiki[12]. Символ «u» в %u{artist} и %u{title} означает, что это закодированная в формате URL информация об исполнителе %{artist} и песне %{title}. Таким же образом возможно указывать собственные запросы; например, поиск изображений в Google[13] будет выглядеть следующим образом:

%{browser} http://images.google.com/images?q=%u{artist}%20%u{album}

Чтобы добавить обложку альбома в тег 2, возможно выполнить поиск изображений с помощью Google или Amazon, используя приведённые выше команды. Для добавления изображения в тег воспользуйтесь функцией перетаскивания или кнопкой Добавить; после нажатия этой кнопки следует выбрать фрейм изображения и импортировать файл изображения или вставить его из буфера обмена. Фреймы изображений поддерживаются для тегов ID3v2, MP4, FLAC, Ogg и ASF.

Чтобы добавить или удалить записи в таблице, воспользуйтесь контекстном меню.

На вкладке Сеть доступно только поле для вставки адреса прокси-сервера и (необязательно) порта, разделённых двоеточием. Прокси-сервер будет использоваться при импорте с интернет-сервера, если установлен соответствующий флажок.

Вкладка Модули позволяет подключить или отключить модули. Вкладка содержит два раздела. Первый, список Модули для работы с метаданными и приоритет, содержит модули, поддерживающие форматы аудиофайлов. В этом разделе важен порядок модулей, потому что приложение использует их по списку с первой позиции до последней. Некоторые форматы поддерживаются несколькими модулями, поэтому файлы будут открыты первым модулем из списка, поддерживающим их. Модуль TaglibMetadata поддерживает большинство форматов; если этот модуль будет расположен в верхней части списка, с его помощью будет возможно открыть большое количество файлов. Если требуется использовать другой модуль, расположите его над модулем TaglibMetadata. Подробные сведения о модулях для работы с метаданными и информация о том, почему рекомендуется использовать тот или иной модуль вместо TagLib, приведены далее.

Раздел Доступные модули отображает список остальных модулей. Их порядок в списке не важен. Эти модули подключаются и отключаются с помощью флажков.

Отключённые модули не будут загружены. Это позволяет оптимизировать потребление ресурсов и время запуска. Изменённые параметры этой вкладки вступят в силу только после перезапуска Kid3.

Открывает данное руководство пользователя.

Отображает краткую информацию о Kid3.

help [НАЗВАНИЕ-КОМАНДЫ]

Отображает справку о параметрах НАЗВАНИЕ-КОМАНДЫ или обо всех командах, если конкретная команда не указана.

timeout [ | default | off | ВРЕМЯ ]

Позволяет перезаписать стандартное значение времени ожидания выполнения команды. Выполнение команд командного интерфейса будет прервано, если будет превышено указанное время ожидания. Стандартное время ожидания для команд ls и albumart — 10 секунд, для команд autoimport и filter — 60 секунд, а для остальных команд — 3 секунды. Если требуется обработать большое количество файлов, эти временные рамки могут оказаться слишком жёсткими, поэтому предусмотрена возможность установить время ожидания для всех команд в значение ВРЕМЯ (в миллисекундах), отключить время ожидания вообще или оставить стандартные значения.

exit [force]

Выйти из приложения. Если в приложении изменённые несохранённые файлы, требуется параметр force.

cd [КАТАЛОГ]

Если не указано значение КАТАЛОГ, будет осуществлён переход в домашний каталог. Если значение указано, будет выполнен переход в указанный каталог. Если указан один или несколько путей к файлам, будет осуществлён переход в общий каталог, в котором хранятся эти файлы, а файлы будут выделены.

pwd

Показать полное имя текущего рабочего каталога.

ls

Список содержимого текущего каталога. Соответствует списку файлов в пользовательском интерфейсе Kid3. Пять символов перед именами файлов показывают состояние файла.

kid3-cli> ls
  1-- 01 Intro.mp3
> 12- 02 We Only Got This One.mp3
 *1-- 03 Outro.mp3

В этом примере все файлы имеют тег 1, второй файл также имеет тег 2, и он выделен. Третий файл изменён.

save

select [ | all | none | first | previous | next | ФАЙЛ... ]

Чтобы выделить все файлы, введите команду select all; чтобы снять выделение со всех файлов, введите команду select none. Чтобы последовательно перебрать файлы в текущем каталоге, воспользуйтесь командой select first, затем передвигайтесь вперёд по списку с помощью команды select next, либо назад с помощью команды select previous. Чтобы добавить к текущему выделению отдельные файлы, укажите их названия напрямую. Поддерживается использование подстановочных знаков, например, возможно указать select *.mp3 для выделения всех MP3-файлов в текущем каталоге.

kid3-cli> select first
kid3-cli> ls
> 1-- 01 Intro.mp3
  12- 02 We Only Got This One.mp3
 *1-- 03 Outro.mp3
kid3-cli> select next
kid3-cli> ls
  1-- 01 Intro.mp3
> 12- 02 We Only Got This One.mp3
 *1-- 03 Outro.mp3
kid3-cli> select *.mp3
kid3-cli> ls
> 1-- 01 Intro.mp3
> 12- 02 We Only Got This One.mp3
>*1-- 03 Outro.mp3

tag [НОМЕРА-ТЕГОВ]

Некоторые команды имеют необязательный параметр НОМЕРА-ТЕГОВ, который позволяет указать, над каким тегом следует выполнять команду (1, 2 или 3). Если этот параметр не указан, будут использованы номера тегов по умолчанию, которые указываются с помощью этой команды. Сразу после запуска будет установлено значение 12, то есть данные будут прочитаны из тега 2, если он будет обнаружен, либо из тега 1, если тег 2 обнаружен не будет; изменения будут вноситься в тег 2. Для параметра НОМЕРА-ТЕГОВ возможно указать значение 1, 2 или 3 для работы только с соответствующим тегом. Если параметр не указан, будет отображаться текущее значение параметра номеров тегов.

get [ | all | НАЗВАНИЕ-ФРЕЙМА ] [НОМЕРА-ТЕГОВ]

Эта команда используется для чтения значения определённого фрейма тега или получения информации обо всех фреймах тега (если не указан аргумент или используется параметр all). Изменённые фреймы отмечены символом «*».

kid3-cli> get
Файл: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo
  Название: 01 Intro.mp3
Тег 1: ID3v1.1
  Заголовок            Intro
  Исполнитель       One Hit Wonder
  Альбом                 Let's Tag
  Дата                     2013
  Номер дорожки   1
  Жанр                    Pop
kid3-cli> get title
Intro

Чтобы сохранить содержимое фрейма изображения в файл, воспользуйтесь командой

get picture:'/путь/к/каталогу.jpg'

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

get SYLT:'/путь/к/тексту.lrc'

Возможно получить данные только из определённого поля фрейма, например, get POPM.Email для поля Email во фрейме Popularimeter. Если в файле хранится несколько фреймов одного типа, следует указать соответствующий индекс в квадратных скобках: например, название первого из исполнителей в комментарии Vorbis возможно получить с помощью команды get performer[0], а второго — с помощью командыget performer[1].

Псевдополе под названием «selected» позволяет проверить, выделен ли фрейм: например, команда get artist.selected вернёт значение 1, если фрейм исполнителя выделен, либо 0, если фрейм не выделен.

set {НАЗВАНИЕ-ФРЕЙМА} {ЗНАЧЕНИЕ-ФРЕЙМА} [НОМЕРА-ТЕГОВ]

Эта команда позволяет указать значение определённого фрейма тега. Если параметр ЗНАЧЕНИЕ-ФРЕЙМА не указан, фрейм будет удалён.

kid3-cli> set remixer 'O.H. Wonder'

Чтобы установить содержимое фрейма изображения из файла, воспользуйтесь командой

set picture:'/путь/к/каталогу.jpg' 'Описание изображения'

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

set SYLT:'/путь/к/тексту.lrc' 'Описание текста'

Чтобы указать определённое поле внутри фрейма, следует указать название поля после точки. Например, чтобы установить значение поля счётчика фрейма Popularimeter, воспользуйтесь командой

set POPM.Counter 5

Спецификация полей применяется в том случае, когда нужно создать пользовательский фрейм TXXX с описанием «rating» вместо стандартного фрейма Popularimeter (такой метод оценки используется некоторыми модулями). Фрейм оценки TXXX возможно создать с помощью kid3-cli, однако сначала следует создать фрейм TXXX с описанием «rating», а затем указать значение оценки для этого фрейма.

kid3-cli> set rating ""
kid3-cli> set TXXX.Description rating
kid3-cli> set rating 5

Первая команда удалит существующий фрейм POPM, потому что, если такой фрейм существует, параметр set rating 5 установит значение фрейма POPM, а не TXXX. Другой способ установки значения — это использование команды set TXXX.Text 5, но она сработает корректно только в том случае, если нет других фреймов TXXX.

Чтобы установить несколько фреймов одинакового типа, укажите индекс в скобках; например, чтобы указать несколько исполнителей в комментарии Vorbis, воспользуйтесь командой

kid3-cli> set performer[0] 'Liza don Getti (soprano)'
kid3-cli> set performer[1] 'Joe Barr (piano)'

Чтобы выделить определённые фреймы перед действиями копирования, вставки или удаления, воспользуйтесь псевдополем «selected». Обычно выделены все фреймы. Чтобы снять выделение со всех фреймов, воспользуйтесь командой set '*.selected' 0, а затем, например, для выделения фрейма исполнителя, командой set artist.selected 1.

revert

Отменить все изменения в выбранных файлах (или во всех файлах, если файлы не выбраны).

import {ФАЙЛ} {НАЗВАНИЕ-ФОРМАТА} [НОМЕРА-ТЕГОВ]

Теги будут импортированы из файла ФАЙЛ в формате под названием НАЗВАНИЕ-ФОРМАТА (например, «CSV unquoted», подробные сведения доступны в описании функции «Импорт»).

Если указать tags для параметра ФАЙЛ, теги будут импортированы из других тегов. Вместо параметра НАЗВАНИЕ-ФОРМАТА следует указать параметры ИСТОЧНИК и ИЗВЛЕЧЕНИЕ, подробные сведения доступны в описании функции «Импорт из тегов...». Чтобы применить импорт из тегов к выделенным файлам, используйте tagsel вместо tags. Эта функция также поддерживает вывод полученного значения: укажите параметр ИЗВЛЕЧЕНИЕ со значением %{__return}(.+).

autoimport [ИМЯ-ПРОФИЛЯ] [НОМЕРА-ТЕГОВ]

Пакетный импорт на основе профиля НАЗВАНИЕ-ПРОФИЛЯ (смотрите описание функции «Автоматический импорт»; если профиль не указан, используется «All»).

albumart {URL-АДРЕС} [all]

Установить обложку альбома путём загрузки изображения с адреса URL-адрес. Правила, определённые в диалоге «Найти обложки», используются для преобразования обычных URL-адресов (например, Amazon) в адрес изображения. Чтобы установить обложку альбома из локального файла изображения, воспользуйтесь командой set.

kid3-cli> albumart
http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC

export {ФАЙЛ} {НАЗВАНИЕ-ФОРМАТА} [НОМЕРА-ТЕГОВ]

Экспорт тегов в файл ФАЙЛ в формате под названием НАЗВАНИЕ-ФОРМАТА (например, «CSV unquoted», смотрите описание функции «Экспорт»).

playlist

Создать список воспроизведения в формате, указанном в параметрах, подробные сведения доступны в описании функции «Создать список воспроизведения».

filenameformat

Применить формат имени файла, указанный в параметрах, подробные сведения доступны в описании функции «Применить формат имени файла».

tagformat

Применить формат тега, указанный в параметрах, подробные сведения доступны в описании функции «Применить формат тега».

textencoding

Применить кодировку текста, указанную в параметрах, подробные сведения доступны в описании функции «Применить кодировку текста».

renamedir [ФОРМАТ] [ | create | rename | dryrun ] [НОМЕРА-ТЕГОВ]

Переименовать или создать каталоги на основе значений в тегах в соответствии с заданным значением параметра ФОРМАТ (например, %{artist} - %{album}, подробные сведения доступны в описании функции «Переименовать каталог»). Если формат не задан, будет использован формат, указанный в диалоге Переименовать каталог. Режим по умолчанию — rename; для создания каталогов — create (следует указать явным образом). Действия по переименованию будут произведены немедленно; чтобы просто посмотреть, что должно быть сделано, воспользуйтесь опцией dryrun.

numbertracks [НОМЕР-ДОРОЖКИ] [НОМЕРА-ТЕГОВ]

Пронумеровать выделенные дорожки, начиная с номера НОМЕР-ДОРОЖКИ (если параметр не указан, нумерация начнётся с цифры 1).

filter [ | ИМЯ-ФИЛЬТРА | ФОРМАТ-ФИЛЬТРА ]

Отфильтровать файлы таким образом, чтобы отобразились только файлы, соответствующие фильтру ФОРМАТ-ФИЛЬТРА. Вместо выражения фильтра возможно использовать название предустановленного фильтра (например, «Несоответствие тега названию файла»), подробные сведения доступны в описании функции «Фильтр».

kid3-cli> filter '%{title} contains "tro"'
Запуск
  /home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
- 02 We Only Got This One.mp3
+ 03 Outro.mp3
Завершено
kid3-cli> ls
  1-- 01 Intro.mp3
  1-- 03 Outro.mp3
kid3-cli> filter All
Запуск
  /home/urs/One Hit Wonder - Let's Tag
+ 01 Intro.mp3
+ 02 We Only Got This One.mp3
+ 03 Outro.mp3
Завершено
kid3-cli> ls
  1-- 01 Intro.mp3
  12- 02 We Only Got This One.mp3
  1-- 03 Outro.mp3

to24

to23

fromtag [ФОРМАТ] [НОМЕРА-ТЕГОВ]

Указать имена выбранных файлов на основе тегов, например, fromtag '%{track} - %{title}' 1. Если формат не указан, будет использоваться формат, установленный в графическом интерфейсе.

totag [ФОРМАТ] [НОМЕРА-ТЕГОВ]

Установить содержание фреймов тегов на основе названий файлов, например, totag '%{albumartist} - %{album}/%{track} %{title}' 2. Если формат не указан, будет использован формат, установленный в графическом интерфейсе. Если формат названия файла не соответствует указанному шаблону, будет предпринята попытка использовать другие распространённые форматы.

syncto {НОМЕР-ТЕГА}

Копировать фреймы тега из одного тега в другой; например, чтобы заполнить тег ID3v2 данными из тега ID3v1, воспользуйтесь командой syncto 2.

copy [НОМЕР-ТЕГА]

Скопировать фреймы тега выбранного файла во внутренний буфер обмена. Команда paste позволяет установить эти фреймы в другой файл.

Чтобы скопировать только подмножество фреймов, воспользуйтесь псевдополем «selected» с командой set. Например, чтобы скопировать только фреймы номера диска и авторских прав, воспользуйтесь командой

set '*.selected' 0
set discnumber.selected 1
set copyright.selected 1
copy

paste [НОМЕР-ТЕГА]

Заполнить данные фреймов тегов выделенных файлов на основе содержимого буфера copy.

remove [НОМЕР-ТЕГА]

Удалить тег.

Возможно удалить только подмножество фреймов путём их выделения, как указано в описании команды copy.

config [ПАРАМЕТР] [ЗНАЧЕНИЕ]

Запрос или установка параметров конфигурации.

ПАРАМЕТР состоит из имени группы и имени свойства, разделённых точкой. Если ПАРАМЕТР не задан, будут отображаться все доступные группы. Если задано только имя группы, будут отображаться все доступные свойства группы. Если задана группа и свойство, будет отображаться текущее настроенное значение. Для изменения параметра возможно передать новое значение в качестве второго аргумента.

Если значение параметра представлено в виде списка, все элементы списка должны быть указаны как аргументы. Это значит, что для добавления элемента к существующему списку элементов необходимо передать все существующие элементы, указав после них новый элемент. В таком случае лучше использовать режим JSON; это позволит скопировать текущий список и добавить новый элемент.

kid3-cli -c "set title 'I\'ll be there for you'" /путь/к/каталогу

kid3-cli -c "autoimport 'Cover Art'" /путь/к/каталогу

kid3-cli -c "set comment '' 1" -c "set comment '' 2" \
-c "tagformat 1" -c "tagformat 2" /путь/к/каталогу/*.mp3

kid3-cli -c autoimport -c "syncto 1" -c fromtag -c playlist \
  /путь/к/каталогу/*.mp3

kid3-cli -c "filter 'ID3v2.4.0 Tag'" -c "select all" -c to23 \
  -c "set arranger ''" /путь/к/каталогу

#!/usr/bin/env python3
# Generate iTunes Sound Check from ReplayGain.
import os, sys, subprocess
def rg2sc(dirpath):
  for root, dirs, files in os.walk(dirpath):
    for name in files:
      if name.endswith(('.mp3', '.m4a', '.aiff', '.aif')):
        fn = os.path.join(root, name)
        rg = subprocess.check_output([
          'kid3-cli', '-c', 'get "replaygain_track_gain"',
           fn]).strip()
        if rg.endswith(b' dB'):
          rg = rg[:-3]
        try:
          rg = float(rg)
        except ValueError:
          print('Value %s of %s in not a float' % (rg, fn))
          continue
        sc = (' ' + ('%08X' % int((10 ** (-rg / 10)) * 1000) )) * 10
        subprocess.call([
          'kid3-cli', '-c', 'set iTunNORM "%s"' % sc, fn])
if __name__ == '__main__':
  rg2sc(sys.argv[1])

kid3-cli> {"method":"set","params":["artist","An Artist"]}
{"result":null}
kid3-cli> {"method":"get","params":["artist",2]}
{"result":"An Artist"}
kid3-cli> {"method": "get", "params": ["artist"]}
{
    "result": "An Artist"
}
kid3-cli> {"jsonrpc":"2.0","id":"123","method":"get","params":["artist"]}
{"id":"123","jsonrpc":"2.0","result":"An Artist"}

% cmake .
% make
% make install

dbus-send --dest=org.kde.kid3 --print-reply=literal \
/Kid3 org.kde.Kid3.setFrame int32:2 string:'Artist' \
string:'One Hit Wonder'

или, что проще, примените команду Qt(TM) qdbus (для изучения графического интерфейса приложения предназначена команда qdbusviewer):

qdbus org.kde.kid3 /Kid3 setFrame 2 Artist \
'One Hit Wonder'

boolean openDirectory(string path);

.PP path

Выгрузка тегов всех файлов, которые не были изменены или выбраны

Сохранение всех изменённых файлов

Получение подробного сообщения об ошибке, предоставляемого некоторыми методами

Отмена изменений в выбранных файлах

Запуск автоматического пакетного импорта

import Kid3 1.0
Kid3Script {
  onRun: {
    console.log("Hello world, folder is", app.dirName)
    Qt.quit()
  }
}

qml -apptype widget -I /usr/lib/kid3/plugins/imports /путь/к/Example.qml

qmlscene -I /usr/lib/kid3/plugins/imports /путь/к/Example.qml

import Kid3 1.0
Kid3Script {
  onRun: {
    app.firstFile()
    do {
      if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {
        console.log(app.getFrame(tagv2, "title"))
      }
    } while (app.nextFile())
  }
}

import Kid3 1.0
Kid3Script {
  onRun: {
    function doWork() {
      if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {
        console.log(app.getFrame(tagv2, "title"))
      }
      if (!app.nextFile()) {
        Qt.quit()
      } else {
        setTimeout(doWork, 1)
      }
    }
    app.firstFile()
    doWork()
  }
}

import Kid3 1.1
Kid3Script {
  onRun: {
    function doWork() {
      if (app.selectionInfo.tag(Frame.Tag_2).tagFormat) {
        app.setFrame(tagv2, "*.selected", false)
        app.setFrame(tagv2, "discnumber.selected", true)
        app.setFrame(tagv2, "copyright.selected", true)
        app.copyTags(tagv2)
      }
      if (!nextFile()) {
        Qt.quit()
      } else {
        setTimeout(doWork, 1)
      }
    }
    firstFile()
    doWork()
  }
}

Kid3Script — это обычный компонент QML, расположенный в каталоге модуля. Возможно использовать и любой другой компонент QML. Использование Kid3Script упрощает запуск функции сценария с помощью обработчика сигналов onRun. Кроме того, он предлагает несколько функций:

onRun: обработчик сигналов, который вызывается при запуске сценария
tagv1, tagv2, tagv2v1: постоянные для параметров тегов
script: доступ к функциям сценариев
configs: доступ к объектам конфигурации
getArguments(): список аргументов сценария
isStandalone(): true, если сценарий был запущен не в Kid3
setTimeout(callback, delay): запуск обратного вызова после задержки, указанной в миллисекундах
firstFile(): к первому выделенному файлу
nextFile(): к следующему выделенному файлу

В JavaScript и QML предусмотрен довольно ограниченный набор функций. Объект script имеет несколько дополнительных методов, в частности:

script.properties(obj): строка со свойствами Qt
script.writeFile(filePath, data): записать данные в файл, true, если успешно
script.readFile(filePath): прочитать данные из файла
script.removeFile(filePath): удалить файл, true, если успешно
script.fileExists(filePath): true, если файл существует
script.fileIsWritable(filePath): true, если файл доступен для записи
script.getFilePermissions(filePath): получить биты режима доступа к файлу
script.setFilePermissions(filePath, modeBits): указать биты режима доступа к файлу
script.classifyFile(filePath): получить класс файла (каталог — «/», символическая ссылка — «@», exe — «*»,
  файл « »)
script.renameFile(oldName, newName): переименовать файл, true, если успешно
script.copyFile(source, dest): скопировать файл, true, если успешно
script.makeDir(path): создать каталог, true, если успешно
script.removeDir(path): удалить каталог, true, если успешно
script.tempPath(): путь к временному каталогу
script.musicPath(): путь к каталогу с файлами музыки
script.listDir(path, [nameFilters], [classify]): список записей в каталоге
script.system(program, [аргументы], [миллисекунды]): синхронно запустить системную команду,
  [код выхода, стандартный вывод, стандартная ошибка], если не превышено время ожидания
script.systemAsync(program, [аргументы], [обратный вызов]): асинхронно запустить системную
команду, обратный вызов будет выполнен данными [код выхода, стандартный вывод, стандартная
ошибка]
script.getEnv(varName): получить значение переменной среды
script.setEnv(varName, value): указать значение переменной среды
script.getQtVersion(): строка версии Qt, например, «5.4.1»
script.getDataMd5(data): получить шестнадцатеричную строку хеша данных MD5
script.getDataSize(data): получить размер байтового массива
script.dataToImage(data, [формат]): создать изображение из байтов данных
script.dataFromImage(img, [формат]): получить байты данных из изображения
script.loadImage(filePath): загрузить изображение из файла
script.saveImage(img, filePath, [формат]): сохранить изображение в файл, true, если успешно
script.imageProperties(img): получить свойства изображения, карту, содержащую значения
  «width», «height», «depth» и «colorCount», возвращает пустое значение ,если изображение недействительно
script.scaleImage(img, width, [высота]): масштабировать изображение, возвращает масштабированное изображение

При использовании QML доступна большая часть функциональных возможностей Kid3. Программный интерфейс похож на тот, что используется для D-Bus. Для получения более подробной информации обратитесь к соответствующим заметкам.

app.openDirectory(path): открыть каталог
app.unloadAllTags(): выгрузить все теги
app.saveDirectory(): сохранить каталог
app.revertFileModifications(): отменить
app.importTags(tag, path, fmtIdx): импортировать файл
app.importFromTags(tag, source, extraction): импортировать из тегов
app.importFromTagsToSelection(tag, source, extraction): импортировать из тегов выделенных файлов
app.downloadImage(url, allFilesInDir): загрузить изображение
app.exportTags(tag, path, fmtIdx): экспортировать файл
app.writePlaylist(): записать список воспроизведения
app.getPlaylistItems(path): получить элементы списка воспроизведения
app.setPlaylistItems(path, items): установить элементы списка воспроизведения
app.selectAllFiles(): выделить все
app.deselectAllFiles(): снять выделение
app.firstFile([select], [onlyTaggedFiles]): до первого файла
app.nextFile([select], [onlyTaggedFiles]): до следующего файла
app.previousFile([select], [onlyTaggedFiles]): до предыдущего файла
app.selectCurrentFile([select]): выделить текущий файл
app.selectFile(path, [select]): выделить указанный файл
app.getSelectedFilePaths([onlyTaggedFiles]): получить пути к выделенным файлам
app.requestExpandFileList(): развернуть все
app.applyFilenameFormat(): применить формат имени файла
app.applyTagFormat(): применить формат тега
app.applyTextEncoding(): применить кодировку текста
app.numberTracks(nr, total, tag, [options]): пронумеровать дорожки
app.applyFilter(expr): отфильтровать
app.convertToId3v23(): преобразовать ID3v2.4.0 в ID3v2.3.0
app.convertToId3v24(): преобразовать ID3v2.3.0 в ID3v2.4.0
app.getFilenameFromTags(tag): получить имя файла из тегов
app.getTagsFromFilename(tag): получить теги из имени файла
app.getAllFrames(tag): получить объект со всеми фреймами
app.getFrame(tag, name): получить фрейм
app.setFrame(tag, name, value): установить фрейм
app.getPictureData(): получить данные из фрейма изображения
app.setPictureData(data): указать данные во фрейме изображения
app.copyToOtherTag(tag): скопировать данные тегов в другие теги
app.copyTags(tag): копировать
app.pasteTags(tag): вставить
app.removeTags(tag): удалить
app.playAudio(): воспроизвести
app.readConfig(): прочитать конфигурацию
app.applyChangedConfiguration(): применить конфигурацию
app.dirName: имя каталога
app.selectionInfo.fileName: имя файла
app.selectionInfo.filePath: абсолютный путь к файлу
app.selectionInfo.detailInfo: описание формата
app.selectionInfo.tag(Frame.Tag_1).tagFormat: формат тега 1
app.selectionInfo.tag(Frame.Tag_2).tagFormat: формат тега 2
app.selectionInfo.formatString(tag, format): заменить коды в строке формата
app.selectFileName(caption, dir, filter, saveFile): открыть диалоговое окно для
выбора файла
app.selectDirName(caption, dir): открыть диалоговое окно для выбора каталога

Для асинхронных действий обратные вызовы возможно связывать с сигналами.

function automaticImport(profile) {
  function onAutomaticImportFinished() {
    app.batchImporter.finished.disconnect(onAutomaticImportFinished)
  }
  app.batchImporter.finished.connect(onAutomaticImportFinished)
  app.batchImport(profile, tagv2)
}
function renameDirectory(format) {
  function onRenameActionsScheduled() {
    app.renameActionsScheduled.disconnect(onRenameActionsScheduled)
    app.performRenameActions()
  }
  app.renameActionsScheduled.connect(onRenameActionsScheduled)
  app.renameDirectory(tagv2v1, format, false)
}

Доступ к различным разделам конфигурации обеспечивается с помощью методов configs. Список их свойств возможно просмотреть с помощью консоли QML.

script.properties(configs.networkConfig())

Могут быть установлены такие свойства:

configs.networkConfig().useProxy = false

configs.batchImportConfig()
configs.exportConfig()
configs.fileConfig()
configs.filenameFormatConfig()
configs.filterConfig()
configs.findReplaceConfig()
configs.guiConfig()
configs.importConfig()
configs.mainWindowConfig()
configs.networkConfig()
configs.numberTracksConfig()
configs.playlistConfig()
configs.renDirConfig()
configs.tagConfig()
configs.tagFormatConfig()
configs.userActionsConfig()