Руководство пользователя Kid3

Urs Fleisch

Разработка программного обеспечения 

Мария Шикунова

Перевод на русский язык 

3.8.6

Аннотация

Kid3 — это приложение для эффективного редактирования тегов ID3v1 и ID3v2 в MP3-файлах, поддерживающее также теги файлов Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF и модулей трекеров (MOD, S3M, IT, XM). Приложение позволяет легко указывать значения для тегов в разных файлах (например, название альбома, исполнителя, год и жанр во всех файлах внутри одного альбома) и создавать теги из имён файлов и наоборот.


Содержание

Обзор
Параметры
kid3
kid3-qt
kid3-cli
1. Введение
2. Работа с Kid3
Возможности Kid3
Пример использования
3. Список команд
Элементы графического интерфейса
Список файлов
Редактирование списка воспроизведения
Список каталогов
Файл
Тег 1
Тег 2
Тег 3
Список фреймов
Синхронизация текста песни с временными кодами событий
Меню «Файл»
Меню «Правка»
Меню «Сервис»
Меню «Настройка»
Меню «Справка»
4. kid3-cli
Команды
Справка
Время ожидания
Выйти из приложения
Сменить каталог
Показать полное имя текущего каталога
Список каталогов
Сохранить изменённые файлы
Выбрать файл
Выбрать тег
Получить фрейм тега
Указать фрейм тега
Отменить изменения
Импортировать из файла
Автоматический импорт
Загрузить обложку
Экспортировать в файл
Создать список воспроизведения
Применить формат имени файла
Применить формат тега
Применить кодировку текста
Переименовать каталог
Пронумеровать дорожки
Фильтр
Преобразовать ID3v2.3 в ID3v2.4
Преобразовать ID3v2.4 в ID3v2.3
Имя файла из тега
Тег из имени файла
Тег в другой тег
Копировать
Вставить
Убрать
Настроить Kid3
Примеры
Формат JSON
5. Авторские права и лицензия
A. Установка
Как получить Kid3
Требования
Сборка и установка
Настройка
B. Интерфейс D-Bus
Примеры D-Bus
Программный интерфейс D-Bus
Открытие файлов или каталогов
Выгрузка тегов всех файлов, которые не были изменены или выбраны
Сохранение всех изменённых файлов
Получение подробного сообщения об ошибке, предоставляемого некоторыми методами
Отмена изменений в выбранных файлах
Запуск автоматического пакетного импорта
Импорт тегов из файла
Импорт тегов из других тегов
Импорт тегов из других тегов выбранных файлов
Загрузка обложки альбома
Экспорт тегов в файл
Создание нового списка воспроизведения
Получение элементов списка воспроизведения
Установка элементов списка воспроизведения
Выход из приложения
Выделение всех файлов
Отмена выделения всех файлов
Установка первого файла в качестве текущего файла
Установка предыдущего файла в качестве текущего файла
Установка следующего файла в качестве текущего файла
Выделение первого файла
Выделение предыдущего файла
Выделение следующего файла
Выделение текущего файла
Разворачивание или сворачивание текущего элемента, если это каталог
Применение формата имени файла
Применение формата тега
Применить кодировку текста
Установка имени каталога из тегов
Установка последовательной нумерации дорожек для выделенных файлов
Фильтр файлов
Преобразование тегов ID3v2.3 в ID3v2.4
Преобразование тегов ID3v2.4 в ID3v2.3
Получение пути к каталогу
Получение имени текущего файла
Установка имени выделенного файла
Установка формата, который будет использован при установке названий файлов на основе тегов
Установка названий выделенных файлов на основе тегов
Получение значения фрейма
Установка значения фрейма
Получение всех фреймов тега
Получение технической информации о файле
Установка тега на основе имени файла
Установка тега на основе другого тега
Копирование тега
Вставка тега
Удаление тега
Повторная обработка параметров конфигурации
Воспроизведение выбранных файлов
C. Интерфейс QML
Примеры QML
Программный интерфейс QML
Kid3Script
Поддержка сценариев
Контекст приложений
Объекты конфигурации

Список таблиц

