kid3-core - Online na nuvem

PROGRAMA:

NOME

kid3, kid3-qt, kid3-cli - Etiquetador Kid3 ID3

SINOPSE

kid3 [--Socorro | --help-qt | --help-kde | --ajuda-tudo
|--autor | --versão | --licença] [ARQUIVO...]

garoto3-qt [Opções Qt] [ARQUIVO...]

kid3-cli [-h | --Socorro] [-c COMANDO1] [-c COMANDO2...] [ARQUIVO...]

OPÇÕES

ARQUIVO
If ARQUIVO é o caminho para um diretório, ele será aberto. Se um ou mais caminhos de arquivo forem
dado, seu diretório comum é aberto e os arquivos são selecionados.

kid3
--Socorro
Mostra ajuda sobre as opções.

--help-qt
Mostrar opções específicas do Qt, consulte opções(7).

--help-kde
Mostrar opções específicas do KDE, veja kdeopções(7).

--ajuda-tudo
Mostra todas as opções.

--autor
Mostra as informações do autor.

--versão
Mostra as informações da versão.

--licença
Mostra as informações da licença.

garoto3-qt
Opções Qt
See opções(7), no entanto, as opções têm "-" como prefixo, não "-".

kid3-cli
-c
Execute um comando. Múltiplo -c as opções são possíveis, são executadas em sequência.
Veja a seção sobre kid3-cli para uma descrição dos comandos disponíveis.

-h|--Socorro
Mostra ajuda sobre opções e comandos.

INTRODUÇÃO

Kid3 é uma aplicação que permite editar de forma eficiente as tags ID3v1 e ID3v2 em arquivos MP3.
Essas tags podem ser editadas pela maioria dos tocadores de MP3, mas não de uma forma muito confortável e eficiente
caminho. Além disso, as tags em Ogg / Vorbis, Opus, DSF, FLAC, MPC, APE, MP4 / AAC, MP2, Speex,
TrueAudio, WavPack, WMA, WAV, arquivos AIFF e módulos de rastreamento (MOD, S3M, IT, XM) são
suportado também.

Kid3 não pega nem codifica arquivos MP3, mas é direcionado para editar as tags ID3 de todos
arquivos de um álbum de maneira eficiente, ou seja, com apenas alguns cliques do mouse e pressionamentos de tecla
possível. Onde a maioria dos outros programas podem editar tags ID3v1 ou ID3v2, Kid3 tem
controle sobre ambas as versões, pode converter tags entre os dois formatos e tem acesso a todos
Tags ID3v2. Tags de vários arquivos podem ser definidas com o mesmo valor, por exemplo, o artista, álbum,
ano e gênero de todos os arquivos de um álbum normalmente têm os mesmos valores e podem ser definidos
juntos. Se as informações para as tags estiverem contidas no nome do arquivo, as tags podem ser
definido automaticamente a partir do nome do arquivo. Também é possível definir o nome do arquivo de acordo
às tags encontradas no arquivo em formatos arbitrários.

A tarefa de edição é ainda suportada pela substituição automática de caracteres ou
substrings, por exemplo, para remover caracteres ilegais de nomes de arquivos. Controle automático de
caracteres maiúsculos e minúsculos facilitam o uso de um esquema de nomenclatura consistente em todos
Tag.

As informações de tag para álbuns completos podem ser obtidas em gnudb.org[1], Tracktype.org[2],
MusicBrainz[3], Discogs[4], Amazon[5] ou outras fontes de listas de faixas. O formato de importação
é livremente configurável por expressões regulares.

Por favor, relate quaisquer problemas ou solicitações de recursos ao autor.

USANDO KID3

Kid3 características
· Editar tags ID3v1.1

· Editar todos os frames ID3v2.3 e ID3v2.4

· Editar tags de vários arquivos

· Converter entre tags ID3v1 e ID3v2

· Editar MP3, Ogg / Vorbis, Opus, DSF, FLAC, MPC, APE, MP4 / AAC, MP2, Speex, TrueAudio,
Tags WavPack, WMA, WAV e AIFF

· Gerar tags de nome de arquivo

· Gerar tags a partir do conteúdo dos campos de tag

· Gerar nome de arquivo a partir de tags

· Gerar e alterar nomes de diretório de tags

· Gerar arquivo de lista de reprodução

· Conversão automática de maiúsculas e minúsculas e tradução de string

· Importado de gnudb.org[1], Tracktype.org[2], MusicBrainz[3], Discogs[4], Amazon[5] e
outras fontes de dados

· Exporte como CSV, HTML, lista de reprodução, Kover XML e outros formatos. Arquivos CSV exportados podem ser
importado novamente.

Exemplo Uso
Esta seção descreve uma sessão típica com Kid3. Vamos supor que temos um diretório
contendo arquivos MP3 com as faixas do álbum "Let's Tag" da banda "One Hit
Wonder ". O diretório é nomeado no formato" artista - álbum ", no nosso caso One Hit Wonder
- Vamos marcar. O diretório contém as faixas no formato "título da faixa.mp3", que eu
acho que é útil porque os nomes dos arquivos são curtos (importante ao usar leitores de MP3 móveis
com telas pequenas) e na ordem correta quando classificado em ordem alfabética (importante quando
usando tocadores de MP3 de hardware que reproduzem as faixas em ordem alfabética ou na ordem em
que são gravados em CD e essa ordem é alfabética ao usar mkisofs) além do mais
isso, as informações do artista e do álbum já estão no nome do diretório e não têm
a ser repetido no nome do arquivo. Mas, de volta ao nosso exemplo, a listagem do diretório parece
esta:

01 Introdução.mp3

02 Só Temos Este.mp3

03 Outro.mp3

Esses arquivos ainda não têm tags e queremos gerá-los usando Kid3. Usamos Open (File
menu ou barra de ferramentas) e selecione um dos arquivos neste diretório. Todos os arquivos serão
exibido na caixa de listagem de arquivos. Preguiçosos como somos, queremos usar as informações do
nomes de diretório e arquivo para gerar tags. Portanto, selecionamos todos os arquivos e, em seguida, clique no
Para: Botão Marcar 1 na seção Arquivo. Isso definirá o título, artista, álbum e faixa
valores em todos os arquivos. Para definir os valores de ano e gênero de todos os arquivos, mantemos todos os arquivos
selecione e digite "2002" para o Ano e selecione "Pop" na caixa de combinação Gênero. Pôr
apenas esses dois valores, suas caixas de seleção são marcadas automaticamente e todas as outras caixas de seleção
são deixados desmarcados. Agora mudamos a seleção selecionando apenas o primeiro arquivo e
veja se todas as tags contêm os valores corretos. As marcas dos outros arquivos podem ser verificadas
também selecionando-os um por um. Quando estivermos satisfeitos com as tags, usamos Salvar (Arquivo
menu ou barra de ferramentas). Selecionar Criar Lista de Reprodução no menu Arquivo irá gerar um arquivo Um
Hit Wonder - Let's Tag.m3u no diretório.

COMANDO REFERÊNCIA

A GUI elementos
A GUI Kid3 é separada em cinco seções: À esquerda estão o arquivo e o diretório
caixas de listagem, o lado direito contém as seções Arquivo, Marca 1 e Marca 2.

Envie o Lista
A lista de arquivos contém os nomes de todos os arquivos no diretório aberto que correspondem
o filtro de nome de arquivo selecionado (normalmente * .mp3 * .ogg * .opus * .dsf * .flac * .mpc * .aac
* .m4a * .m4b * .m4p * .mp4 * .mp2 * .spx * .tta * .wv * .wma * .wav * .aiff * .ape). Um único ou
vários arquivos podem ser selecionados. Para não selecionar nenhum arquivo, clique na área vazia após o
entradas da caixa de listagem. A seleção determina os arquivos que são afetados pelo
operações que estão disponíveis usando os botões descritos abaixo.

Além do Nome, também outras colunas Tamanho, Tipo, Data da modificação com detalhes do arquivo podem ser
exibido. As colunas podem ser ocultadas desmarcando seu nome no menu de contexto do
cabeçalho da lista. A ordem das colunas pode ser alterada arrastando e soltando. A ordem de classificação
pode ser alternado clicando no cabeçalho da coluna.

À esquerda dos nomes, um ícone pode ser exibido: um disco para mostrar que o arquivo tem
foram modificados ou informações sobre quais tags estão presentes (V1, V2, V1V2 ou SEM TAG, não
ícone é exibido se o arquivo ainda não foi lido).

Os diretórios são exibidos com um ícone de pasta. Se um diretório for aberto, seus arquivos serão
exibido em uma árvore hierárquica. Selecionando arquivos de subdiretórios, operações
pode ser executado em arquivos em diretórios diferentes, o que é útil se a música
coleção é organizada com uma pasta para cada artista contendo pastas para álbuns de
este artista.

Clicar com o botão direito do mouse dentro da lista de arquivos abre um menu de contexto com o
seguintes comandos:

· Expandir tudo: Expande todas as árvores de pastas (apenas a árvore atual se a tecla shift for
pressionado)

· Recolher tudo: Recolhe todas as árvores de pastas

· Renomear: Altera o nome de um arquivo

· Mover para a lixeira: move um arquivo para a lixeira

· Reproduzir: reproduz um arquivo, consulte Reproduzir

· As entradas subsequentes são comandos do usuário, que podem ser definidos nas Ações do Usuário
guia de Configurar Kid3. A reprodução com duplo clique também pode ser ativada lá.

Diretório Lista
A lista de diretórios contém os nomes dos diretórios no diretório aberto, como
bem como o diretório atual (.) e o diretório pai (..). Permite mudar rapidamente
o diretório sem usar o comando Abrir ... ou arrastar e soltar.

A visibilidade, a ordem e a classificação da coluna podem ser configuradas conforme descrito na seção
sobre a lista de arquivos.

Envie o
Mostra informações sobre a codificação (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4,
AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), taxa de bits, taxa de amostragem, canais e
o comprimento do arquivo.

A edição da linha Nome contém o nome do arquivo (se apenas um único arquivo for selecionado).
Se este nome for alterado, o arquivo será renomeado quando o comando Salvar for usado.

A caixa de combinação Formato e a edição de linha contêm o formato a ser usado quando o nome do arquivo é
gerado a partir da primeira ou da segunda tag. O nome do arquivo pode conter
caracteres, até mesmo uma parte do diretório separada por uma barra do nome do arquivo, mas que
já deve existir um diretório para que a renomeação seja bem-sucedida. Os seguintes códigos especiais
são usados ​​para inserir valores de tag no nome do arquivo:

· Título de% s% {title} (música)

·% A% {artist} Artista

· Álbum% l% {album}

·% C% {comment} Comentário

·% Y% {year} ano

· Trilha% t% {track} (por exemplo, 01)

·% T% {track.n} Trilha com largura de campo n (por exemplo, 001 para% {track.3})

· Faixa% T% {tracknumber} (sem zeros à esquerda, por exemplo, 1)

· Gênero% g% {genre}

·% {Ignore} Ignorado ao gerar tags a partir do nome do arquivo

Os códigos de formato não se restringem aos exemplos dados acima. Qualquer nome de quadro pode ser
usados, por exemplo, nomes de quadros unificados como % {bpm} ou formate nomes específicos como
% {popm}.

Uma segunda caixa de combinação Formato (com a seta para baixo) é usada para gerar as tags do
nome do arquivo. Se o formato do nome do arquivo não corresponder a este padrão, alguns outros
formatos comumente usados ​​são testados.

Alguns formatos de nome de arquivo comumente usados ​​já estão disponíveis na caixa de combinação, mas é
também é possível digitar algum formato especial na edição de linha.

De: Tag 1, Tag 2: define o nome do arquivo usando o formato selecionado e a primeira tag ou
a segunda tag, respectivamente.

Para: Tag 1, Tag 2: As tags são definidas a partir do nome do arquivo. Primeiro, o formato especificado em
O formato é usado. Se o nome do arquivo existente não corresponder a este formato, o seguinte
formatos são experimentados:

· Artista - Álbum / Faixa de Música

· Álbum / Faixa - Artista - Canção

· / Artista - Álbum - Faixa - Canção

· Álbum / Artista - Faixa - Música

· Álbum / Artista - Canção

· Artista / Álbum / Faixa de Música

Se um único arquivo for selecionado, os controles da GUI serão preenchidos com os valores extraídos
do nome do arquivo. Se vários arquivos forem selecionados, as marcas dos arquivos são diretamente
definido de acordo com os nomes dos arquivos.

etiqueta 1
Os widgets de edição de linha para Título, Artista, Álbum, Comentário, Ano, Faixa e Gênero são
usado para editar o valor correspondente na primeira tag dos arquivos selecionados. O valor que
será alterado quando a seleção do arquivo for alterada ou antes de operações como Salvar e
Saia e quando a caixa de seleção correspondente à esquerda do nome do campo estiver marcada.
Isso é útil para alterar apenas alguns valores e deixar os outros valores inalterados.

Se um único arquivo for selecionado, todas as caixas de seleção serão marcadas e os widgets de edição de linha
contém os valores encontrados nas tags deste arquivo. Se uma tag não for encontrada no arquivo,
o valor vazio correspondente é exibido, que é uma string vazia para o Título,
Edições de artista, álbum e linha de comentário, 0 para as edições numéricas do ano e da faixa e um
vazio o valor selecionado para a caixa de combinação Gênero. Os valores podem ser alterados e se o
a caixa de seleção correspondente estiver marcada, eles serão definidos para o arquivo selecionado após o
a seleção é alterada. O arquivo é então marcado como modificado por um símbolo de disco no arquivo
caixa de listagem, mas permanece inalterada até que o comando Salvar seja usado.

