O Manual do Kid3

Urs Fleisch

Desenvolvimento da aplicação 

José Pires

Tradução 

3.9.2

Resumo

O Kid3 é uma aplicação para editar as marcas de ID3v1 e ID3v2 nos ficheiros MP3 de forma eficiente. Da mesma forma, também são suportadas as marcas nos ficheiros Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF e módulos do Tracker (MOD, S3M, IT, XM). É fácil configurar as marcas de vários ficheiros com os mesmos valores (p.ex. álbum, artista, ano e género em todos os ficheiros do mesmo álbum) e gerar as marcas a partir do nome do ficheiro ou vice-versa.


Índice

Sintaxe
Opções
kid3
kid3-qt
kid3-cli
1. Introdução
2. Utilização do Kid3
Funcionalidades do Kid3
Exemplo de Utilização
3. Referência de Comandos
Os Elementos da GUI
Lista de Ficheiros
Editar a Lista de Reprodução
Lista de Pastas
Ficheiro
Marca 1
Marca 2
Marca 3
Lista de Pacotes
Letras Sincronizadas e Códigos de Tempos Sincronizados
Capítulos nos Ficheiros MP4
O Menu Ficheiro
O Menu Editar
O Menu Ferramentas
O Menu Configuração
O Menu Ajuda
4. kid3-cli
Comandos
Ajuda
Tempo-limite
Sair da aplicação
Mudar de pasta
Imprime o nome da pasta actual
Lista de pastas
Gravar os ficheiros alterados
Seleccionar o ficheiro
Seleccionar a marca
Obter os dados da marca
Modificar os dados da marca
Reverter
Importar de ficheiro
Importação automática
Obter as imagens da capa do álbum
Exportar para um ficheiro
Criar a lista de reprodução
Aplicar o formato de nomes dos ficheiros
Aplicar o formato das marcas
Aplicar a codificação do texto
Mudar o nome da pasta
Numerar as faixas
Filtro
Converter o ID3v2.3 para ID3v2.4
Converter o ID3v2.4 para ID3v2.3
Nome do ficheiro a partir da marca
Marca a partir do nome do ficheiro
Marca para outra marca
Copiar
Colar
Remover
Configurar o Kid3
Executar um binário ou um programa em QML
Exemplos
Formato JSON
5. Créditos e Licença
A. Instalação
Como obter o Kid3
Requisitos
Compilação e Instalação
Configuração
B. A Interface de D-Bus
Exemplos de D-Bus
API de D-Bus
Abrir um ficheiro ou pasta
Descarrega as marcas de todos os ficheiros que não estejam modificados ou seleccionados
Grava todos os ficheiros modificados
Obtém uma mensagem de erro detalhada oferecida por alguns dos métodos
Reverte as modificações nos ficheiros seleccionados
Inicia uma importação automática em lote
Importar as marcas de um ficheiro
Importar as marcas de outras marcas
Imptrar as marcas de outras marcas nos ficheiros seleccionados
Obter as imagens da capa do álbum
Exportar as marcas para um ficheiro
Criar uma lista de reprodução
Obter os itens de uma lista de reprodução
Define os itens de uma lista de reprodução
Sair da aplicação
Seleccionar todos os ficheiros
Deseleccionar todos os ficheiros
Configura o primeiro ficheiro como o ficheiro actual
Configura o ficheiro anterior como sendo o actual
Configura o ficheiro seguinte como sendo o actual
Selecciona o primeiro ficheiro
Seleccionar o ficheiro anterior
Seleccionar o ficheiro seguinte
Seleccionar o ficheiro actual
Expande ou fecha o item do ficheiro actual se for uma pasta
Aplicar o formato de nomes dos ficheiros
Aplicar o formato das marcas
Aplicar a codificação do texto
Definir o nome da pasta a partir das marcas
Define os números das faixas subsequentes nos ficheiros seleccionados
Filtrar os ficheiros
Converter as marcas de ID3v2.3 para ID3v2.4
Converter as marcas de ID3v2.4 para ID3v2.3
Obter a localização da pasta
Obtém o nome do ficheiro actual
Define o nome do ficheiro seleccionado
Define o formato a usar quando definir o nome do ficheiro a partir das marcas
Configura os nomes dos ficheiros para os ficheiros seleccionados a partir das marcas
Obter o valor do pacote
Configurar o valor do pacote
Obter todos os pacotes de uma marca
Obter informações técnicas sobre o ficheiro
Configurar uma marca a partir do nome do ficheiro
Configurar uma marca a partir de outra marca
Copiar a marca
Colar a marca
Remover a marca
Volta a processar a configuração
Reproduz os ficheiros seleccionados
C. Interface em QML
Exemplos em QML
API em QML
Kid3Script
Funções de Programação
Contexto da Aplicação
Objectos de Configuração