3.1. Привязки унифицированных названий фреймов в различных форматах
3.2. Запись в таблице оценок

Обзор

kid3 [ --help | --author | --version | --license | --desktopfile ФАЙЛ ] [ФАЙЛ...]

kid3-qt [--portable] [Параметры Qt] [ФАЙЛ...]

kid3-cli [--portable] [--dbus] [ -h | --help ] [-c КОМАНДА1] [-c КОМАНДА2...] [ФАЙЛ...]

Параметры

Содержание

kid3
kid3-qt
kid3-cli
--portable

Сохранить параметры в файл kid3.ini в каталоге приложения.

ФАЙЛ

Если ФАЙЛ — это путь к каталогу, то он будет открыт. Если указан один или несколько путей к файлам, откроется общий каталог, а файлы будут выделены.

kid3

--help

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

--author

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

--version

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

--license

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

--desktopfile ФАЙЛ

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

kid3-qt

Параметры Qt

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

kid3-cli

--dbus

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

-c

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

-h|--help

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

Глава 1. Введение

Kid3 — это приложение для эффективного редактирования тегов ID3v1 и ID3v2 в MP3-файлах. Большинство MP3-проигрывателей позволяют редактировать эти теги, но не настолько комфортным и простым способом. Более того, приложение поддерживает теги в файлах Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF и модулях трекеров (MOD, S3M, IT, XM).

Kid3 не создаёт и не кодирует файлы в формате MP3, это приложение предназначено для редактирования тегов ID3 во всех файлах в альбоме с помощью нескольких щелчков кнопкой мыши или нажатий комбинаций клавиш. Большинство других программ позволяют редактировать теги только одного типа (либо ID3v1, либо ID3v2), в то время как Kid3 предоставляет возможность свободного редактирования и преобразования тегов обоих типов, а также позволяет получить доступ ко всем тегам ID3v2. Возможно установить одинаковые значения для тегов сразу в нескольких файлах, например, указать одинаковые значения для записей исполнителя, альбома, года и жанра для всех файлов в альбоме. Если информация для тегов содержится в имени файла, теги могут быть автоматически установлены на основе имени файла. Также возможно установить имя файла в соответствии с любыми тегами, найденными в этом файле.

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

Данные тегов полных альбомов доступны на gnudb.org, MusicBrainz, Discogs, Amazon, а также на других ресурсах. Формат импорта возможно настраивать произвольным образом с помощью регулярных выражений.

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

Глава 2. Работа с Kid3

Возможности Kid3

  • Редактирование тегов ID3v1.1

  • Редактирование всех фреймов ID3v2.3 и ID3v2.4

  • Одновременное редактирование тегов нескольких файлов

  • Преобразование тегов ID3v1 и ID3v2 между собой

  • Редактирование тегов MP3, Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV и AIFF

  • Создание тегов на основе имени файла

  • Создание тегов по содержимому полей тегов

  • Создание названий файлов по тегам

  • Создание и изменение имён каталогов по тегам

  • Создание файлов списков воспроизведения

  • Автоматическое преобразование регистра и переноса строк

  • Импорт данных из gnudb.org, MusicBrainz, Discogs, Amazon и других источников

  • Экспорт данных в форматах CSV, HTML, списков воспроизведения, Kover XML и других. Экспортированные файлы в формате CSV возможно заново импортировать

Пример использования

Этот раздел описывает обычный сеанс работы в Kid3. Предположим, что есть каталог, в котором содержатся файлы в формате MP3 с дорожками из альбома «Let's Tag» группы «One Hit Wonder». Каталог с файлами назван в формате «Исполнитель - Альбом», в этом примере — «One Hit Wonder - Let's Tag». В каталоге содержатся файлы дорожек в формате «название дорожки.mp3», что довольно удобно, так как названия файлов остаются короткими (это важно для мобильных MP3-проигрывателей с небольшими дисплеями) и располагаются в надлежащем порядке при упорядочении списка по алфавиту (это важно при использовании аппаратного MP3-проигрывателя, который воспроизводит дорожки в алфавитном порядке или в том порядке, в котором они записаны на компакт-диске; этот порядок будет алфавитным в случае выполнения команды mkisofs). Кроме этого, информация об исполнителе и альбоме уже содержится в названии каталога, и её не обязательно дублировать в названии файла. В этом примере список файлов в каталоге будет выглядеть так:

01 Intro.mp3

02 We Only Got This One.mp3

03 Outro.mp3

Этим файлам ещё не присвоены теги, их нужно создать с помощью Kid3. Для этого следует воспользоваться пунктом меню ФайлОткрыть (или кнопкой на панели инструментов) и выделить один из файлов в этом каталоге. Все файлы будут отображаться в списке файлов. Чтобы не усложнять себе задачу, для создания тегов воспользуемся данными из названия каталога и имён файлов. Для этого следует выделить все файлы, а затем нажать кнопку В: Тег 1 в разделе Файл. Будут установлены значения заголовка, исполнителя, альбома и дорожки для всех файлов. Чтобы установить значение года и жанра для всех файлов, следует, не снимая выделения, ввести «2002» в поле Дата и выбрать, например, «Pop» в раскрывающемся списке Жанр. Чтобы установить только эти два значения, приложение автоматически установит флажки только на эти два пункта. Далее возможно изменить выделение, выделив только первый файл: как можно убедиться, всем тегам присвоены корректные значения. Чтобы проверить теги остальных файлов, их следует выделить один за другим. Если теги установлены корректно, воспользуйтесь пунктом меню ФайлСохранить (или кнопкой на панели инструментов). Пункт меню ФайлСоздать список воспроизведения (или кнопка на панели инструментов) позволяет создать файл под названием «One Hit Wonder - Let's Tag.m3u» в том же каталоге.

Глава 3. Список команд

Элементы графического интерфейса

Графический интерфейс Kid3 состоит из шести разделов: слева расположены списки файлов и каталогов, а справа находятся разделы Файл, Тег 1, Тег 2 и Тег 3.

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

  • Alt+Влево: перейти к предыдущему разделу (Command+[ в macOS®)

  • Alt+Вправо: перейти к следующему разделу (Command+] в macOS®)

  • Ctrl+Shift+V: из другого тега

  • Ctrl+C: копировать

  • Ctrl+V: вставить

  • Shift+Delete: удалить

  • F2: изменить

  • Insert: добавить

  • Delete: удалить

Список файлов

Список файлов содержит имена всех файлов в открытом каталоге, которые соответствуют выбранному фильтру имён (обычно это *.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 развернёт дерево текущего каталога)

  • Свернуть все: сворачивает всё дерево каталога

  • Переименовать: меняет имя файла

  • Переместить в корзину: перемещает файл в корзину

  • Воспроизвести: воспроизводит файл; подробнее об этом пункте контекстного меню рассказано в описании функции «Воспроизведение». Если выбранный файл — это список воспроизведения, будут воспроизводиться все файлы списка воспроизведения.

  • Редактировать: позволяет отредактировать список воспроизведения, подробные сведения об этом пункте контекстного меню приводятся в разделе «Редактирование списка воспроизведения».

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

Редактирование списка воспроизведения

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

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

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

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

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

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

Список каталогов

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

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

Файл

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

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

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

  • %s %{title} Заголовок (композиции)

  • %a %{artist} Исполнитель

  • %l %{album} Альбом

  • %c %{comment} Комментарий

  • %y %{year} Год

  • %t %{track} Номер дорожки (например, 01)

  • %t %{track.n} Номер дорожки с шириной поля n (например, 001 для %{track.3})

  • %T %{tracknumber} Номер дорожки (без нулей в начале, например, 1)

  • %g %{genre} Жанр

  • %{ignore} Игнорируется при создании тегов из имени файла

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

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

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

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

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

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

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

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

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

  • Исполнитель - Альбом/Дорожка Композиция

  • Альбом/Дорожка - Исполнитель - Композиция

  • /Исполнитель - Альбом - Дорожка - Композиция

  • Альбом/Исполнитель - Дорожка - Композиция

  • Альбом/Исполнитель - Композиция

  • Исполнитель/Альбом/Дорожка Композиция

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

Тег 1

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

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

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

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

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

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

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

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

Тег 2

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