Se vários arquivos forem selecionados, apenas os valores que são idênticos em todos os
os arquivos são exibidos. Em todos os outros controles, os valores vazios descritos acima são
exibido. Todas as caixas de seleção são desmarcadas para evitar alterações indesejadas. Se um valor tem que
ser definido para todos os arquivos selecionados, ele pode ser editado e a caixa de seleção deve ser definida. o
os valores serão definidos para todos os arquivos selecionados quando a seleção for alterada e pode ser
salvo usando o comando Salvar.

As caixas de seleção também controlam a operação da maioria dos comandos que afetam as tags, como
como copiar, colar e transferir entre as marcas 1 e 2. Para tornar mais fácil de usar com
vários arquivos onde todas as caixas de seleção estão desmarcadas, esses comandos se comportam da mesma forma
maneira quando todas as caixas de seleção estão marcadas e quando todas as caixas de seleção estão desmarcadas.

Da tag 2: Os campos da tag 1 são definidos a partir dos valores correspondentes na tag 2. Se um
único arquivo é selecionado, os controles da GUI são preenchidos com os valores da tag 2. Se
vários arquivos são selecionados, as marcas dos arquivos são definidas diretamente.

Cópia: O buffer de cópia é preenchido com os valores do Tag 1. Somente valores com marcados
A caixa de seleção será usada nos comandos Colar subsequentes.

Colar: cola os valores do buffer de cópia nos controles da GUI.

Remover: Isso irá definir todos os controles da GUI para seus valores vazios, o que resulta na remoção
todos os valores. O arquivo salvo não conterá nenhuma tag 1.

etiqueta 2
Os controles da GUI funcionam da mesma maneira como descrito para a seção Tag 1, mas o
o tamanho das cordas não é limitado.

Para o gênero tag 2, você também pode usar seus próprios nomes além dos gêneros listados no
caixa de combinação, basta digitar o nome na linha de edição.

A tag 2 não pode apenas conter os mesmos valores da tag 1, o formato é construído em um
forma flexível a partir de vários frames, eles próprios compostos por vários campos. o
A tabela tag 2 mostra todos os frames que estão disponíveis no arquivo selecionado.

Editar: Isto irá abrir uma janela que permite editar todos os campos do selecionado
quadro. Se vários arquivos forem selecionados, os campos editados serão aplicados a todos os selecionados
arquivos que contêm tal quadro.

Adicionar: Um solicitante para selecionar o tipo de quadro aparecerá e um quadro do tipo selecionado
pode ser editado e adicionado ao arquivo. Isso também funciona para adicionar um quadro a vários
arquivos selecionados.

Excluir: Exclui o quadro selecionado nos arquivos selecionados.

Arrastar a arte do álbum aqui será mostrado se o arquivo não contiver a arte da capa incorporada. UMA
imagem pode ser adicionada usando arrastar e soltar de um navegador ou gerenciador de arquivos e será
exibido aqui. Molduras podem ser editadas ou adicionadas clicando duas vezes neste
controlar.

Sincronizado letra e Evento Cronometragem códigos
Para informações sincronizadas com os dados de áudio, um editor específico está disponível.
Esses quadros são compatíveis com as tags ID3v2.3.0 e ID3v2.4.0. Para adicionar tal quadro, o
o nome do quadro específico deve ser selecionado na lista que aparece quando o botão Adicionar
for clicado - Letras Sincronizadas ou Códigos de Tempo de Evento, respectivamente. O editor é
o mesmo para ambos os tipos, para os códigos de tempo de evento, apenas um conjunto predefinido de eventos
está disponível, enquanto para as letras sincronizadas, o texto deve ser inserido. No
a seguir, a edição das letras sincronizadas é explicada.

Um arquivo com uma tag ID3v2 é selecionado, o editor de letras é acessado usando Adicionar e
selecionando Letras Sincronizadas. Para um quadro de Letras Sincronizadas existente, é
selecionado e Editar é clicado. O player é aberto automaticamente com o arquivo atual
para que o arquivo possa ser reproduzido e pausado para sincronizar as letras.

As configurações na parte superior do editor SYLT normalmente não precisam ser alteradas. Se o
as letras contêm caracteres que não estão presentes no conjunto de caracteres Latin 1,
alterar a codificação de texto para UTF16 (ou UTF8 para ID3v2.4.0) é aconselhável. Para inglês
letras e compatibilidade máxima, ISO-8859-1 deve ser usado.

A seção Letras de músicas tem cinco botões na parte superior. Adicionar irá adicionar um novo evento de tempo no
tabela. O tempo é obtido a partir da posição do jogador, adicionando assim uma entrada enquanto
a reprodução da faixa adicionará uma linha para a posição atualmente reproduzida. Os eventos no
a tabela deve ser ordenada cronologicamente, portanto, a linha será inserida
adequadamente. As inscrições com um tempo inválido são tratadas de maneira especial: Se o
a linha selecionada tem uma hora inválida, seu carimbo de hora será substituído pela hora atual
em vez de adicionar uma nova linha. Se a hora atual não for inválida, a primeira linha com um
tempo inválido será usado se houver. Este comportamento deve facilitar a adição de tempo
carimba se o texto da letra já está na tabela, mas os carimbos de hora estão faltando
(que é o caso ao importar letras não sincronizadas). Observe que o tempo inválido
é representado como 00: 00.00, ou seja, o mesmo que a hora no início absoluto do
faixa, que não é inválida. Para tornar um tempo inválido, pressione a tecla Delete ou use
Limpe no menu de contexto. Novas linhas inseridas usando Inserir linha do menu de contexto
ou criado ao importar letras não sincronizadas com Da área de transferência ou Importar também
contém carimbos de hora inválidos. As linhas da tabela podem ser excluídas clicando no botão Excluir
ou usando Excluir linhas do menu de contexto.

Letras sincronizadas podem ser importadas de um arquivo usando Importar. O formato esperado é
LRC simples ou aprimorado. Se o arquivo selecionado não contém um colchete no
primeira linha, deve ser um arquivo de texto simples com letras não sincronizadas. o
as linhas desse arquivo são importadas com registros de data e hora inválidos. A Hora
as informações podem ser adicionadas usando o botão Adicionar ou por entrada manual. Também é possível
para importar letras por meio de copiar e colar usando Da área de transferência. As letras sincronizadas podem ser
gravados em arquivos LRC usando Exportar. Observe que apenas as entradas com timestamps válidos irão
serão exportados e as entradas serão classificadas por tempo. Entradas com tempo inválido
não será armazenado no quadro SYLT, então certifique-se de incluir todos os tempos
informações antes de sair da caixa de diálogo.

A ID3 especificação[6] sugere um carimbo de data / hora para cada sílaba. No entanto, a maioria dos jogadores
suporta apenas a granularidade de uma linha ou frase. Para oferecer suporte a ambos os casos de uso, Kid3
segue as mesmas convenções que SILT editor[7]. Texto que é inserido na tabela
assume-se que inicia uma nova linha, a menos que comece com um espaço ou hífen. Exceções
a esta regra são possíveis iniciando uma linha com um sublinhado ('_') para forçar
continuação ou uma marca hash ('#') para forçar uma nova linha. Esses caracteres de escape não são
armazenado dentro do quadro SYLT. Dentro do quadro SYLT, novas linhas começam com uma alimentação de linha
caractere (hex 0A), enquanto as continuações não. Ao ler quadros SYLT, Kid3 verifica
se a primeira entrada começar com uma alimentação de linha. Se este não for o caso, presume-se
que todas as entradas são novas linhas e que nenhuma continuação de sílaba é usada.

Enquanto a faixa é reproduzida, a linha associada à posição de reprodução atual é
destacado, para que a exatidão das informações de sincronização possa ser
verificado. Se um deslocamento tiver que ser adicionado a um ou mais carimbos de data / hora, isso pode ser
realizado com o menu de contexto Adicionar deslocamento. Valores negativos podem ser usados ​​para reduzir
A Hora. Usando Seek para posicionar no menu de contexto, é possível definir o
posição de jogo para a hora da linha selecionada.

A Envie o Menu
Arquivo → Abrir ... (Ctrl + O)
Abre um diretório. Todos os arquivos que correspondem ao filtro de nome de arquivo selecionado serão exibidos
na caixa de listagem de arquivos e o arquivo escolhido é selecionado.

Arquivo → Abrir recente
Abre um diretório aberto recentemente.

Arquivo → Abrir diretório ... (Ctrl + D)
Abre um diretório. Todos os arquivos que correspondem ao filtro de nome de arquivo selecionado serão exibidos
na caixa de listagem de arquivos.

Arquivo → Salvar (Ctrl + S)
Salva todos os arquivos alterados no diretório. Os arquivos alterados são marcados com um disco
símbolo na caixa de listagem de arquivos. Se algum nome de arquivo foi alterado, esses arquivos serão
renomeado.

Arquivo → Reverter
Reverte as alterações de um ou vários arquivos. Se nenhum arquivo estiver selecionado no arquivo
caixa de listagem, as alterações de todos os arquivos serão revertidas, caso contrário, apenas as alterações do
os arquivos selecionados são revertidos.

Arquivo → Importar ...
A caixa de diálogo Importar pode ser usada para importar dados diretamente de um servidor freedb.org, de um
Servidor MusicBrainz, de Discogs, Amazon ou outras fontes de listas de faixas de álbuns em
formato textual.

A importação de um servidor freedb.org é possível usando uma caixa de diálogo que aparece quando De
Servidor: gnudb.org ou TrackType.org está selecionado. O artista e o nome do álbum a serem pesquisados
pode ser inserido nos dois campos superiores, os álbuns que correspondem à consulta serão
exibido quando Find é clicado e os resultados de www.gnudb.org[8] são recebidos.
A importação dos dados da faixa para um álbum é feita clicando duas vezes no álbum no
Lista. O servidor freedb.org a partir do qual importar pode ser selecionado, bem como o caminho CGI.
Os dados importados são exibidos na tabela de visualização da caixa de diálogo de importação. Quando
satisfeito com as faixas exibidas, elas podem ser importadas encerrando a importação
diálogo com OK.

Uma pesquisa no servidor Discogs pode ser realizada usando Discogs. Como no gnudb.org
diálogo, você pode inserir artista e álbum e, em seguida, escolher em uma lista de lançamentos. Se
As tags padrão são marcadas, as informações padrão são importadas, por exemplo, artista, álbum e
título. Se Tags adicionais forem marcadas, mais informações serão importadas, se disponíveis, por exemplo
intérpretes, arranjadores ou o editor. Se a arte da capa estiver marcada, a arte da capa será
baixado, se disponível.

Uma pesquisa na Amazon pode ser realizada usando a Amazon. Como na caixa de diálogo gnudb.org, você pode
insira artista e álbum e, em seguida, escolha em uma lista de lançamentos. Se as tags adicionais forem
marcados, mais informações são importadas se disponíveis, por exemplo, artistas, arranjadores ou o
editor. Se a arte da capa estiver marcada, a arte da capa será baixada, se disponível.

Você pode pesquisar da mesma forma no banco de dados de lançamentos do MusicBrainz usando De
Lançamento do MusicBrainz. O fluxo de trabalho é igual ao descrito em gnudb.org.

A importação de um servidor MusicBrainz é possível usando a caixa de diálogo que aparece quando De
A impressão digital MusicBrainz está selecionada. O servidor pode ser selecionado como no freedb
diálogo de importação. Abaixo está uma tabela exibindo os dados de trilha importados. A coluna certa
mostra o estado da consulta MusicBrainz, que começa com "Pendente" quando a caixa de diálogo
está aberto. Em seguida, a impressão digital é pesquisada e, se não produzir um resultado,
outra pesquisa usando as marcas no arquivo é tentada. Portanto, pode ser útil para um
consulta bem-sucedida do MusicBrainz para armazenar informações conhecidas (por exemplo, artista e álbum) no
tags antes da importação. Se um resultado for encontrado, a pesquisa termina no estado
"Reconhecido", caso contrário, nada foi encontrado ou vários resultados ambíguos e um dos
eles devem ser selecionados pelo usuário. OK e Aplicar usam os dados importados, Cancelar
fecha o diálogo. O fechamento pode demorar um pouco, pois todo o maquinário da MusicBrainz
tem que ser encerrado.

Para a importação de dados textuais, Do arquivo / área de transferência abre um subdialog, onde vários
formatos de importação pré-configurados estão disponíveis. Os dois primeiros, "CSV sem aspas" e "CSV
entre aspas "pode ​​ser usado para importar dados que foram exportados pela caixa de diálogo Exportar. O arquivo CSV
os dados podem ser editados com uma planilha e devem ser escritos usando tabulações como delimitadores.
A importação deve ser possível usando "CSV quoted", que é mais flexível do que "CSV
sem aspas ". No entanto, seus campos não podem conter aspas duplas. Se você apenas exportar
de Kid3 e importar mais tarde, "CSV sem aspas" pode ser usado como um formato simples para este
propósito. Observe que também existem os comandos "Exportar CSV" e "Importar CSV" no
menu de contexto da lista de arquivos, que usa scripts para exportar e importar dados CSV em um
forma mais completa, poderosa e flexível.