Lista de Tabelas

3.1. Associação dos Tipos de Pacotes Unificados aos Vários Formatos
3.2. Elemento na Tabela de Classificação

Sintaxe

kid3 [ --help | --author | --version | --license | --desktopfile FICHEIRO ] [FICHEIRO...]

kid3-qt [--portable] [opções do Qt] [FICHEIRO...]

kid3-cli [--portable] [--dbus] [ -h | --help ] [-c COMANDO1] [-c COMANDO2...] [FICHEIRO...]

Opções

--portable

Guarda a configuração no ficheiro kid3.ini dentro da pasta da aplicação.

FICHEIRO

Se o FICHEIRO for a localização de uma pasta, a mesma será aberta. Se forem indicados um ou mais ficheiros, a sua pasta comum é aberta, ficando os ficheiros seleccionados.

kid3

--help

Mostra a ajuda acerca das opções.

--author

Mostra informações sobre o autor.

--version

Mostra a informação da versão.

--license

Mostra informações acerca da licença.

--desktopfile FICHEIRO

O nome de base do ficheiro do item '.desktop' para esta aplicação.

kid3-qt

Opções do Qt

Veja o qt5options(7).

kid3-cli

--dbus

Activa a interface de D-Bus.

-c

Executa um comando. É possível passar várias opções -c, sendo as mesmas executadas em sequência. Veja a secção acerca do kid3-cli para obter uma descrição dos comandos disponíveis.

-h|--help

Mostra ajuda sobre as opções e comandos.

Capítulo 1. Introdução

O Kid3 é uma aplicação para editar as marcas ID3v1 e ID3v2 nos ficheiros MP3 de forma eficiente. Estas marcas poderão ser editadas pela maioria dos leitores de MP3, mas não de forma confortável e eficiente. Para além disso, também são suportadas as marcas nos ficheiros Ogg/Vorbis, Opus, DSF, FLAC, MPC, APE, MP4/AAC, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF e nos módulos do Tracker (MOD, S3M, IT, XM).

O Kid3 não captura nem codifica os ficheiros MP3, mas está vocacionado para editar as marcas de ID3 de todos os ficheiros de um álbum de forma eficiente, i.e. com o mínimo de 'clicks' de rato e combinações de teclas possível. Embora a maioria dos outros programas consigam editar as marcas de ID3v1 ou ID3v2, o Kid3 tem controlo completo sobre ambas as versões, consegue converter as marcas entre os dois formatos e tem acesso a todas as marcas de ID3v2. As marcas dos vários ficheiros poderão ser configuradas com o mesmo valor, p.ex. o artista, o álbum, o ano e o género de todos os ficheiros de um álbum tipicamente têm os mesmos valores e poderão ser definidas em conjunto. Se a informação das marcas estiver contida no nome do ficheiro, as marcas poderão ser configuradas automaticamente a partir do nome do ficheiro. Também é possível configurar o nome do ficheiro de acordo com as marcas encontras no ficheiro em formatos arbitrários.

A tarefa de edição ainda passa pela substituição automática de caracteres ou sub-textos, por exemplo para remover caracteres proibidos dos nomes dos ficheiros. O controlo automático das maiúsculas ou minúsculas facilita a utilização de uma nomenclatura consistente em todas as marcas.

Poderá obter a informação das marcas para álbuns inteiros a partir do gnudb.org, MusicBrainz, Discogs, Amazon ou de outras fontes de listas de faixas. O formato de configuração é facilmente configurável à custa de expressões regulares.

Por favor comunique todos os problemas ou pedidos de funcionalidades ao autor.

Capítulo 2. Utilização do Kid3