Підручник з Kid3

Urs Fleisch

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

Юрій Чорноіван

Переклад українською 

3.8.5

Анотація

Kid3 — програма для ефективного редагування міток ID3v1 і ID3v2 у файлах MP3. Крім того, передбачено можливість редагування міток у файла Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF і модулях tracker (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...] [ФАЙЛ...]

Параметри

--portable

Зберегти файл налаштувань до kid3.ini у теці програми.

ФАЙЛ

Якщо ФАЙЛ є шляхом до теки, буде відкрито теку. Якщо вказано один або декілька шляхів до файлів, буде відкрито спільну теку цих файлів, а файли буде позначено.

kid3

--help

Показати довідку щодо параметрів.

--author

Вивести дані щодо авторства програми.

--version

Вивести дані щодо версії програми.

--license

Вивести дані щодо умов ліцензування на програму.

--desktopfile ФАЙЛ

Базова назва файла для стільничного запису цієї програми.

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 і модулях tracker (MOD, S3M, IT, XM).

Kid3 не створює і не кодує файли у форматі MP3. Програму призначено для ефективного редагування міток ID3 усіх файлів в альбомі. Для цього достатньо декількох клацань кнопкою миші або натискань комбінацій клавіш. Там, де більшість інших програм можуть редагувати або мітки ID3v1, або мітки ID3v2, Kid3 надає вам повний доступ до редагування обох версій, перетворення міток у цих двох форматах та доступ до усіх міток ID3v2. Можна встановлювати однакове значення для міток у декількох файлах одночасно, наприклад, вказати однакове значення для записів виконавця, альбому, року та жанру для усіх файлів у альбомі. Якщо дані для міток містяться у назвах файлів, можна автоматично встановити мітки на основі назви файла. Передбачено можливість визначення назви файла за будь-якими мітками, які у ньому зберігаються.

Крім того, у завданні з редагування передбачено підтримку автоматичної заміни символів або підрядків, наприклад, вилучення некоректних символів із назв файлів. Автоматичне визначення регістру символів спрощує використання однорідної схеми іменування для усіх міток.

Дані міток для цілих альбомів можна отримувати з gnudb.org, TrackType.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, TrackType.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