O próximo formato, "texto HTML freedb", pode ser usado para copiar informações de uma página HTML
of freedb.org[9]. Pesquise um álbum no freedb e se a informação desejada é
exibido no navegador da web, copie o conteúdo para a área de transferência. Em seguida, clique no botão De
O botão da área de transferência e as faixas importadas serão exibidas na tabela de visualização no
topo da caixa de diálogo. Se você estiver satisfeito com os dados importados, feche a caixa de diálogo
com OK, que irá inserir os dados nas tags do diretório atual. o
o destino (Tag 1, Tag 2 ou Tag 1 e Tag 2) pode ser selecionado com uma caixa de combinação. o
os arquivos no diretório atual devem estar na ordem correta das trilhas para obter suas marcas
atribuído. Esse é o caso se eles forem numerados.

O próximo formato de importação pré-configurado, "fonte HTML freedb", pode ser usado, se os dados
está disponível como um documento HTML. A importação é possível usando o botão Do arquivo, que
abre um seletor de arquivos ou copia seu conteúdo de um editor e, em seguida, importa de
prancheta. Este formato pode ser útil para importação offline, embora o documento HTML
também pode ser aberto em um navegador e, em seguida, importado no primeiro formato por meio do
clipboard.

Mais formatos pré-configurados, por exemplo, "Track Title Time", estão disponíveis. Um costume vazio
formato pode ser criado com Adicionar para ser definido pelo usuário. Duas linhas abaixo do nome do formato
pode ser definido com uma expressão regular para capturar os campos do texto de importação. o
a primeira expressão regular será analisada uma vez por documento para reunir dados por álbum
como artista, álbum, ano e gênero. A segunda linha é tentada corresponder ao
do início ao fim do documento para obter os dados da trilha, geralmente o número e o título. o
expressões regulares incluem todos os recursos oferecidos pelo Qt, que é a maior parte do que
Ofertas Perl. Construções de colchetes "(..)" criam buffers de captura para os campos para
importar e são precedidos por códigos específicos Kid3 para especificar qual campo capturar. o
códigos são os mesmos usados ​​para o formato do nome do arquivo, além dos códigos listados abaixo,
qualquer nome de quadro é possível:

· Título de% s% {title} (música)

·% A% {artist} Artista

· Álbum% l% {album}

·% C% {comment} Comentário

·% Y% {year} ano

· Trilha% t% {track}

· Gênero% g% {genre}

· Duração de% d% {duration}

Por exemplo, uma expressão regular de faixa (segunda linha) para importar de uma lista de reprodução .m3u
pode ser "% {track} (\ d +) \ s +% {title} (\ S [^ \ r \ n] *) \. mp3 [\ r \ n]". Todos os formatos podem ser alterados
editando as expressões regulares e o nome e clicando em Salvar configurações. Elas
será armazenado no arquivo kid3rc no diretório de configuração. Este arquivo pode ser
editado diretamente para ter mais formatos de importação ou pode ser excluído para reverter para o
formatos padrão. Os formatos podem ser excluídos usando Remover.

A precisão mostra uma estimativa de quão bem as informações importadas correspondem ao dado
faixas. Ele usa durações de trilha ou nomes de arquivo para calcular o nível de similaridade em
por cento. A arte da capa mostra o URL da imagem da capa do álbum que será baixada.

Para verificar se as faixas importadas correspondem ao conjunto atual de arquivos, a duração de
as trilhas importadas podem ser comparadas com a duração dos arquivos. Esta opção pode ser
habilitado com a caixa de seleção Verificar diferença de tempo máxima permitida e o máximo
a diferença de tempo tolerada pode ser definida em segundos. Se uma incompatibilidade de comprimento for
detectado, o comprimento é exibido com um fundo vermelho na tabela de visualização.

Se os arquivos forem ordenados de maneira diferente das faixas importadas, suas faixas atribuídas
tem que ser mudado. Esta tarefa pode ser facilitada usando o Match with buttons Length,
Trilha e Título, que reordenará as trilhas de acordo com o campo correspondente.
Para corrigir as atribuições manualmente, uma trilha pode ser arrastada com o botão esquerdo do mouse
e a tecla Ctrl pressionada e, em seguida, solta no novo local.

Quando a caixa de diálogo de importação é aberta, ela contém o conteúdo real das tags. A etiqueta
tipo (Tag 1, Tag 2, Tag 1 e Tag 2) pode ser selecionado usando a caixa de combinação Destino.
O botão à direita desta caixa de combinação pode ser usado para reverter a tabela para o
conteúdo atual das tags. As caixas de seleção na primeira coluna da tabela podem ser usadas para
selecione as faixas que são importadas. Isso pode ser útil se uma pasta contiver o
faixas de ambos os CDs de um CD duplo e apenas as faixas do segundo CD devem ser
importados.

Para identificar as faixas que são importadas, é possível exibir os nomes dos arquivos ou
os caminhos completos para os arquivos usando o menu de contexto do cabeçalho da tabela. Os valores em
a tabela de importação pode ser editada. O botão de reversão à direita do destino
a caixa de combinação pode ser usada para restaurar o conteúdo das tags, o que também pode ser útil
após alterar o destino.

Quase todas as caixas de diálogo apresentam um botão Salvar configurações, que pode ser usado para armazenar o
configurações específicas da caixa de diálogo e o tamanho da janela de forma persistente.

De Tags leva a um subdialog para definir frames de tag a partir do conteúdo de outra tag
quadros. Isso pode ser usado para simplesmente copiar informações entre tags ou extrair uma parte
de um quadro e insira-o em outro.

Como na importação de arquivo / área de transferência, existem formatos livremente configuráveis ​​para executar
diferentes operações. Já pré-configurados são formatos para copiar o valor do Álbum para
Artista, Compositor ou Maestro do Álbum e para extrair o Número da Faixa dos campos de Título
que contém um número. Também existe um formato para extrair uma legenda de um título
campo.

O exemplo a seguir explica como adicionar um formato personalizado, que define as informações
no campo Subtítulo também no campo Comentário. Crie um novo formato usando Adicionar e
defina um novo nome, por exemplo, "Legenda para Comentário". Em seguida, digite "% {subtitle}" na fonte e
"% {comment} (. *)" para Extração e clique em Salvar configurações.

A expressão em Source pode conter códigos de formato para frames de tag arbitrários, múltiplos
códigos podem ser usados ​​para combinar o conteúdo de diferentes quadros. Para cada faixa, um
o texto é gerado a partir de suas tags usando o formato Fonte e a expressão regular
from Extraction é aplicado a este texto para definir novos valores para as tags. Códigos de formato
são usados ​​antes dos parênteses de captura para especificar o quadro da tag onde o
o texto deve ser armazenado. Funciona da mesma forma que a importação de arquivo / área de transferência.

Arquivo → Importar de gnudb.org ...
Importar de um servidor freedb.org usando a pesquisa de álbum gnudb.org. Este item de menu abre
a mesma caixa de diálogo de importação que Importar ..., mas abre diretamente a caixa de diálogo gnudb.org.

Arquivo → Importar de TrackType.org ...
Importe do servidor TrackType.org. Este item de menu abre a mesma caixa de diálogo de importação que
Importar ..., mas abre diretamente a caixa de diálogo TrackType.org.

Arquivo → Importar do Discogs ...
Importar do servidor Discogs. Este item de menu abre a mesma caixa de diálogo de importação que
Importar ..., mas abre diretamente a caixa de diálogo Do Discogs.

Arquivo → Importar da Amazon ...
Importar da Amazon. Este item de menu abre a mesma caixa de diálogo de importação que Importar ..., mas
abre diretamente a caixa de diálogo Da Amazon.

Arquivo → Importar do MusicBrainz Release ...
Importe do banco de dados de lançamentos do MusicBrainz. Este item de menu abre a mesma importação
diálogo como Importar ..., mas abre diretamente o diálogo From MusicBrainz Release.

Arquivo → Importar da impressão digital do MusicBrainz ...
Importe de um servidor MusicBrainz. Este item de menu abre a mesma caixa de diálogo de importação que
Importar ..., mas abre diretamente a caixa de diálogo Impressão digital da MusicBrainz.

Arquivo → Importação automática ...
A importação automática permite importar informações para vários álbuns de vários sites
Serviços. Se os diretórios forem selecionados na lista de arquivos, rastreie os dados do selecionado
os diretórios serão importados. Se nenhum diretório for selecionado, todos os diretórios no arquivo
lista será importada.

O tipo de tag (Tag 1, Tag 2, Tag 1 e Tag 2) pode ser selecionado usando o Destino
caixa combo.

Os perfis determinam quais servidores serão contatados para buscar informações do álbum. Algum
os perfis são predefinidos (All, MusicBrainz, Discogs, Cover Art), os perfis personalizados podem ser
adicionado usando o botão Adicionar à direita da caixa de combinação Perfil.

A tabela abaixo mostra os servidores que serão usados ​​ao importar as informações do álbum
usando o perfil selecionado. O processo de importação de um álbum é concluído se todos
as informações necessárias foram encontradas, então a ordem das linhas na tabela é
importante. Ele pode ser alterado usando os botões Mover para cima e Mover para baixo. Editar pode ser
usado para alterar uma entrada existente. A seleção do servidor oferece os mesmos servidores que podem
ser usado nas funções de importação. Tags padrão, tags adicionais, arte da capa determinam
as informações que devem ser obtidas no servidor. Finalmente, a precisão é o
precisão mínima que deve ser alcançada para aceitar os dados importados. Se a precisão
for insuficiente, o próximo servidor da lista será tentado. A mesma caixa de diálogo contendo
as propriedades do servidor aparecem quando Adicionar é clicado para adicionar uma nova entrada de servidor. Existir
entradas podem ser excluídas usando Remover.

Para iniciar uma importação automática de lote com o perfil selecionado, clique em Iniciar. Detalhes
sobre a importação em execução são exibidos na parte superior da caixa de diálogo. O processo pode ser
abortado com o botão Abortar.

Arquivo → Navegar pela capa ...
A caixa de diálogo Procurar capa do álbum ajuda a encontrar a capa do álbum. Artista / Álbum está cheio
das tags, se possível. A Source oferece uma variedade de sites com a arte da capa do álbum.
O URL com artista e álbum como parâmetros pode ser encontrado abaixo do nome. Codificado por URL
valores para artista e álbum podem ser inseridos usando % u {artist} e % u {album}, de outros
os valores das tags também são possíveis, conforme descrito em Configurar Kid3, Ações do usuário.
Mais fontes podem ser inseridas após a entrada "Fonte Personalizada", substituindo "Personalizado
Fonte "com o nome da fonte, pressionando Enter, inserindo o URL e finalmente
pressionando Salvar configurações. O comando do navegador resultante é exibido na parte superior do
diálogo e pode ser iniciado clicando em Navegar. O navegador, que pode ser configurado em
as configurações, é iniciado com a fonte selecionada. Uma imagem da capa pode então ser arrastada
do navegador para a janela Kid3 e será definido no quadro da imagem do
arquivos selecionados.

Porque nem todos os navegadores suportam arrastar e soltar de imagens e as fotos em sites
frequentemente tem uma URL, em tais casos Kid3 receberá a URL e não a imagem. Se o
URL aponta para uma imagem, ela será baixada. No entanto, se o URL se referir a algum
outro recurso da web, ele deve ser traduzido para a imagem correspondente. Tal
mapeamentos são definidos na extração de URL da tabela. A correspondência da coluna esquerda contém um
expressão regular que é comparada com o URL. Se corresponder, o capturado
expressões entre parênteses são inseridas no padrão do URL de imagem correto
coluna (nas posições marcadas com \ 1 etc.). A expressão regular substituída
contém o URL da imagem. Desta forma, a arte da capa pode ser importada da Amazon,
Imagens do Google, etc. usando arrastar e soltar. Também é possível definir o seu próprio
mapeamentos.

Arquivo → Exportar ...
A caixa de diálogo Exportar é usada para armazenar dados das tags em um arquivo ou área de transferência. o
o editor na parte superior mostra uma visualização dos dados a serem exportados. Se os dados de exportação contiverem
caracteres do tabulador, a exportação é exibida em uma tabela. Os dados serão gerados
das tags no diretório atual de acordo com o formato configurado.

As configurações de formato são semelhantes às da caixa de diálogo Importar: O campo superior contém
o título (por exemplo, "CSV sem aspas"), seguido pelo cabeçalho, que será gerado em
o início do arquivo. Os dados da trilha seguem; ele é usado para todas as faixas. Finalmente,
o trailer pode ser usado para gerar algum texto de acabamento.

Os campos de formato não contêm expressões regulares como na caixa de diálogo Importar, mas apenas
expressões de formato de saída com% -expressões especiais, que serão substituídas por valores
das tags. Tudo funciona como o formato do nome do arquivo, e os mesmos códigos são
usado mais alguns códigos adicionais. Não apenas os códigos listados abaixo, mas todos os quadros de tags
nomes podem ser usados.

· Título de% s% {title} (música)

·% A% {artist} Artista

· Álbum% l% {album}

·% C% {comment} Comentário

·% Y% {year} ano

· Trilha% t% {track} (por exemplo, 01)

·% T% {track.n} Trilha com largura de campo n (por exemplo, 001 para% {track.3})

· Faixa% T% {tracknumber} (sem zeros à esquerda, por exemplo, 1)

· Gênero% g% {genre}

·% F% {file} Nome do arquivo

· Caminho de% p% {filepath}

· URL% u% {url}

·% D% {duration} Duração em minutos: segundos

·% D% {segundos} Duração em segundos

·% N% {faixas} Número de faixas do álbum

·% E% {extension} Extensão de arquivo

·% O% {tag1} O formato da tag 1 (ID3v1.1 ou vazio se não houver)

·% O% {tag2} O formato da tag 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF ou vazio se não existir)

· Taxa de bits% b% {bitrate} em kbit / s

·% V% {vbr} VBR ou vazio (apenas para ID3v2.3 com id3lib)

·% R% {samplerate} Taxa de amostragem em Hz

· Modo de canal% m% {mode} (Estéreo ou Joint Stereo)

·% H% {channels} Número de canais (1 ou 2)

· Codec% k% {codec} (por exemplo, MPEG 1 Camada 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

Alguns formatos são predefinidos. "CSV sem aspas" separa os campos por guias. Dados em
este formato pode ser importado novamente para Kid3 usando o formato de importação com o mesmo
nome. "CSV entre aspas" também inclui os campos entre aspas duplas, o que facilita o
importar para aplicativos de planilha. No entanto, os campos não devem conter nenhuma dupla
aspas quando este formato é usado. "Extended M3U" e "Extended PLS" geram listas de reprodução
com atributos estendidos e nomes de caminho absolutos. "HTML" pode ser usado para gerar um
Página HTML com hiperlinks para as faixas. "Kover XML" cria um arquivo que pode ser
importado pelo programa de impressão de capa Kover. "Detalhes técnicos" fornece informações
sobre taxa de bits, taxa de amostragem, canais, etc. Por fim, "Formato personalizado" é deixado em branco para
definição de um formato personalizado. Você pode definir mais formatos de sua preferência adicionando linhas
no arquivo kid3rc do diretório de configuração. Os outros formatos podem ser adaptados para
suas necessidades.

A fonte das tags para gerar os dados de exportação (Tag 1 ou Tag 2) pode ser selecionada
com uma caixa de combinação. Empurrar para arquivo ou para a área de transferência armazena os dados em um arquivo ou no
prancheta. OK e Cancelar fecham a caixa de diálogo, enquanto OK aceita a caixa de diálogo atual
configurações.

Arquivo → Criar lista de reprodução
Cria uma lista de reprodução. O formato e o conteúdo da lista de reprodução podem ser definidos por vários
opções.

O nome da lista de reprodução pode ser o mesmo que o nome do diretório ou usar um Formato com valores
das tags, por exemplo, "% {artist} -% {album}" para ter o artista e o nome do álbum no
nome do arquivo da lista de reprodução. Os códigos de formato são iguais aos da Exportação. A extensão depende
no formato da lista de reprodução.

A localização da lista de reprodução gerada é determinada pela seleção do Criar em
caixa combo.

Diretório atual
A lista de reprodução é criada no diretório atual e contém apenas arquivos do
diretório atual.

Cada diretório
Uma lista de reprodução é criada em cada diretório que contém os arquivos listados, e cada
lista de reprodução contém os arquivos desse diretório.

Diretório de nível superior
Apenas uma lista de reprodução é criada no diretório de nível superior (ou seja, o diretório do
lista de arquivos) e contém os arquivos listados do diretório de nível superior e todos os
seus subdiretórios.

O formato da lista de reprodução pode ser M3U, PLS ou XSPF.

Se Incluir apenas os arquivos selecionados estiver marcado, apenas os arquivos selecionados serão
incluído na lista de reprodução. Se um diretório for selecionado, todos os seus arquivos serão selecionados.
Se esta caixa de seleção não estiver ativada, todos os arquivos de áudio serão incluídos na lista de reprodução.

Classificar por nome de arquivo seleciona o caso usual em que os arquivos são ordenados por nome de arquivo.
Com o campo Classificar por tag, é possível classificar por uma string de formato com valores da tag
Campos. Por exemplo, "% {track.3}" pode ser usado para classificar por número de faixa (o ".3" é
usado para obter três dígitos com zeros à esquerda porque as strings são usadas para classificação). Isto
também é possível usar vários campos, por exemplo, "% {genre}% {year}" para classificar usando uma string
composto por gênero e ano.

As entradas da lista de reprodução terão caminhos de arquivo relativos ou absolutos dependendo se
Usar caminho relativo para arquivos na lista de reprodução ou Usar caminho completo para arquivos na lista de reprodução está definido.

Quando a lista de arquivos somente para gravação é definida, a lista de reprodução conterá apenas os caminhos para o
arquivos. Para gerar uma lista de reprodução estendida com informações adicionais, uma string de formato
pode ser definido usando Write info using control.

Arquivo → Sair (Ctrl + Q)
Sai do aplicativo.

A Editar Menu
Editar → Selecionar tudo (Alt + A)
Seleciona todos os arquivos.

Editar → Desmarcar (Ctrl + Shift + A)
Desmarca todos os arquivos.

Editar → Selecionar tudo no diretório
Seleciona todos os arquivos do diretório atual.

Editar → Arquivo anterior (Alt + Up)
Seleciona o arquivo anterior.

Editar → Próximo arquivo (Alt + Down)
Seleciona o próximo arquivo.

Editar → Localizar ... (Ctrl + F)
Encontre strings nos nomes dos arquivos e nas tags. A caixa de diálogo Localizar é um subconjunto do
Caixa de diálogo Substituir, que é descrita abaixo.

Editar → Substituir ... (Ctrl + R)
Esta função abre uma caixa de diálogo para localizar e substituir strings nos nomes dos arquivos e
Tag. O conjunto de frames onde a pesquisa é realizada pode ser restringido por
desativando a caixa de seleção Selecionar tudo e selecionando os quadros que devem ser pesquisados.
Também existem opções de pesquisa disponíveis para pesquisar para trás, com distinção entre maiúsculas e minúsculas e para
use expressões regulares.

Dependendo da quantidade de arquivos, a busca pode levar algum tempo, portanto pode ser
abortado fechando o diálogo.

A Ferramentas Menu
Ferramentas → Aplicar formato de nome de arquivo
Quando o formato durante a edição está desativado para o formato do nome do arquivo na configuração
diálogo, este item de menu pode ser usado para aplicar o formato configurado aos nomes dos
arquivos selecionados. Isso também pode ser usado para verificar se os nomes dos arquivos estão em conformidade com o
formato configurado, aplicando o formato a todos os arquivos salvos e, em seguida, verificando se algum
os arquivos foram alterados (e, portanto, marcados com um símbolo de disco na caixa de listagem de arquivos).

Ferramentas → Aplicar formato de tag
Quando o formato durante a edição está desativado para o formato da tag na configuração
diálogo, este item de menu pode ser usado para aplicar o formato configurado às tags do
arquivos selecionados. Isso também pode ser usado para verificar se as tags estão em conformidade com o
formato configurado, aplicando o formato a todos os arquivos salvos e, em seguida, verificando se algum
os arquivos foram alterados (e, portanto, marcados com um símbolo de disco na caixa de listagem de arquivos).

Ferramentas → Aplicar codificação de texto
Define a codificação de texto selecionada em Configurações / Configurar Kid3 ... / Tags / Tag 2 para todos
arquivos selecionados. Se UTF8 for selecionado, UTF16 será usado para tags ID3v2.3.0 porque
UTF8 não é compatível com este formato.

Ferramentas → Renomear diretório ...
Esta caixa de diálogo oferece a possibilidade de renomear automaticamente o atualmente aberto
diretório de acordo com as tags nos arquivos. Vários formatos são pré-configurados para
inclua informações sobre artista, álbum e ano no nome do diretório. Isso é também
possível definir um formato personalizado, os seguintes códigos especiais são usados ​​para inserir a tag
valores no nome do diretório:

· Título de% s% {title} (música)

·% A% {artist} Artista

· Álbum% l% {album}

·% C% {comment} Comentário

·% Y% {year} ano

· Trilha% t% {track} (por exemplo, 01)

·% T% {track.n} Trilha com largura de campo n (por exemplo, 001 para% {track.3})

· Faixa% T% {tracknumber} (sem zeros à esquerda, por exemplo, 1)

· Gênero% g% {genre}

Se um separador de diretório "/" for encontrado no formato, vários diretórios serão criados.
Se você quiser criar um novo diretório em vez de renomear o diretório atual,
selecione Criar diretório em vez de Renomear diretório. A fonte das informações da tag
pode ser escolhido entre Da Tag 1 e Tag 2, Da Tag 1 e Da Tag 2. Uma prévia para
a operação de renomeação realizada no primeiro arquivo pode ser vista em De e Para
seções do diálogo.

Vários diretórios podem ser renomeados selecionando-os.

Ferramentas → Numerar faixas ...
Se os números das faixas nas tags não estiverem configurados ou tiverem valores errados, esta função
pode numerar as faixas automaticamente em ordem crescente. O número inicial pode ser definido em
o diálogo. Se apenas parte das faixas tiver que ser numerada, elas devem ser selecionadas.

Quando o número total de faixas é verificado, o número de faixas também será definido no
Tag.

É possível numerar as faixas em vários diretórios. As pastas têm que ser
expandido e selecionado.

Se Reiniciar contador para cada diretório estiver marcado, a numeração das trilhas é reiniciada com o
determinado número para cada diretório quando várias pastas são selecionadas.

A caixa de diálogo de faixas de números também pode ser usada para formatar os números das faixas existentes sem
alterar os valores quando a caixa de seleção à esquerda para Número inicial estiver desativada. O total
número de faixas será adicionado se a caixa de seleção correspondente estiver ativa, que pode ser
usado para definir o total de todas as faixas selecionadas. Se apenas a formatação do existente
se desejar números, esta caixa de seleção também deve ser desativada.

Ferramentas → Filtro ...
O filtro pode ser usado para exibir apenas os arquivos que correspondem a determinados critérios. Esse
é útil se você deseja organizar uma grande coleção e apenas editar os arquivos que
não estão no esquema desejado. A expressão que define quais arquivos exibir usa o
mesmos códigos de formato que são usados ​​no formato do nome do arquivo, importação e exportação.

· Título de% s% {title} (música)

·% A% {artist} Artista

· Álbum% l% {album}

·% C% {comment} Comentário

·% Y% {year} ano

· Trilha% t% {track} (por exemplo, 01)

·% T% {track.n} Trilha com largura de campo n (por exemplo, 001 para% {track.3})

· Faixa% T% {tracknumber} (sem zeros à esquerda, por exemplo, 1)

· Gênero% g% {genre}

·% F% {file} Nome do arquivo

·% P% {filepath} Caminho absoluto para o arquivo

·% E% {extension} Extensão de arquivo

·% O% {tag1} O formato da tag 1 (ID3v1.1 ou vazio se não houver)

·% O% {tag2} O formato da tag 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF ou vazio se não existir)

· Taxa de bits% b% {bitrate} em kbit / s

·% V% {vbr} VBR ou vazio (apenas para ID3v2.3 com id3lib)

·% R% {samplerate} Taxa de amostragem em Hz

· Modo de canal% m% {mode} (Estéreo ou Joint Stereo)

·% H% {channels} Número de canais (1 ou 2)

· Codec% k% {codec} (por exemplo, MPEG 1 Camada 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

·% 1a% 1 {artist}, ... Use o prefixo 1 para obter os valores da tag 1

·% 2a% 2 {artist}, ... Use o prefixo 2 para obter os valores da tag 2

Esses códigos são substituídos pelos valores do arquivo, e as strings resultantes podem
ser comparado com as seguintes operações:

· S1 é igual a s2: verdadeiro se s1 e s2 são iguais.

· S1 contém s2: verdadeiro se s1 contém s2, ou seja, s2 é uma substring de s1.

· S corresponde a re: true se s corresponde à expressão regular re.

Expressões verdadeiras são substituídas por 1, falsas por 0. Valores verdadeiros são representados por 1,
verdadeiro, ativado e sim, valores falsos por 0, falso, desativado e não. As operações booleanas não são,
e, ou (nesta ordem de precedência) e podem ser agrupados por parênteses.

Algumas regras de filtro são predefinidas e podem servir como exemplos para suas próprias expressões:

Todos os Produtos
Quando a lista de arquivos é filtrada - isso é mostrado por "[filtrado]" no título da janela
- e todos os arquivos serão exibidos novamente, a filtragem pode ser revertida usando este
filtro. Ele usa uma expressão vazia, mas um valor verdadeiro teria o mesmo efeito.

Tag do nome do arquivo incompatível
não (%{caminho de arquivo} contém "%{artista} - % {album} /% {track} %{título}")

Testa se o caminho do arquivo está de acordo com o formato do nome do arquivo. Esta regra é
adaptado automaticamente se o formato do nome do arquivo mudar.

Sem Tag 1
% {tag1} é igual a ""

Exibe apenas arquivos que não possuem uma tag 1.

Sem Tag 2
% {tag2} é igual a ""

Exibe apenas arquivos que não possuem uma tag 2.

Tag ID3v2.3.0
% {tag2} é igual a "ID3v2.3.0"

Exibe apenas arquivos que possuem uma tag ID3v2.3.0.

Tag ID3v2.4.0
% {tag2} é igual a "ID3v2.4.0"

Exibe apenas arquivos que possuem uma tag ID3v2.4.0.

Tag 1! = Tag 2
não (% 1 {título} é igual a % 2 {title} e % 1 {álbum} é igual a % 2 {álbum} e % 1 {artista}
é igual a % 2 {artista} e %1 comentário} é igual a %2 comentário} e %1 ano} é igual a %2 ano}
e % 1 {track} é igual a % 2 {track} e % 1 {gênero} é igual a % 2 {gênero})

Exibe arquivos com diferenças entre tag 1 e tag2.

Marca 1 == Marca 2
% 1 {title} é igual a % 2 {title} e % 1 {álbum} é igual a % 2 {álbum} e % 1 {artista} é igual a
% 2 {artista} e %1 comentário} é igual a %2 comentário} e %1 ano} é igual a %2 ano} e
% 1 {track} é igual a % 2 {track} e % 1 {gênero} é igual a % 2 {gênero}

Exibe arquivos com tag 1 e tag 2 idênticos.

Incompleto
%{título} é igual a "" or %{artista} é igual a "" or %{álbum} é igual a "" or %{ano} é igual a
"" or %{número de rastreio} é igual a "" or %{gênero} é igual a ""

Exibe arquivos com valores vazios nas tags padrão (título, artista, álbum, data,
número da faixa, gênero).

sem imagem
%{foto} é igual a ""

Exibe apenas arquivos que não possuem uma imagem.

Filtro customizado
Para adicionar seu próprio filtro, selecione esta entrada. Por exemplo, se você quiser ter um
filtro para artistas que começam com "The", substitua "Custom Filter" pelo nome "The"
Bands "e pressione Enter. Em seguida, insira a seguinte expressão na edição de linha:

%{artista} fósforos "O.*"

Em seguida, clique em Salvar configurações. Clique em Aplicar para filtrar os arquivos. Todos os arquivos processados ​​são
exibido na visualização de texto, com um "+" para aqueles que correspondem ao filtro e um "-"
para os outros. Ao terminar, apenas os arquivos com um artista começando com "The"
são exibidos e o título da janela é marcado com "[filtrado]".

Ferramentas → Converter ID3v2.3 em ID3v2.4
Se houver alguma tag ID3v2.3 nos arquivos selecionados, eles serão convertidos para ID3v2.4
Tag. Quadros que não são suportados pela TagLib serão descartados. Apenas arquivos sem
as alterações não salvas serão convertidas.

Ferramentas → Converter ID3v2.4 em ID3v2.3
Se houver alguma tag ID3v2.4 nos arquivos selecionados, eles serão convertidos para ID3v2.3
Tag. Somente arquivos sem alterações não salvas serão convertidos.

Ferramentas → Jogar
Isso abre uma barra de ferramentas simples para reproduzir arquivos de áudio. Ele contém botões para o básico
operações (Reproduzir / Pausar, Parar a reprodução, Faixa Anterior, Próxima Faixa, Fechar), controles deslizantes para
posição e volume e uma exibição da posição atual. Se vários arquivos forem
selecionado, as faixas selecionadas são reproduzidas, caso contrário, todos os arquivos serão reproduzidos.

A Configurações Menu
Configurações → Mostrar barra de ferramentas
Alterna a exibição da barra de ferramentas.

Configurações → Mostrar barra de status
Alterna a exibição da barra de status, que exibe ações mais longas, como abrir ou
salvar um diretório.

Configurações → Mostrar imagem
Alterna a exibição da imagem de visualização da arte da capa do álbum.

Configurações → Ocultar automaticamente as marcas
Tags vazias são automaticamente ocultadas se esta opção estiver ativa. O Arquivo, Tag 1 e Tag
2 seções podem ser recolhidas e expandidas manualmente clicando no correspondente - / +
botões.

Configurações → Configurar Kid3 ...
Abre a caixa de diálogo de configuração, que consiste em páginas para tags, arquivos, ações do usuário,
e configurações de rede.

Opções específicas de tag podem ser encontradas na página Tags, que é separada em
três guias para Tag 1, Tag 2 e Tag 1 e Tag 2.

Se Marcar campos truncados estiver marcado, os campos ID3v1.1 truncados serão marcados em vermelho. o
os campos de texto das tags ID3v1.1 podem ter apenas 30 caracteres, o comentário apenas 28
personagens. Além disso, o gênero e os números das faixas são restritos, de modo que os campos podem ser
truncado quando importado ou transferido de ID3v2. Campos truncados e o arquivo
serão marcados em vermelho e a marca será removida após o campo ser editado.

Com a codificação de texto para ID3v1, é possível definir o conjunto de caracteres usado em ID3v1
Tag. Esta codificação é supostamente ISO-8859-1, por isso é recomendado manter esta
valor padrão. No entanto, existem tags com codificação diferente, então pode ser
definido aqui e as tags ID3v1 podem então ser copiadas para ID3v2 que suporta Unicode.

A caixa de seleção Usar faixa / número total de formato de faixas controla se a faixa
campo de número de tags ID3v2 contém simplesmente o número da faixa ou adicionalmente o total
número de faixas no diretório.

Quando Gênero como texto em vez de string numérica for verificado, todos os gêneros ID3v2 serão
armazenado como uma string de texto, mesmo se houver um código correspondente para gêneros ID3v1. Se
esta opção não está definida, gêneros para os quais existe um código ID3v1 são armazenados como o número
do código do gênero (entre parênteses para ID3v2.3). Assim, o gênero Metal é armazenado como
"Metal" ou "(9)" dependendo desta opção. Gêneros que não estão na lista de ID3v1
os gêneros são sempre armazenados como uma string de texto. O objetivo desta opção é melhorado
compatibilidade com dispositivos que não interpretam corretamente os códigos de gênero.

A codificação de texto define a codificação padrão usada para frames ID3v2 e pode ser definida como
ISO-8859-1, UTF16 ou UTF8. UTF8 não é válido para frames ID3v2.3.0; se estiver definido,
Em vez disso, será usado UTF16. Para quadros ID3v2.4.0, todas as três codificações são possíveis.

A versão usada para novas tags determina se novas tags ID3v2 são criadas como versão
2.3.0 ou 2.4.0. No primeiro caso, id3lib é usado como era nas versões anteriores do
Kid3 e TagLib são aplicados apenas quando uma tag ID3v2.4.0 é encontrada. No segundo
caso, ID3v2.4.0 (TagLib), TagLib é geralmente usado para arquivos MP3; mudou ou recentemente
as tags criadas serão salvas na versão 2.4.0. Quando ID3v2.3.0 (TagLib) é selecionado,
TagLib também é usado para tags ID3v2.3.0.

Dígitos do número da trilha é o número de dígitos nos campos de número da trilha. Os zeros à esquerda são
usado para acolchoar. Por exemplo, com um valor de 2, o número da faixa 5 é definido como "05".

O nome do campo de comentário da caixa de combinação só é relevante para arquivos Ogg / Vorbis e FLAC e
define o nome do campo usado para comentários. Diferentes aplicativos parecem usar
nomes diferentes, "COMMENT", por exemplo, é usado pelo xmms, enquanto o amaroK usa
"DESCRIÇÃO".

O formato das imagens em arquivos Ogg / Vorbis é determinado pelo nome do campo Imagem, que
pode ser METADATA_BLOCK_PICTURE ou COVERART. O primeiro é o padrão oficial e usa
o mesmo formato das imagens em tags FLAC. COVERART é uma forma não oficial anterior de
incluir fotos nos comentários de Vorbis. Pode ser usado para compatibilidade com legado
jogadores.

Se a caixa de seleção Marcar se maior que estiver ativada, os arquivos que contêm o álbum incorporado
a arte da capa que excede o tamanho fornecido em bytes é marcada em vermelho. Isso pode ser usado para encontrar
arquivos contendo imagens grandes que não são aceitas por alguns aplicativos e
jogadoras. O valor padrão é 131072 bytes (128 KB).

Gêneros personalizados podem ser usados ​​para definir gêneros que não estão disponíveis no padrão
lista de gênero, por exemplo, "Gothic Metal". Esses gêneros personalizados aparecerão na caixa de combinação Gênero
do Tag 2. Para os tags ID3v1.1, apenas os gêneros predefinidos podem ser usados.

A lista de gêneros personalizados também pode ser usada para reduzir o número de gêneros disponíveis em
a caixa de combinação Gênero para aqueles normalmente usados. Se sua coleção contém principalmente música
nos gêneros Metal, Gothic Metal, Ancient e Hard Rock, você pode inserir esses gêneros
e marque Mostrar apenas gêneros personalizados. A caixa de combinação Tag 2Genre conterá apenas
esses quatro gêneros e você não terá que pesquisar na lista completa de gêneros para
eles. Neste exemplo, apenas Metal e Hard Rock serão listados nos gêneros tag 1
lista, porque essas duas entradas de gêneros personalizados são gêneros padrão. Se Mostrar apenas personalizado
gênero não está ativo, os gêneros personalizados podem ser encontrados no final da lista de gêneros.

Quadros de acesso rápido definem quais tipos de quadro são sempre mostrados na seção Tag 2.
Esses quadros podem então ser adicionados sem primeiro usar o botão Adicionar. A ordem destes
Os quadros de acesso rápido podem ser alterados arrastando e soltando itens.

Formato da tag contém opções para o formato das tags. Quando Formatar durante a edição é
marcada, a configuração do formato é usada automaticamente ao editar o texto na linha
Editar% s. A conversão de maiúsculas pode ser definida como Sem alterações, Todas em minúsculas, Todas em maiúsculas,
Primeira letra maiúscula ou Todas as primeiras letras maiúsculas. Para usar a conversão com reconhecimento de localidade
entre caracteres minúsculos e maiúsculos, uma localidade pode ser selecionada na caixa de combinação
abaixo. A lista de substituição de string pode ser definida para mapeamentos de string arbitrários. Para adicionar um
novo mapeamento, selecione a célula De de uma linha, insira o texto a ser substituído e vá para
a coluna Para e insira o texto de substituição. Para remover um mapeamento, defina a célula De para
um valor vazio (por exemplo, digitando primeiro espaço e, em seguida, backspace). Inserindo e excluindo
linhas também é possível usando um menu de contexto que aparece quando o botão direito do mouse
é clicado. A substituição só está ativa se a caixa de seleção Substituição de string estiver marcada.

Na página Arquivos a caixa de seleção Carregar os últimos arquivos abertos pode ser marcada para que Kid3
abra e selecione o último arquivo selecionado quando for iniciado na próxima vez. Preservar
o carimbo de data / hora do arquivo pode ser verificado para preservar o carimbo de data / hora de modificação do arquivo. Nome do arquivo
para conjuntos de capa, o nome que é sugerido quando uma imagem incorporada é exportada para um
arquivo.

Se Marcar alterações estiver ativo, os campos alterados são marcados com um rótulo cinza claro
fundo.

Formato do nome de arquivo contém opções para o formato dos nomes de arquivo. As mesmas opções que
em formato de tag estão disponíveis.

A página Ações do usuário contém uma tabela com os comandos que estão disponíveis no
menu de contexto da lista de arquivos. Para operações críticas, como exclusão de arquivos, é
aconselhável marcar Confirmar para abrir uma caixa de diálogo de confirmação antes de executar o
comando. A saída pode ser marcada para ver a saída escrita pelos comandos do console (padrão
saída e erro padrão). Nome é o nome exibido no menu de contexto. Comando
é a linha de comando a ser executada. Os argumentos podem ser passados ​​usando os seguintes códigos:

·% F% {arquivos} Caminhos de arquivo (uma lista se vários arquivos selecionados)

·% F% {file} Caminho de arquivo para arquivo único

· URLs% uF% {urls} (uma lista se vários arquivos selecionados)

· URL% uf% {url} para arquivo único

· Diretório% d% {diretório}

· Título de% s% {title} (música)

·% A% {artist} Artista

· Álbum% l% {album}

·% C% {comment} Comentário

·% Y% {year} ano

· Trilha% t% {track} (por exemplo, 01)

·% T% {track.n} Trilha com largura de campo n (por exemplo, 001 para% {track.3})

· Faixa% T% {tracknumber} (sem zeros à esquerda, por exemplo, 1)

· Gênero% g% {genre}

· Comando% b% {browser} para iniciar o navegador da web

·% Q% {qmlpath} Diretório base dos arquivos QML fornecidos

O código especial @separador pode ser definido como um comando para inserir um separador no
menu de contexto das ações do usuário. Os itens do menu podem ser colocados em um submenu, incluindo-os
@beginmenu e @endmenu comandos. O nome do submenu é determinado pelo Nome
coluna do @beginmenu comando.

Para executar scripts QML, @qml é usado como um nome de comando. O caminho para o script QML é
passado como um parâmetro. Os scripts fornecidos podem ser encontrados na pasta
% {qmlpath} / script / (no Linux normalmente / usr / share / kid3 / qml / script /, no Windows
qml / script / dentro do diretório de instalação e no OS X na pasta do aplicativo
kid3.app/Contents/Resources/qml/script/). Os scripts personalizados podem ser armazenados em qualquer
diretório. Se o código QML usa componentes GUI, @qmlview deve ser usado em vez de
@qml. Parâmetros adicionais são passados ​​para o script QML onde estarão disponíveis
via getArguments () função. Uma visão geral de algumas funções e propriedades que
estão disponíveis em QML e podem ser encontrados no apêndice Interface QML.

O comando que será inserido com% {navegador} pode ser definido no navegador da Web
linha de edição acima. Comandos que começam com% {browser} podem ser usados ​​para buscar informações
sobre os arquivos de áudio da web, por exemplo

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

irá consultar a letra da música atual em LetraWiki[10]. O "u" em% u {artist} e
% u {title} é usado para codificar por URL as informações do artista% {artist} e da música% {title}. Isto
é fácil definir suas próprias consultas da mesma maneira, por exemplo, uma pesquisa de imagens com
Google[11]:

%{navegador} http://images.google.com/images? q =% u {artista}% 20% u {álbum}

Para adicionar a arte da capa do álbum à tag 2, você pode pesquisar imagens com o Google ou Amazon usando
os comandos descritos acima. A imagem pode ser adicionada à tag arrastando e soltando.
Você também pode adicionar uma imagem com Adicionar, em seguida, selecionar a moldura e importar uma imagem
arquivo ou cole da área de transferência. Os porta-retratos são compatíveis com ID3v2, MP4, FLAC,
Tags Ogg e ASF.

Para adicionar e excluir entradas na tabela, um menu de contexto pode ser usado.

A página Rede contém apenas um campo para inserir o endereço do proxy e, opcionalmente, o
porta, separados por dois pontos. O proxy será usado ao importar de um Internet
servidor quando a caixa de seleção está marcada.

Na página Plug-ins, os plug-ins disponíveis podem ser ativados ou desativados. Os plugins são
separados em duas seções. A lista de plugins e prioridades de metadados contém plugins
que suportam formatos de arquivo de áudio. A ordem dos plug-ins é importante porque eles
são testados de cima para baixo. Alguns formatos são suportados por vários plug-ins, portanto, os arquivos
será aberto com o primeiro plugin que os suporta. O TaglibMetadata suporta a maioria
formatos, se estiver no topo da lista, ele abrirá a maioria dos arquivos. Se você quiser
para usar um plugin diferente para um formato de arquivo, certifique-se de que ele esteja listado antes de
Plug-in TaglibMetadata. Detalhes sobre o plugin de metadados e por que você pode querer usar
eles em vez de TagLib estão listados abaixo.

· Id3libMetadata: Usos id3lib[12] para tags ID3v1.1 e ID3v2.3 em MP3, MP2, AAC
arquivos. Suporta mais alguns tipos de quadro do que TagLib. Outra razão para usá-lo é
que TagLib suporta apenas ID3v2.3 desde a versão 1.8.

· OggFlacMetadata: Usos libogg[13], libvorbis, arquivo libvorbis[14] para arquivos Ogg, e
adicionalmente libFLAC ++ e libFLAC[15] para arquivos FLAC. As razões para usá-los são
imagens em arquivos Ogg, que não são suportados por TagLib e que estes são os
bibliotecas oficiais para esses formatos.

· TaglibMetadata: Usos TagLibName[16] que suporta vários formatos de arquivo de áudio. Desde a
versão 1.8, ele também suporta ID3v2.3, então pode ser usado para todos os arquivos de áudio
apoiado por Kid3.

· Metadados Mp4v2: mp4v2[17] foi originalmente usado por Kid3 para suportar arquivos M4A.
No entanto, as versões mais recentes do TagLib fornecem bom suporte M4A, portanto, este plugin não é
construído por padrão.

A seção Plug-ins disponíveis lista os plug-ins restantes. A ordem deles não é
importante, mas eles podem ser ativados ou desativados usando as caixas de seleção.

· AmazonImport: Usado para a função Importar da Amazon ....

· DiscogsImport: Usado para a função Importar do Discogs ....

· FreedbImport: Usado para importar de gnudb.org ... e importar de
TrackType.org ... funções.

· MusicBrainzImport: Usado para a função Importar do MusicBrainz Release ....

· AcoustidImport: Usado para a função Importar da impressão digital MusicBrainz ...,
que depende do Cromaprint[18] e libav[19] bibliotecas.

Plugins desabilitados não serão carregados. Isso pode ser usado para otimizar recursos
uso e tempo de inicialização. As configurações nesta página só entram em vigor após o reinício do
Criança3.

Configurações → Configurar atalhos ...
Abre uma caixa de diálogo para atribuir atalhos de teclado para a maioria das funções do programa. Lá
são até funções sem menu ou botão correspondente disponível, por exemplo, próximo arquivo,
arquivo anterior, selecione tudo.

A Ajuda Menu
Ajuda → Manual do Kid3
Abre este manual.

Ajuda → Sobre Kid3
Exibe uma breve informação sobre Kid3 ;.

KID3-CLI

comandos
kid3-cli oferece uma interface de linha de comando para Kid3. Se um caminho de diretório for usado, o
o diretório é aberto. Se um ou mais caminhos de arquivo forem fornecidos, o diretório comum é aberto
e os arquivos são selecionados. Os comandos subsequentes funcionarão nesses arquivos. Comandos
são especificados usando -c opções. Se vários comandos forem passados, eles serão executados no
dada ordem. Se os arquivos forem modificados pelos comandos, eles serão salvos no final. Se não
opções de comando são passadas, kid3-cli começa no modo interativo. Os comandos podem ser inseridos
e irá operar na seleção atual. As seções a seguir listam todos os disponíveis
comandos.

Ajuda
ajudar [NOME DO COMANDO]

Exibe ajuda sobre os parâmetros de NOME DO COMANDO ou sobre todos os comandos se nenhum comando
o nome é fornecido.

Timeout
tempo limite [padrão | desligado | TIME]

Substitua o tempo limite de comando padrão. Os comandos CLI abortam após um comando específico
o tempo limite expirou. Este tempo limite é de 10 segundos para ls e Albumart, 60 segundos para
importação automática e filtroe 3 segundos para todos os outros comandos. Se um grande número de arquivos
precisa ser processado, esses tempos limite podem ser muito restritivos, portanto, o tempo limite para todos
os comandos podem ser definidos para TIME ms, totalmente desligado ou deixado no padrão
valores.

desistir Formulário on line
saída [força]

Sair da aplicação. Se houver arquivos não salvos modificados, o força parâmetro é
necessário.

Mudar anuário
cd [DIRETÓRIO]

Se nenhum DIRETÓRIO for fornecido, mude para o diretório inicial. Se um diretório for fornecido,
mude para o diretório. Se um ou mais caminhos de arquivo forem fornecidos, mude para o caminho comum
diretório e selecione os arquivos.

Impressão que o atual trabalhar anuário
pwd

Imprime o nome do arquivo do diretório de trabalho atual.

Diretório Lista
ls

Liste o conteúdo do diretório atual. Isso corresponde à lista de arquivos no
Kid3 GUI. Quatro caracteres antes dos nomes dos arquivos mostram o estado do arquivo.

·> Arquivo é selecionado.

· * O arquivo é modificado.

· 1 O arquivo possui uma tag 1, caso contrário, '-' será exibido.

· 2 O arquivo possui uma tag 2, caso contrário, '-' será exibido.

kid3-cli> ls
1- 01 Introdução.mp3
> 12 02 We Only Got This One.mp3
* 1- 03 Outro.mp3

Neste exemplo, todos os arquivos possuem uma tag 1, o segundo arquivo também possui uma tag 2 e é
selecionado. O terceiro arquivo é modificado.

Salvar que o mudado arquivos
salvar

Selecionar lima
selecionar [todos | nenhum | primeiro | anterior | próximo | ARQUIVO...]

Para selecionar todos os arquivos, digite selecionar todos os, para desmarcar todos os arquivos, digite selecionar Nenhum. Para
percorrer os arquivos no diretório atual e começar com selecionar primeiro, então vá em frente
utilização selecionar Próximo ou para trás usando selecionar anterior. Arquivos específicos podem ser adicionados a
a seleção atual, fornecendo seus nomes de arquivo. Caracteres curinga são possíveis, então selecionar
* .mp3 irá selecionar todos os arquivos MP3 no diretório atual.

kid3-cli> selecionar primeiro
kid3-cli> ls
> 1- 01 Intro.mp3
12 02 Só Temos Este.mp3
* 1- 03 Outro.mp3
kid3-cli> selecionar Próximo
kid3-cli> ls
1- 01 Introdução.mp3
> 12 02 We Only Got This One.mp3
* 1- 03 Outro.mp3
kid3-cli> selecionar * .mp3
kid3-cli> ls
> 1- 01 Intro.mp3
> 12 02 We Only Got This One.mp3
> * 1- 03 Outro.mp3

Selecionar etiqueta
etiqueta [NÚMEROS DE TAG]

Muitos comandos têm um opcional NÚMEROS DE TAG parâmetro, que especifica se o
comando opera na tag 1 ou tag 2. Se este parâmetro for omitido, a tag padrão
números são usados, que podem ser definidos por este comando. Na inicialização, é definido como 12, que
significa que a informação é lida da tag 2, se disponível, caso contrário, da tag 1; modificações
são feitos na tag 2. O NÚMEROS DE TAG pode ser definido para 1 or 2 para operar apenas no
tag correspondente. Se o parâmetro for omitido, a configuração atual será exibida.

Get etiqueta quadro
ter [todos | QUADRO-NAME] [NÚMEROS DE TAG]

Este comando pode ser usado para ler o valor de um quadro de tag específico ou obter informações
sobre todos os quadros de tag (se o argumento for omitido ou todos os é usado). Os quadros modificados são
marcado com um '*'.

kid3-cli> ter
Arquivo: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo
Nome: 01 Intro.mp3
Etiqueta 1: ID3v1.1
Título Intro
Artista One Hit Wonder
Álbum vamos marcar
data 2013
Faixa Número 1
Pop de gênero
kid3-cli> ter título
Intro

Para salvar o conteúdo de uma moldura de imagem em um arquivo, use

ter imagem: "/ caminho / para / pasta.jpg"

Para salvar letras sincronizadas em um arquivo LRC, use

ter SYLT: "/ caminho / para / lyrics.lrc"

Conjunto etiqueta quadro
conjunto {QUADRO-NAME} {QUADRO-VALOR} [NÚMEROS DE TAG]

Este comando define o valor de um quadro de tag específico.

kid3-cli> conjunto remixer "OH Maravilha"

Para definir o conteúdo de um quadro de imagem a partir de um arquivo, use

conjunto imagem: "/ caminho / para / pasta.jpg" "Foto Descrição"

Para definir letras sincronizadas de um arquivo LRC, use

conjunto SYLT: "/ caminho / para / lyrics.lrc" "Letra da música Descrição"

Reverter
reverter

Reverter todas as modificações nos arquivos selecionados (ou todos os arquivos se nenhum arquivo estiver
selecionado).

importação da lima or prancheta
importar {ARQUIVO} {NOME DO FORMATO} [NÚMEROS DE TAG]

As tags são importadas do arquivo ARQUIVO (ou da área de transferência se prancheta é usado para
ARQUIVO) no formato com o nome NOME DO FORMATO (por exemplo: "CSV não citado ", consulte Importar).

Automático importar
importação automática [NOME DO PERFIL] [NÚMEROS DE TAG]

Importação em lote usando perfil NOME DO PERFIL (veja Importação Automática, "Tudo" é usado se
omitido).

Baixar álbum cobrir arte
Albumart {URL} [tudo]

Defina a capa do álbum baixando uma imagem de URL. As regras definidas no
A caixa de diálogo Browse Cover Art é usada para transformar URLs gerais (por exemplo, da Amazon) em um
URL da imagem. Para definir a capa do álbum a partir de um arquivo de imagem local, use o comando set.

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

Exportações para lima or prancheta
exportar {ARQUIVO} {NOME DO FORMATO} [NÚMEROS DE TAG]

Tags são exportadas para arquivo ARQUIVO (ou para a área de transferência se prancheta é usado para ARQUIVO) em
o formato com o nome NOME DO FORMATO (por exemplo: "CSV não citado ", consulte Exportar).

Crie lista
lista

Crie uma lista de reprodução no formato definido na configuração, consulte Criar lista de reprodução.

Aplicar nome do arquivo formato
formato do arquivo

Aplicar formato de nome de arquivo definido na configuração, consulte Aplicar formato de nome de arquivo.

Aplicar etiqueta formato
formato de etiqueta

Aplicar formato de nome de tag definido na configuração, consulte Aplicar formato de tag.

Aplicar texto codificação
codificação de texto

Aplicar codificação de texto definida na configuração, consulte Aplicar codificação de texto.

Rebatizar anuário
renomeado [FORMATO] [criar | renomear | funcionamento a seco] [NÚMEROS DE TAG]

Renomeie ou crie diretórios a partir dos valores nas tags de acordo com um determinado FORMATO
(por exemplo: %{artista} - %{álbum}, consulte Renomear diretório), se nenhum formato for fornecido, o formato
definido na caixa de diálogo Renomear diretório é usado. O modo padrão é rebatizar; para criar
diretórios, crio deve ser fornecido explicitamente. As ações de renomeação serão realizadas
imediatamente, apenas para ver o que seria feito, use o funcionamento a seco opção.

Sessão faixas
trilhas numéricas [NÚMERO DE RASTREIO] [NÚMEROS DE TAG]

Numere as faixas selecionadas começando com NÚMERO DE RASTREIO (1 se omitido).

filtros
filtro [NOME DO FILTRO | FORMATO DE FILTRO]

Filtre os arquivos para que apenas os arquivos que correspondem ao FORMATO DE FILTRO são visíveis. o
nome de uma expressão de filtro predefinida (por exemplo "Nome do arquivo etiqueta Mismatch ") pode ser usado
em vez de uma expressão de filtro, consulte Filtro.

kid3-cli> filtro '%{título} contém "tro" '
Iniciado
/ home / urs / One Hit Wonder - Vamos marcar
+ 01 Introdução.mp3
- 02 Só Temos Este.mp3
+ 03 Outro.mp3
Acabado
kid3-cli> ls
1- 01 Introdução.mp3
1- 03 Outro.mp3
kid3-cli> filtro Todos os Produtos
Iniciado
/ home / urs / One Hit Wonder - Vamos marcar
+ 01 Introdução.mp3
+ 02 Só Temos Este.mp3
+ 03 Outro.mp3
Acabado
kid3-cli> ls
1- 01 Introdução.mp3
12 02 Só Temos Este.mp3
1- 03 Outro.mp3

Converter ID3v2.3 para ID3v2.4
to24

Converter ID3v2.4 para ID3v2.3
to23

Nome do arquivo da etiqueta
da etiqueta [FORMATO] [NÚMEROS DE TAG]

Defina os nomes dos arquivos selecionados a partir dos valores nas tags, por exemplo da etiqueta
"%{acompanhar} - %{título}" 1. Se nenhum formato for especificado, o formato definido na GUI será usado.

etiqueta da nome do arquivo
etiquetar [FORMATO] [NÚMEROS DE TAG]

Defina os quadros de tag a partir dos nomes dos arquivos, por exemplo etiquetar "%{Álbum do artista} -
% {album} /% {track} %{título}" 2. Se nenhum formato for especificado, o formato definido na GUI é
usado. Se o formato do nome do arquivo não corresponder a este padrão, alguns outros comumente
formatos usados ​​são testados.

etiqueta para de outros etiqueta
sintô {NÚMERO DA ETIQUETA}

Copie os quadros de tag de uma tag para outra tag, por exemplo, para definir a tag ID3v2 do
Tag ID3v1, use sintô 2.

Copiar
cópia [NÚMERO DA ETIQUETA]

Copie os quadros de tag do arquivo selecionado para o buffer de cópia interno. Eles podem então ser
definido em outro arquivo usando o colar comando.

macarrão
colar [NÚMERO DA ETIQUETA]

Defina frames de tag a partir do conteúdo do cópia buffer nos arquivos selecionados.

Eliminar
remover [NÚMERO DA ETIQUETA]

Remova uma tag.

Jogar
play [pausa | pare | anterior | próximo]

Inicie a reprodução de áudio. Uma vez iniciado, pode ser controlado com o pausa
(para pausar e retomar), Pare, anterior e Próximo opções.

Exemplos
Defina a capa do álbum em todos os arquivos de um diretório usando a função de importação em lote:

kid3-cli -c 'autoimportação "Cobrir Arte"' / caminho / para / dir

Remova os quadros de comentários e aplique o formato da tag em ambas as tags de todos os arquivos MP3 de um
diretório:

kid3-cli -c 'definir comentar "" 1' -c 'definir comentar "" 2' \
-c 'tagformat 1' -c 'tagformat 2' /caminho/para/dir/*.mp3

Importe automaticamente a tag 2, sincronize com a tag 1, defina os nomes dos arquivos da tag 2 e finalmente
crie uma lista de reprodução:

kid3-cli -c importação automática -c 'syncto 1' -c da etiqueta -c lista \
/caminho/para/dir/*.mp3

Para todos os arquivos com uma tag ID3v2.4.0, converta para ID3v2.3.0 e remova o frame do arranjador:

kid3-cli -c "filtro 'ID3v2.4.0 Marcação'" -c "selecionar tudo" -c to23 \
-c "definir organizar '' " / caminho / para / dir

Este script Python usa kid3-cli para gerar o som do iTunes Verifique os quadros do iTunNORM de
replay obter informações.

#!/ usr / bin / env python
# Gere verificação de som do iTunes a partir de ReplayGain.
de __future__ importar print_function
importar os, sys, subprocesso

def rg2sc (dirpath):
para root, dirs, arquivos em os.walk (dirpath):
para nome em arquivos:
if name.endswith (('. mp3', '.m4a', '.aiff', '.aif')):
fn = os.path.join (raiz, nome)
rg = subprocess.check_output ([
'kid3-cli', '-c', 'obter "replaygain_track_gain"',
fn]). strip ()
if rg.endswith (b 'dB'):
rg = rg [: - 3]
tente:
rg = float (rg)
exceto ValueError:
print ('Valor% s de% s em não flutuante'% (rg, fn))
continuar
sc = ('' + ('% 08X'% int ((10 ** (-rg / 10)) * 1000))) * 10
subprocess.call ([
'kid3-cli', '-c', 'definir iTunNORM "% s"'% sc, fn])

se __name__ == '__main__':
rg2sc (sys.argv [1])

CRÉDITOS E LICENÇA

Kid3

Programa escrito por Urs Fleisch

LDF[20]

GLP[21]

INSTALAÇÃO

Como funciona o dobrador de carta de canal para obter Kid3
Kid3 pode ser encontrado em http://kid3.sourceforge.net.

Requisitos
Kid3 precisa Qt[22]. KDE[23] é recomendado, mas não necessário, pois Kid3 também pode ser compilado
como um aplicativo Qt. Kid3 pode ser compilado para sistemas onde essas bibliotecas são
disponível, por exemplo, para GNU / Linux, Windows e Mac OS X. Para marcar arquivos Ogg / Vorbis, libogg[13],
libvorbis e arquivo libvorbis[14] são necessários, para arquivos FLAC libFLAC ++ e libFLAC[15].
id3lib[12] é usado para arquivos MP3. Esses quatro formatos também são suportados por TagLibName[16],
que também pode lidar com arquivos Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF
e módulos de rastreador. Para importar de impressões digitais acústicas, Cromaprint[18] e libav[19]
são usados.

Kid3 está disponível para a maioria das distribuições Linux, Windows e Mac OS X. Links podem ser encontrados
on http://kid3.sourceforge.net.

Compilação e Instalação
Você pode compilar Kid3 com ou sem KDE. Sem o KDE, Kid3 é um aplicativo Qt simples e
falta alguns recursos de configuração e sessão.

Para uma versão do KDE, vá para o diretório superior e digite

% cmake .
% fazer
% fazer instalar

Para compilar para diferentes versões do Qt ou KDE, defina o correspondente cmake opções.

Se nem todas as bibliotecas estiverem presentes, Kid3 é construído com funcionalidade reduzida. Então você deveria
tome cuidado para ter todos os pacotes de desenvolvimento desejados instalados. Por outro lado,
cmake-options controlam em quais bibliotecas são compiladas. O padrão é -D
WITH_TAGLIB: BOOL = ON -D WITH_MP4V2: BOOL = OFF -D WITH_ID3LIB: BOOL = ON -D
WITH_CHROMAPRINT: BOOL = ON -D WITH_VORBIS: BOOL = ON -D WITH_FLAC: BOOL = ON . Essas opções podem
ser desabilitado usando OFF.

Para construir o Kid3 como um aplicativo Qt sem KDE, use o cmake opção -DWITH_APPS = Qt. Para
construir um aplicativo KDE e Qt, definir -DWITH_APPS = "Qt; KDE".

Qt 4 ou Qt 5 podem ser usados. Para forçar o uso de Qt 4, defina -DWITH_QT4 = ON, para forçar o uso de
Qt 5, definir -DWITH_QT5 = ON, se ambas as opções estiverem DESLIGADAS (padrão), Qt 4 é o preferido se
ambas as versões estão instaladas. Para usar uma instalação Qt específica, defina
-DQT_QMAKE_EXECUTABLE = / caminho / para / qmake. Se a compilação do aplicativo KDE estiver habilitada, a configuração
O Qt 4 usará o KDE 4, enquanto a configuração do Qt 5 usará o KDE 5.

A geração de pacotes RPM é suportada pelo arquivo kid3.spec, para pacotes Debian, o
script build-deb.shis disponível.

O aplicativo Qt também pode ser compilado para Windows e Mac OS X. Os scripts no
As pastas win32 e macosx podem ser usadas para construir e criar pacotes. As bibliotecas podem ser
instalado usando buildlibs.sh.

Configuração
Com o KDE, o filtro e formato do nome do arquivo, os formatos de importação, o nome do arquivo e ID3
formatos, a barra de ferramentas e as configurações da barra de status, bem como o tamanho da janela serão salvos em
o local padrão no arquivo kid3rc. Como um aplicativo Qt, este arquivo está em
.config / Kid3 / Kid3.conf. No Windows, a configuração é armazenada no registro.

D-BUS INTERFACE

ônibus D Exemplos
As versões Qt 4 e KDE 4 no Linux oferecem uma interface D-Bus para controlar Kid3 por scripts.
Os scripts podem ser escritos em qualquer linguagem com ligações D-Bus (por exemplo, em Python) e podem ser
adicionado às Ações do usuário para estender a funcionalidade do Kid3.

O artista na tag 2 do arquivo atual pode ser definido com o valor "One Hit Wonder" com o
seguinte código:

concha

dbus-send --dest = net.sourceforge.kid3 --print-reply = literal \
/ Kid3 net.sourceforge.Kid3.setFrame int32: 2 string: 'Artista' \
string: 'One Hit Wonder'

ou mais fácil com Qt's qdbus (qdbusviewer pode ser usado para explorar a interface em uma GUI):

qdbus net.sourceforge.kid3 / Kid3 setFrame 2 Artist \
'Um hit maravilha'

Python

importar dbus
kid3 = dbus.SessionBus (). get_object (
'net.sourceforge.kid3', '/ Kid3')
kid3.setFrame (2, 'Artista', 'One Hit Wonder')

Perl

use Net :: DBus;
$ kid3 = Net :: DBus-> session-> get_service (
"net.sourceforge.kid3") -> get_object (
"/ Kid3", "net.sourceforge.Kid3");
$ kid3-> setFrame (2, "Artist", "One Hit Wonder");

ônibus D API
A API D-Bus é especificada em net.sourceforge.Kid3.xml. A interface Kid3 tem o
os seguintes métodos:

Abra lima or anuário
booleano openDirectory (string caminho);

caminho
caminho para arquivo ou diretório

Retorna verdadeiro se estiver OK.

Salvar todos os modificada arquivos
booleano salvar (vazio);

Retorna verdadeiro se estiver OK.

Get a detalhado erro mensagem fornecido by alguns métodos
corda getErrorMessage (void);

Retorna mensagem de erro detalhada.

Reverter alterar in que o selecionado arquivos
reverter (vazio);

Início an automático fornada importar
booleano batchImport (int32 máscara de tag, corda nome do perfil);

máscara de tag
máscara de tag (bit 0 para tag 1, bit 1 para tag 2)

nome do perfil
nome do perfil de importação em lote a ser usado

importação Tag da a lima
booleano importFromFile (int32 máscara de tag, corda caminho, int32 fmtIdx);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

caminho
caminho do arquivo

fmtIdx
índice de formato

Retorna verdadeiro se estiver OK.

Baixar álbum cobrir artigo
downloadAlbumArt (string url, booleano todos os arquivosInDir);

url
URL do arquivo de imagem ou recurso de arte do álbum

todos os arquivosInDir
true para adicionar a imagem a todos os arquivos no diretório

Exportações Tag para a lima
booleano exportToFile (int32 máscara de tag, corda caminho, int32 fmtIdx);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

caminho
caminho do arquivo

fmtIdx
índice de formato

Retorna verdadeiro se estiver OK.

Crie a lista
booleano createPlaylist (void);

Retorna verdadeiro se estiver OK.

desistir que o Formulário on line
sair (vazio);

Selecionar todos os arquivos
selectAll (vazio);

Desmarcar todos os arquivos
desmarcar Tudo (vazio);

Conjunto que o primeiro lima as que o atual lima
booleano firstFile (vazio);

Retorna verdadeiro se houver um primeiro arquivo.

Conjunto que o anterior lima as que o atual lima
booleano previousFile (void);

Retorna verdadeiro se houver um arquivo anterior.

Conjunto que o Próximo lima as que o atual lima
booleano nextFile (void);

Retorna verdadeiro se houver um próximo arquivo.

Selecionar que o primeiro lima
booleano selectFirstFile (void);

Retorna verdadeiro se houver um primeiro arquivo.

Selecionar que o anterior lima
booleano selectPreviousFile (void);

Retorna verdadeiro se houver um arquivo anterior.

Selecionar que o Próximo lima
booleano selectNextFile (void);

Retorna verdadeiro se houver um próximo arquivo.

Selecionar que o atual lima
booleano selectCurrentFile (void);

Retorna verdadeiro se houver um arquivo atual.

Expandir or colapso que o atual lima item if it is a anuário
booleano expandDirectory (void);

Um item da lista de arquivos é um diretório se getFileName () retornar um nome com '/' como o último
personagem.

Retorna verdadeiro se o item do arquivo atual for um diretório.

Aplicar que o lima nome formato
applyFilenameFormat (void);

Aplicar que o etiqueta formato
applyTagFormat (void);

Aplicar texto codificação
applyTextEncoding (void);

Conjunto que o anuário nome da que o Tag
booleano setDirNameFromTag (int32 máscara de tag, corda formato, booleano crio);

máscara de tag
máscara de tag (bit 0 para tag 1, bit 1 para tag 2)

formato
formato do nome do diretório

crio
verdadeiro para criar, falso para renomear

Retorna verdadeiro se estiver OK, caso contrário, a mensagem de erro estará disponível usando getErrorMessage ().

Conjunto subseqüente pista números in que o selecionado arquivos
numberTracks (int32 máscara de tag, int32 primeiroTrackNr);

máscara de tag
máscara de tag (bit 0 para tag 1, bit 1 para tag 2)

primeiroTrackNr
número a ser usado para o primeiro arquivo

filtros que o arquivos
filtro (string expressão);

expressão
expressão de filtro

Converter ID3v2.3 Tag para ID3v2.4
convertToId3v24 (void);

Converter ID3v2.4 Tag para ID3v2.3
convertToId3v23 (void);

Retorna verdadeiro se estiver OK.

Get caminho of anuário
corda getDirectoryName (void);

Retorna o caminho absoluto do diretório.

Get nome of atual lima
corda getFileName (void);

Retorna o nome do arquivo absoluto verdadeiro, termina com "/" se for um diretório.

Conjunto nome of selecionado lima
setFileName (string nome);

nome
nome do arquivo

O arquivo será renomeado quando o diretório for salvo.

Conjunto formato para usar quando contexto que o nome do arquivo da que o Tag
setFileNameFormat (string formato);

formato
formato de nome de arquivo

Conjunto que o lima nomes of que o selecionado arquivos da que o Tag
setFileNameFromTag (int32 máscara de tag);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

Get valor of quadro
corda getFrame (int32 máscara de tag, corda nome);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

nome
nome da moldura (por exemplo, "artista")

Para obter dados binários como uma imagem, o nome de um arquivo a ser escrito pode ser adicionado após o
nome, por exemplo, "Imagem: / caminho / para / arquivo". Da mesma forma, as letras sincronizadas podem ser
exportado, por exemplo, "SYLT: / caminho / para / arquivo".

Retorna o valor do quadro.

Conjunto valor of quadro
booleano setFrame (int32 máscara de tag, corda nome, corda valor);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

nome
nome da moldura (por exemplo, "artista")

valor
valor da moldura

Para tag 2 (máscara de tag 2), se nenhum quadro com nome existe, um novo quadro é adicionado, se valor is
vazio, o quadro é excluído. Para adicionar dados binários como uma imagem, um arquivo pode ser adicionado
depois de nome, por exemplo, "Imagem: / caminho / para / arquivo". "SYLT: / caminho / para / arquivo" pode ser usado para
importar letras sincronizadas.

Retorna verdadeiro se estiver OK.

Get todos os quadros of a etiqueta
ordem of corda getTag (int32 máscara de tag);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

Retorna uma lista com nomes e valores de quadro alternados.

Get técnico INFORMAÇÕES sobre lima
ordem of corda getInformation (void);

As propriedades são formato, taxa de bits, taxa de amostragem, canais, duração, modo de canal, VBR, etiqueta
1, Tag 2. As propriedades que não estão disponíveis são omitidas.

Retorna uma lista com nomes e valores de propriedade alternados.

Conjunto etiqueta da lima nome
setTagFromFileName (int32 máscara de tag);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

Conjunto etiqueta da de outros etiqueta
setTagFromOtherTag (int32 máscara de tag);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

Copiar etiqueta
copyTag (int32 máscara de tag);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

macarrão etiqueta
pasteTag (int32 máscara de tag);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

Eliminar etiqueta
removeTag (int32 máscara de tag);

máscara de tag
bit de tag (1 para tag 1, 2 para tag 2)

Repassar que o • Configuração
reparseConfiguration (void);

Mudanças de configuração automatizadas são possíveis modificando o arquivo de configuração e
em seguida, reanalisando a configuração.

Tocam que o selecionado arquivos
playAudio (vazio);

QML INTERFACE

QML Exemplos
Os scripts QML podem ser chamados através do menu de contexto da lista de arquivos e podem ser configurados na guia
Ações do usuário da caixa de diálogo de configurações. Os scripts que são definidos lá podem ser usados ​​como
exemplos para programar scripts personalizados. QML usa JavaScript, aqui está o obrigatório "Hello
Mundo":

importar Kid3 1.0

Kid3Script{
em Executar: {
console.log ("Olá, mundo, o diretório é", app.dirName)
Qt.quit ()
}
}

Se este script for salvo como /path/to/Example.qml, o comando do usuário pode ser definido como @qml
/caminho/para/Example.qml com nome QML Test e saída verificada. Ele pode então ser iniciado usando
o item de teste QML no menu de contexto da lista de arquivos, e a saída será visível no
janela.

Como alternativa, o script também pode ser iniciado independentemente do Kid3 usando as ferramentas QML.

qmlviewer -I / usr / lib / kid3 / plugins / import /path/to/Example.qml

Para Qt 5, os comandos

qml -apptype widget -I / usr / lib / kid3 / plugins / import /path/to/Example.qml

or

qmlscene -I / usr / lib / kid3 / plugins / import /path/to/Example.qml

pode ser usado. No Windows e OS X, o caminho de importação deve ser adaptado para a pasta de importações
dentro do diretório de instalação. Scripts iniciados fora do Kid3 usarão o atual
diretório, por isso deve ser alterado de antemão.

Para listar os títulos nas tags 2 de todos os arquivos no diretório atual, o seguinte
script pode ser usado:

importar Kid3 1.0

Kid3Script{
em Executar: {
app.firstFile ()
fazer {
se (app.selectionInfo.tagFormatV2)
console.log (app.getFrame (tagv2, "title"))
} while (app.nextFile ())
}
}

Se o diretório contiver muitos arquivos, tal script pode bloquear a interface do usuário para
às vezes. Para operações mais longas, deve haver uma pausa de vez em quando. o
a implementação alternativa abaixo tem o trabalho de um único arquivo movido para uma função.
Esta função invoca a si mesma com um tempo limite de 1 ms no final, visto que mais arquivos têm
ser processado. Isso irá garantir que a GUI permaneça responsiva enquanto o script é
execução.

importar Kid3 1.0

Kid3Script{
em Executar: {
function doWork () {
if (app.selectionInfo.tagFormatV2) {
console.log (app.getFrame (tagv2, "title"))
}
if (! app.nextFile ()) {
Qt.quit ()
Else {}
setTimeout (doWork, 1)
}
}

app.firstFile ()
doWork ()
}
}

Mais scripts de exemplo vêm com Kid3 e já estão registrados como comandos do usuário.

· ReplayGain to SoundCheck (ReplayGain2SoundCheck.qml): Crie o iTunNORM SoundCheck
informações de quadros de ganho de repetição.

· Redimensionar arte do álbum (ResizeAlbumArt.qml): redimensionar imagens de arte da capa incorporadas que são
maior do que 500x500 pixels.

· Extrair Arte do Álbum (ExtractAlbumArt.qml): Extrair todas as imagens da capa incorporada
evitando duplicatas.

· Incorpore a arte do álbum (EmbedAlbumArt.qml): incorpore a arte da capa encontrada em arquivos de imagem em áudio
arquivos na mesma pasta.

· Embed Lyrics (EmbedL cycling.qml): Busque letras não sincronizadas do serviço da web.

· Codificação de texto ID3v1 (ShowTextEncodingV1.qml): Ajuda a encontrar a codificação de tags ID3v1
mostrando as marcas do arquivo atual em todas as codificações de caracteres disponíveis.

· Exportar CSV (ExportCsv.qml): Exporta recursivamente todas as tags de todos os arquivos para um arquivo CSV.

· Console QML (QmlConsole.qml): Console simples para brincar com a API QML do Kid3.

QML API
A API pode ser facilmente explorada usando o console QML, que está disponível como um exemplo
script com uma interface de usuário.

Kid3Script
Kid3Script é um componente QML regular localizado dentro do diretório do plugin. Você poderia
use outro componente QML da mesma forma. Usar o Kid3Script torna mais fácil iniciar o
função de script usando o em execução manipulador de sinal. Também esconde as diferenças entre
as versões QtQuick, de modo a tornar os scripts compatíveis com Qt 4 e Qt 5.
Além disso, oferece algumas funções:

onRun: manipulador de sinal que é invocado quando o script é iniciado
tagv1, tagv2, tagv2v1: Constantes para parâmetros de tag
script: acesso às funções de script
configs: acesso a objetos de configuração
getArguments (): lista de argumentos do script
isStandalone (): verdadeiro se o script não foi iniciado em Kid3
setTimeout (callback, delay): Inicia callback após delay ms

Scripting Funções
Como JavaScript e, portanto, QML também tem um conjunto limitado de funções para scripts,
que o escrita objeto tem alguns métodos adicionais, por exemplo:

script.properties (obj): String com propriedades Qt
script.writeFile (filePath, data): Grava dados no arquivo, verdadeiro se estiver OK
script.readFile (filePath): lê os dados do arquivo
script.removeFile (filePath): Excluir arquivo, verdadeiro se estiver OK
script.fileExists (filePath): verdadeiro se o arquivo existir
script.renameFile (oldName, newName): renomear arquivo, verdadeiro se estiver OK
script.tempPath (): caminho para o diretório temporário
script.listDir (path, [nameFilters], [classify]): Listar entradas de diretório
script.system (program, [args], [msecs]): inicia um comando do sistema de forma síncrona,
[código de saída, saída padrão, erro padrão] se não for o tempo limite
script.getEnv (varName): obtém o valor da variável de ambiente
script.setEnv (varName, value): Defina o valor da variável de ambiente
script.getQtVersion (): string da versão Qt, por exemplo, "5.4.1"
script.getDataMd5 (dados): obtém a string hexadecimal do hash MD5 de dados
script.getDataSize (data): obtém o tamanho da matriz de bytes
script.dataToImage (data, [format]): Crie uma imagem a partir de bytes de dados
script.dataFromImage (img, [format]): obtém bytes de dados da imagem
script.loadImage (filePath): Carrega uma imagem de um arquivo
script.saveImage (img, filePath, [format]): Salva uma imagem em um arquivo, verdadeiro se estiver OK
script.imageProperties (img): obtém propriedades de uma imagem, mapa contendo
"largura", "altura", "profundidade" e "colorCount", vazio se a imagem for inválida
script.scaleImage (img, width, [height]): dimensiona uma imagem, retorna a imagem dimensionada
script.selectFileName (legenda, dir, filtro, saveFile): Abrir caixa de diálogo de arquivo para
selecione um arquivo

Aplicação Contexto
Usando QML, uma grande parte das funções Kid3 são acessíveis. A API é semelhante a
aquele usado para D-Bus. Para obter detalhes, consulte as respectivas notas.

app.openDirectory (caminho): Abra o diretório
app.saveDirectory (): Salvar diretório
app.revertFileModifications (): Reverter
app.importTags (tag, path, fmtIdx): Importar arquivo
app.downloadImage (url, allFilesInDir): Baixar imagem
app.exportTags (tag, path, fmtIdx): Exportar arquivo
app.writePlaylist (): Escrever lista de reprodução
app.selectAllFiles (): Selecionar tudo
app.deselectAllFiles (): Desmarcar
app.firstFile ([selecionar]): Para o primeiro arquivo
app.nextFile ([selecionar]): Para o próximo arquivo
app.previousFile ([selecionar]): Para o arquivo anterior
app.selectCurrentFile ([selecionar]): Selecione o arquivo atual
app.requestExpandFileList (): Expandir tudo
app.applyFilenameFormat (): Aplicar formato de nome de arquivo
app.applyTagFormat (): Aplicar formato de tag
app.applyTextEncoding (): Aplicar codificação de texto
app.numberTracks (nr, total, tag, [opções]): Número de faixas
app.applyFilter (expr): Filtro
app.convertToId3v23 (): Converter ID3v2.4.0 em ID3v2.3.0
app.convertToId3v24 (): Converter ID3v2.3.0 em ID3v2.4.0
app.getFilenameFromTags (tag): nome do arquivo das tags
app.getTagsFromFilename (tag): nome do arquivo para tags
app.getAllFrames (tag): obtém o objeto com todos os quadros
app.getFrame (tag, nome): Obter frame
app.setFrame (tag, nome, valor): Definir quadro
app.getPictureData (): Obtenha dados do porta-retratos
app.setPictureData (data): Defina os dados no porta-retratos
app.copyToOtherTag (tag): Tags para outras tags
app.copyTags (tag): Copiar
app.pasteTags (tag): Colar
app.removeTags (tag): Remover
app.playAudio (): Tocar
app.readConfig (): Leia a configuração
app.applyChangedConfiguration (): Aplicar configuração
app.dirName: nome do diretório
app.selectionInfo.fileName: Nome do arquivo
app.selectionInfo.filePath: caminho absoluto do arquivo
app.selectionInfo.detailInfo: detalhes do formato
app.selectionInfo.tagFormatV1: formato da Tag 1
app.selectionInfo.tagFormatV2: formato da Tag 2
app.selectionInfo.formatString (tag, format): códigos substitutos na string de formato

Para operações assíncronas, retornos de chamada podem ser conectados a sinais.

function automaticImport (profile) {
function onAutomaticImportFinished () {
app.batchImporter.finished.disconnect (onAutomaticImportFinished)
}
app.batchImporter.finished.connect (onAutomaticImportFinished)
app.batchImport (perfil, tagv2)
}

function renameDirectory (format) {
function onRenameActionsScheduled () {
app.renameActionsScheduled.disconnect (onRenameActionsScheduled)
app.performRenameActions ()
}
app.renameActionsScheduled.connect (onRenameActionsScheduled)
app.renameDirectory (tagv2v1, formato, falso)
}

Configuração objetos
As diferentes seções de configuração são acessíveis por meio de métodos de configs. Seu
as propriedades podem ser listadas no console QML.

script.properties (configs.networkConfig ())

As propriedades podem ser definidas:

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 ()

Use kid3-core online usando serviços onworks.net