kid3-core: en línea en la nube

PROGRAMA:

NOMBRE

kid3, kid3-qt, kid3-cli - etiquetador ID3 de Kid3

SINOPSIS

kid3 [--ayuda | --ayuda-qt | --ayuda-kde | --ayudar a todo
|--autor | --versión | --licencia] [ARCHIVO...]

niño de 3 cuartos de galón [Opciones de Qt] [ARCHIVO...]

niño3-cli [-h | --ayuda] [-c COMANDO1] [-c COMANDO2...] [ARCHIVO...]

CAMPUS

ARCHIVO
If ARCHIVO es la ruta a un directorio, se abrirá. Si una o más rutas de archivo están
dado, se abre su directorio común y se seleccionan los archivos.

kid3
--ayuda
Muestre ayuda sobre las opciones.

--ayuda-qt
Mostrar opciones específicas de Qt, consulte qopciones(7).

--ayuda-kde
Mostrar opciones específicas de KDE, consulte kdeopciones(7).

--ayudar a todo
Muestra todas las opciones.

--autor
Muestra la información del autor.

--versión
Muestra información de la versión.

--licencia
Muestra la información de la licencia.

niño de 3 cuartos de galón
Opciones de Qt
See qopciones(7), sin embargo, las opciones tienen "-" como prefijo, no "-".

niño3-cli
-c
Ejecuta un comando. Múltiple -c las opciones son posibles, se ejecutan en secuencia.
Consulte la sección sobre kid3-cli para obtener una descripción de los comandos disponibles.

-h|--ayuda
Muestre ayuda sobre opciones y comandos.

INTRODUCCIÓN

Kid3 es una aplicación para editar las etiquetas ID3v1 e ID3v2 en archivos MP3 de manera eficiente.
Estas etiquetas pueden ser editadas por la mayoría de los reproductores MP3, pero no de una manera muy cómoda y eficiente.
camino. Además, las etiquetas en Ogg / Vorbis, Opus, DSF, FLAC, MPC, APE, MP4 / AAC, MP2, Speex,
Los archivos TrueAudio, WavPack, WMA, WAV, AIFF y los módulos de seguimiento (MOD, S3M, IT, XM) son
apoyado también.

Kid3 no captura ni codifica archivos MP3, pero su objetivo es editar las etiquetas ID3 de todos
archivos de un álbum de una manera eficiente, es decir, con tan pocos clics del mouse y pulsaciones de teclas como
posible. Donde la mayoría de los otros programas pueden editar etiquetas ID3v1 o ID3v2, Kid3 tiene
control sobre ambas versiones, puede convertir etiquetas entre los dos formatos y tiene acceso a todos
Etiquetas ID3v2. Las etiquetas de varios archivos se pueden configurar con el mismo valor, por ejemplo, el artista, el álbum,
El año y el género de todos los archivos de un álbum suelen tener los mismos valores y se pueden configurar
juntos. Si la información de las etiquetas está contenida en el nombre del archivo, las etiquetas se pueden
establecido automáticamente a partir del nombre del archivo. También es posible configurar el nombre del archivo de acuerdo con
a las etiquetas que se encuentran en el archivo en formatos arbitrarios.

La tarea de edición está respaldada además por el reemplazo automático de caracteres o
subcadenas, por ejemplo, para eliminar caracteres ilegales de los nombres de archivo. Control automático de
Los caracteres en mayúsculas y minúsculas facilitan el uso de un esquema de nomenclatura coherente en todos
las etiquetas.

La información de la etiqueta para álbumes completos se puede obtener de www.gnudb.org[1], TrackType.org[2],
MusicBrainz[3], Discogs[4], Amazon[5] u otras fuentes de listas de canciones. El formato de importación
se puede configurar libremente mediante expresiones regulares.

Informe cualquier problema o solicitud de funciones al autor.

USO KID3

Kid3 Características
· Editar etiquetas ID3v1.1

· Edita todos los marcos ID3v2.3 e ID3v2.4

· Edita etiquetas de varios archivos

· Convertir entre etiquetas ID3v1 e ID3v2

· Edita MP3, Ogg / Vorbis, Opus, DSF, FLAC, MPC, APE, MP4 / AAC, MP2, Speex, TrueAudio,
Etiquetas WavPack, WMA, WAV y AIFF

· Genera etiquetas a partir del nombre de archivo

· Genera etiquetas a partir del contenido de los campos de etiquetas

· Generar nombre de archivo a partir de etiquetas

· Genera y cambia los nombres de directorio a partir de etiquetas

· Generar archivo de lista de reproducción

· Conversión automática de casos y traducción de cadenas

· Importar de www.gnudb.org[1], TrackType.org[2], MusicBrainz[3], Discogs[4], Amazon[5] y
otras fuentes de datos

· Exporta como CSV, HTML, lista de reproducción, Kover XML y otros formatos. Los archivos CSV exportados se pueden
importado de nuevo.

Ejemplo Uso
Esta sección describe una sesión típica con Kid3. Supongamos que tenemos un directorio
que contiene archivos MP3 con las pistas del álbum "Let's Tag" de la banda "One Hit
Wonder ". El directorio se nombra en el formato" artista - álbum ", en nuestro caso One Hit Wonder
- Vamos a etiquetar. El directorio contiene las pistas en el formato "título de pista.mp3", que
Creo que es útil porque los nombres de archivo son cortos (importante cuando se utilizan reproductores MP3 móviles
con pantallas pequeñas) y en el orden correcto cuando se ordenan alfabéticamente (importante cuando
utilizando reproductores MP3 de hardware que reproduzcan las pistas en orden alfabético o en el orden en
que se graban en CD y ese orden es alfabético cuando se utiliza mkisofs). además
esto, la información del artista y del álbum ya está en el nombre del directorio y no tiene
que se repetirá en el nombre del archivo. Pero volviendo a nuestro ejemplo, la lista de directorios se ve así
modo:

01 Introducción.mp3

02 Solo tenemos este.mp3

03 Outro.mp3

Estos archivos aún no tienen etiquetas y queremos generarlos usando Kid3. Usamos Open (File
menú o barra de herramientas) y seleccione uno de los archivos de este directorio. Todos los archivos serán
que se muestra en el cuadro de lista de archivos. Perezosos como somos, queremos usar la información en el
nombres de directorio y archivo para generar etiquetas. Por lo tanto, seleccionamos todos los archivos, luego hacemos clic en el
Para: Botón Etiqueta 1 en la sección Archivo. Esto establecerá el título, el artista, el álbum y la pista.
valores en todos los archivos. Para establecer los valores de año y género de todos los archivos, mantenemos todos los archivos
seleccionado y escriba "2002" para el año y seleccione "Pop" en el cuadro combinado de género. Para configurar
solo estos dos valores, sus casillas de verificación se marcan automáticamente y todas las demás casillas de verificación
se dejan sin marcar. Ahora cambiamos la selección seleccionando solo el primer archivo y
compruebe que todas las etiquetas contengan los valores correctos. Las etiquetas de los otros archivos se pueden verificar
también seleccionándolos uno por uno. Cuando estemos satisfechos con las etiquetas, usamos Guardar (Archivo
menú o barra de herramientas). Al seleccionar Crear lista de reproducción en el menú Archivo, se generará un archivo.
Pulse Wonder - Let's Tag.m3u en el directorio.

COMANDO REFERENCIA

El GUI Elements
La GUI de Kid3 está separada en cinco secciones: A la izquierda están el archivo y el directorio
cuadros de lista, el lado derecho contiene las secciones Archivo, Etiqueta 1 y Etiqueta 2.

Archive Lista
La lista de archivos contiene los nombres de todos los archivos del directorio abierto que coinciden
el filtro de nombre de archivo seleccionado (normalmente * .mp3 * .ogg * .opus * .dsf * .flac * .mpc * .aac
* .m4a * .m4b * .m4p * .mp4 * .mp2 * .spx * .tta * .wv * .wma * .wav * .aiff * .ape). Una sola o
se pueden seleccionar varios archivos. Para seleccionar ningún archivo, haga clic en el área vacía después de la
entradas del cuadro de lista. La selección determina los archivos que se ven afectados por la
operaciones que están disponibles mediante los botones que se describen a continuación.

Además de Nombre, también se pueden seleccionar otras columnas Tamaño, Tipo, Fecha de modificación con detalles de archivo.
desplegado. Las columnas se pueden ocultar desmarcando su nombre en el menú contextual del
encabezado de lista. El orden de las columnas se puede cambiar arrastrando y soltando. El orden de clasificación
se puede alternar haciendo clic en el encabezado de la columna.

A la izquierda de los nombres se puede mostrar un icono: un disco para mostrar que el archivo se ha
modificado o información sobre qué etiquetas están presentes (V1, V2, V1V2 o NO TAG, no
se muestra el icono si el archivo aún no se ha leído).

Los directorios se muestran con un icono de carpeta. Si se abre un directorio, sus archivos se
se muestra en un árbol jerárquico. Seleccionando archivos de subdirectorios, operaciones
se puede ejecutar en archivos en diferentes directorios, lo cual es útil si la música
La colección está organizada con una carpeta para cada artista que contiene carpetas para álbumes de
este artista.

Al hacer clic con el botón derecho del mouse dentro de la lista de archivos, se abre un menú contextual con el
siguientes comandos:

· Expandir todo: expande todos los árboles de carpetas (solo el árbol actual si la tecla Mayús está
presionado)

· Contraer todo: contrae todos los árboles de carpetas

· Cambiar nombre: cambia el nombre de un archivo

· Mover a la papelera: mueve un archivo a la papelera.

· Reproducir: reproduce un archivo, consulte Reproducir

· Las entradas siguientes son comandos de usuario, que se pueden definir en Acciones de usuario
pestaña de Configurar Kid3. Allí también se puede activar la reproducción al hacer doble clic.

Directorio Lista
La lista de directorios contiene los nombres de los directorios en el directorio abierto, como
así como el directorio actual (.) y el directorio principal (..). Le permite a uno cambiar rápidamente
el directorio sin usar el comando Abrir ... o arrastrar y soltar.

La visibilidad, el orden y la clasificación de las columnas se pueden configurar como se describe en la sección
sobre la lista de archivos.

Archive
Muestra información sobre la codificación (MP3, Ogg, Opus, DSF, FLAC, MPC, APE, MP2, MP4,
AAC, Speex, TrueAudio, WavPack, WMA, WAV, AIFF), velocidad de bits, frecuencia de muestreo, canales y
la longitud del archivo.

La edición de la línea Nombre contiene el nombre del archivo (si solo se selecciona un archivo).
Si se cambia este nombre, se cambiará el nombre del archivo cuando se utilice el comando Guardar.

El cuadro combinado Formato y la edición de línea contienen el formato que se utilizará cuando el nombre del archivo sea
generado a partir de la primera o la segunda etiqueta. El nombre del archivo puede contener arbitrario
caracteres, incluso una parte del directorio separada por una barra del nombre del archivo, pero que
El directorio ya debe existir para que el cambio de nombre se realice correctamente. Los siguientes códigos especiales
se utilizan para insertar valores de etiqueta en el nombre de archivo:

·% S% {title} Título (canción)

·% A% {artist} Artista

·% L% {album} Álbum

·% C% {comentario} comentario

·% Y% {year} año

·% T% {track} Seguimiento (por ejemplo, 01)

·% T% {track.n} Seguimiento con ancho de campo n (por ejemplo, 001 para% {track.3})

·% T% {tracknumber} Pista (sin ceros a la izquierda, por ejemplo, 1)

·% G% {genre} Género

·% {Ignore} ignorado al generar etiquetas a partir del nombre del archivo

Los códigos de formato no se limitan a los ejemplos dados anteriormente. Cualquier nombre de marco puede ser
utilizado, por ejemplo, nombres de marcos unificados como % {bpm} o formatear nombres específicos como
% {popm}.

Se utiliza un segundo cuadro combinado de formato (con la flecha hacia abajo) para generar las etiquetas desde el
nombre del archivo. Si el formato del nombre de archivo no coincide con este patrón, algunos otros
Se prueban los formatos más utilizados.

Algunos formatos de nombre de archivo de uso común ya están disponibles en el cuadro combinado, pero es
también es posible escribir en algún formato especial en la línea de edición.

De: Etiqueta 1, Etiqueta 2: establece el nombre del archivo utilizando el formato seleccionado y la primera etiqueta o
la segunda etiqueta, respectivamente.

Para: Etiqueta 1, Etiqueta 2: las etiquetas se establecen a partir del nombre del archivo. Primero, el formato especificado en
Se utiliza formato. Si el nombre de archivo existente no coincide con este formato, lo siguiente
se prueban formatos:

· Artista - Canción del álbum / pista

· Álbum / Pista - Artista - Canción

· / Artista - Álbum - Pista - Canción

· Álbum / Artista - Pista - Canción

· Álbum / Artista - Canción

· Artista / Álbum / Pista de canción

Si se selecciona un solo archivo, los controles de la GUI se llenan con los valores extraídos
del nombre del archivo. Si se seleccionan varios archivos, las etiquetas de los archivos se
establecer de acuerdo con los nombres de archivo.

Etiqueta 1
Los widgets de edición de línea para Título, Artista, Álbum, Comentario, Año, Pista y Género son
utilizado para editar el valor correspondiente en la primera etiqueta de los archivos seleccionados. El valor
se cambiará cuando se modifique la selección del archivo o antes de operaciones como Guardar y
Salga y cuando la casilla de verificación correspondiente a la izquierda del nombre del campo esté marcada.
Esto es útil para cambiar solo algunos valores y dejar los otros valores sin cambios.

Si se selecciona un solo archivo, todas las casillas de verificación están marcadas y los widgets de edición de línea
contienen los valores que se encuentran en las etiquetas de este archivo. Si no se encuentra una etiqueta en el archivo,
se muestra el valor vacío correspondiente, que es una cadena vacía para el título,
Ediciones de Artista, Álbum y Línea de comentarios, 0 para las ediciones numéricas de Año y Pista y una
valor seleccionado vacío para el cuadro combinado de género. Los valores se pueden cambiar y si el
casilla de verificación correspondiente está marcada, se establecerán para el archivo seleccionado después de la
se cambia la selección. A continuación, el archivo se marca como modificado por un símbolo de disco en el archivo.
cuadro de lista, pero permanece sin cambios hasta que se utiliza el comando Guardar.

Si se seleccionan varios archivos, solo los valores que son idénticos en todos los seleccionados
se muestran los archivos. En todos los demás controles, los valores vacíos descritos anteriormente son
desplegado. Todas las casillas de verificación están desmarcadas para evitar cambios no deseados. Si un valor tiene que
configurarse para todos los archivos seleccionados, se puede editar y se debe configurar la casilla de verificación. los
Los valores se establecerán para todos los archivos seleccionados cuando se cambie la selección y se
guardado usando el comando Guardar.

Las casillas de verificación también controlan el funcionamiento de la mayoría de los comandos que afectan a las etiquetas, como
como copiar, pegar y transferir entre las etiquetas 1 y 2. Para que sea más fácil de usar con
varios archivos donde todas las casillas de verificación están desmarcadas, estos comandos se comportan de la misma manera
manera cuando todas las casillas de verificación están marcadas y cuando todas las casillas de verificación están desmarcadas.

Desde la etiqueta 2: los campos de la etiqueta 1 se establecen a partir de los valores correspondientes en la etiqueta 2. Si un
se selecciona un solo archivo, los controles de la GUI se rellenan con los valores de la etiqueta 2. Si
se seleccionan varios archivos, las etiquetas de los archivos se establecen directamente.

Copiar: el búfer de copia se llena con los valores de la etiqueta 1. Solo valores con marcada
La casilla de verificación se utilizará en los siguientes comandos de Pegado.

Pegar: pega los valores del búfer de copia en los controles de la GUI.

Eliminar: esto establecerá todos los controles de la GUI en sus valores vacíos, lo que da como resultado la eliminación
todos los valores. El archivo guardado no contendrá ninguna etiqueta 1.

Etiqueta 2
Los controles de la GUI funcionan de la misma manera que se describe para la sección Etiqueta 1, pero
el tamaño de las cuerdas no está limitado.

Para la etiqueta 2 Género, también puede usar sus propios nombres además de los géneros enumerados en el
cuadro combinado, simplemente escriba el nombre en la línea de edición.

La etiqueta 2 no solo puede contener los mismos valores que la etiqueta 1, el formato está construido en un
de forma flexible a partir de varios marcos que a su vez se componen de varios campos. los
La tabla de la etiqueta 2 muestra todos los marcos que están disponibles en el archivo seleccionado.

Editar: Esto abrirá una ventana que le permite editar todos los campos del seleccionado.
cuadro. Si se seleccionan varios archivos, los campos editados se aplican a todos los
archivos que contienen dicho marco.

Agregar: aparecerá un solicitante para seleccionar el tipo de marco y un marco del tipo seleccionado
se puede editar y agregar al archivo. Esto también funciona para agregar un marco a múltiples
archivos seleccionados

Eliminar: elimina el marco seleccionado en los archivos seleccionados.

Arrastrar la carátula del álbum aquí se muestra si el archivo no contiene carátula incrustada. A
La imagen se puede agregar usando arrastrar y soltar desde un navegador o administrador de archivos y será
mostrado aquí. Los marcos de imágenes se pueden editar o agregar haciendo doble clic en este
controlar.

sincronizada letras y Evento Sincronización Códigos
Para obtener información sincronizada con los datos de audio, se encuentra disponible un editor específico.
Estos marcos son compatibles con las etiquetas ID3v2.3.0 e ID3v2.4.0. Para agregar tal marco, el
se debe seleccionar un nombre de marco específico en la lista que aparece cuando el botón Agregar
se hace clic en - Letras sincronizadas o Códigos de tiempo de eventos, respectivamente. El editor es
lo mismo para ambos tipos, para los códigos de tiempo de eventos, solo un conjunto predefinido de eventos
está disponible mientras que para las letras sincronizadas, se debe ingresar texto. En el
A continuación, se explica la edición de letras sincronizadas.

Se selecciona un archivo que tiene una etiqueta ID3v2, el editor de letras se ingresa usando Agregar y
seleccionando Letras sincronizadas. Para un cuadro de Letras sincronizadas existente, es
seleccionado y se hace clic en Editar. El reproductor se abre automáticamente con el archivo actual.
para que el archivo se pueda reproducir y pausar para sincronizar las letras.

Normalmente, no es necesario cambiar la configuración en la parte superior del editor SYLT. Si el
la letra contiene caracteres que no están presentes en el conjunto de caracteres Latin 1,
Es aconsejable cambiar la codificación del texto a UTF16 (o UTF8 para ID3v2.4.0). Para ingles
letras y máxima compatibilidad, se debe utilizar ISO-8859-1.

La sección Letras tiene cinco botones en la parte superior. Agregar agregará un nuevo evento de tiempo en el
mesa. El tiempo se toma de la posición del jugador, agregando así una entrada mientras
la reproducción de la pista agregará una línea para la posición que se está reproduciendo actualmente. Los eventos en el
la tabla debe estar ordenada cronológicamente, por lo tanto, la fila se insertará
respectivamente. Las entradas con una hora no válida se tratan de forma especial: si el
la fila seleccionada tiene una hora no válida, su marca de tiempo será reemplazada por la hora actual
en lugar de agregar una nueva fila. Si la hora actual no es inválida, la primera fila con un
se utilizará una hora no válida si está presente. Este comportamiento debería facilitar la adición de tiempo
Sellos si el texto de la letra ya está en la tabla pero faltan las marcas de tiempo
(que es el caso al importar letras no sincronizadas). Tenga en cuenta que la hora inválida
se representa como 00: 00.00, es decir, la misma hora al comienzo absoluto de la
pista, que no es inválida. Para invalidar una hora, presione la tecla Suprimir o use
Limpiar desde el menú contextual. Nuevas filas insertadas usando Insertar fila en el menú contextual
o creado al importar letras no sincronizadas con Desde el portapapeles o Importar también
contienen marcas de tiempo no válidas. Las filas de la tabla se pueden eliminar haciendo clic en Eliminar
o usando Eliminar filas del menú contextual.

Las letras sincronizadas se pueden importar desde un archivo usando Importar. El formato esperado es
LRC simple o mejorado. Si el archivo seleccionado no contiene un corchete en el
primera línea, se supone que es un archivo de texto simple con letras no sincronizadas. los
A continuación, las líneas de dicho archivo se importan con marcas de tiempo no válidas. El tiempo
La información se puede agregar usando el botón Agregar o ingresando manualmente. También es posible
para importar letras a través de copiar y pegar usando Desde el portapapeles. Las letras sincronizadas pueden ser
escrito en archivos LRC usando Exportar. Tenga en cuenta que solo las entradas con marcas de tiempo válidas
exportar y que las entradas se ordenarán por tiempo. Entradas con tiempo no válido
tampoco se almacenará en el marco SYLT, así que asegúrese de incluir todos los tiempos
información antes de salir del cuadro de diálogo.

El ID3 especificación[6] sugiere una marca de tiempo para cada sílaba. Sin embargo, la mayoría de los jugadores
solo admiten la granularidad de una línea u oración. Para admitir ambos casos de uso, Kid3
sigue las mismas convenciones que SYLT Editora[7]. Texto que se ingresa en la tabla
se supone que comienza una nueva línea a menos que comience con un espacio o un guión. Excepciones
a esta regla son posibles comenzando una línea con un guión bajo ('_') para forzar
continuación o una marca de almohadilla ('#') para forzar una nueva línea. Estos personajes de escape no son
almacenado dentro del marco SYLT. Dentro del marco SYLT, las nuevas líneas comienzan con un salto de línea
carácter (hexadecimal 0A) mientras que las continuaciones no lo hacen. Al leer marcos SYLT, Kid3 comprueba
si la primera entrada comienza con un salto de línea. Si este no es el caso, se asume
que todas las entradas son nuevas líneas y que no se utilizan continuaciones de sílabas.

Mientras se reproduce la pista, se muestra la fila asociada con la posición de reproducción actual.
resaltado, de modo que la exactitud de la información de sincronización pueda ser
verificado. Si se debe agregar un desplazamiento a una o más marcas de tiempo, esto se puede
logrado con el menú contextual Agregar desplazamiento. Se pueden usar valores negativos para reducir
el tiempo. Usando Buscar para posicionar en el menú contextual, es posible configurar el
posición de reproducción al tiempo de la fila seleccionada.

El Archive Menú
Archivo → Abrir ... (Ctrl + O)
Abre un directorio. Se mostrarán todos los archivos que coincidan con el filtro de nombre de archivo seleccionado
en el cuadro de lista de archivos y se selecciona el archivo elegido.

Archivo → Abrir reciente
Abre un directorio abierto recientemente.

Archivo → Abrir directorio ... (Ctrl + D)
Abre un directorio. Se mostrarán todos los archivos que coincidan con el filtro de nombre de archivo seleccionado
en el cuadro de lista de archivos.

Archivo → Guardar (Ctrl + S)
Guarda todos los archivos modificados en el directorio. Los archivos modificados están marcados con un disco.
símbolo en el cuadro de lista de archivos. Si se ha cambiado algún nombre de archivo, esos archivos se
renombrado.

Archivo → Revertir
Revierte los cambios de uno o varios archivos. Si no hay archivos seleccionados en el archivo
cuadro de lista, los cambios de todos los archivos se revertirán, de lo contrario, solo los cambios del
los archivos seleccionados se revierten.

Archivo → Importar ...
El cuadro de diálogo Importar se puede utilizar para importar datos directamente desde un servidor de freedb.org, desde un
Servidor MusicBrainz, de Discogs, Amazon u otras fuentes de listas de pistas de álbumes en
formato textual.

Es posible importar desde un servidor de freedb.org usando un cuadro de diálogo que aparece cuando Desde
Servidor: gnudb.org o TrackType.org está seleccionado. El artista y el nombre del álbum para buscar
puede introducirse en los dos campos superiores, los álbumes que coincidan con la consulta serán
se muestra cuando se hace clic en Buscar y los resultados de www.gnudb.org[8] se reciben.
La importación de los datos de la pista de un álbum se realiza haciendo doble clic en el álbum en la
lista. Se puede seleccionar el servidor freedb.org desde el que se va a importar, así como la ruta CGI.
Los datos importados se muestran en la tabla de vista previa del cuadro de diálogo de importación. Cuando
satisfecho con las pistas mostradas, se pueden importar al finalizar la importación
diálogo con OK.

Se puede realizar una búsqueda en el servidor de Discogs utilizando Discogs. Como en gnudb.org
diálogo, puede ingresar artista y álbum y luego elegir de una lista de lanzamientos. Si
Las etiquetas estándar están marcadas, la información estándar se importa, por ejemplo, artista, álbum y
título. Si se marcan Etiquetas adicionales, se importa más información si está disponible, p. Ej.
artistas intérpretes o ejecutantes, arreglistas o el editor. Si la portada está marcada, la portada será
descargado si está disponible.

Se puede realizar una búsqueda en Amazon utilizando Amazon. Como en el cuadro de diálogo de gnudb.org, puede
ingrese artista y álbum y luego elija de una lista de lanzamientos. Si etiquetas adicionales es
marcado, se importa más información si está disponible, por ejemplo, artistas intérpretes o ejecutantes, arreglistas o el
editor. Si la portada está marcada, la portada se descargará si está disponible.

Puede buscar de la misma manera en la base de datos de versiones de MusicBrainz usando From
Lanzamiento de MusicBrainz. El flujo de trabajo es el mismo que se describe para From gnudb.org.

Es posible importar desde un servidor de MusicBrainz utilizando el cuadro de diálogo que aparece cuando
MusicBrainz Fingerprint está seleccionado. El servidor se puede seleccionar como en el freedb
diálogo de importación. A continuación se muestra una tabla que muestra los datos de las pistas importadas. La columna de la derecha
muestra el estado de la consulta de MusicBrainz, que comienza con "Pendiente" cuando el cuadro de diálogo
está abierto. Luego se busca la huella dactilar y si no da un resultado,
se intenta otra búsqueda usando las etiquetas en el archivo. Por lo tanto, puede ser útil para
consulta exitosa de MusicBrainz para almacenar información conocida (por ejemplo, artista y álbum) en el
etiquetas antes de la importación. Si se encontró un resultado, la búsqueda termina en el estado
"Reconocido"; de lo contrario, no se encontró nada o varios resultados ambiguos y uno de
ellos deben ser seleccionados por el usuario. Aceptar y Aplicar utilizan los datos importados, Cancelar
cierra el diálogo. El cierre puede tardar un rato ya que toda la maquinaria de MusicBrainz
tiene que ser cerrado.

Para la importación de datos textuales, From File / Clipboard abre un subdiálogo, donde varios
Hay formatos de importación preconfigurados disponibles. Los dos primeros, "CSV sin comillas" y "CSV
citado "se puede utilizar para importar datos que fueron exportados por el cuadro de diálogo Exportar. El archivo CSV
Los datos se pueden editar con una hoja de cálculo y se escribirán utilizando pestañas como delimitadores.
La importación debería ser posible mediante "CSV entre comillas", que es más flexible que "CSV
sin comillas ". Sin embargo, sus campos no pueden contener comillas dobles. Si solo exporta
de Kid3 e importar más tarde, "CSV sin comillas" se puede utilizar como un formato simple para esto
objetivo. Tenga en cuenta que también hay comandos "Exportar CSV" e "Importar CSV" en el
menú contextual de la lista de archivos, que utiliza scripts para exportar e importar datos CSV en un
forma más completa, potente y flexible.

El siguiente formato, "texto HTML freedb", se puede utilizar para copiar información de una página HTML.
of freedb.org[9]. Busque un álbum en freedb y si la información deseada es
que se muestra en el navegador web, copie el contenido en el portapapeles. Luego haga clic en el
El botón Portapapeles y las pistas importadas se mostrarán en la tabla de vista previa en la
parte superior del cuadro de diálogo. Si está satisfecho con los datos importados, finalice el cuadro de diálogo
con OK, que insertará los datos en las etiquetas del directorio actual. los
El destino (Etiqueta 1, Etiqueta 2 o Etiqueta 1 y Etiqueta 2) se puede seleccionar con un cuadro combinado. los
los archivos en el directorio actual deben estar en el orden de seguimiento correcto para obtener sus etiquetas
asignado. Este es el caso si están numerados.

Se puede utilizar el siguiente formato de importación preconfigurado, "fuente HTML freedb", si los datos
está disponible como documento HTML. La importación es posible utilizando el botón Desde archivo, que
abre un selector de archivos, o copia su contenido de un editor y luego lo importa desde
portapapeles. Este formato puede resultar útil para la importación sin conexión, aunque el documento HTML
también podría abrirse en un navegador y luego importarse en el primer formato a través del
portapapeles.

Hay disponibles más formatos preconfigurados, por ejemplo, "Tiempo de título de pista". Una costumbre vacía
El formato se puede crear con Agregar para que lo establezca el usuario. Dos líneas debajo del nombre del formato
se puede configurar con una expresión regular para capturar los campos del texto de importación. los
La primera expresión regular se analizará una vez por documento para recopilar datos por álbum.
como artista, álbum, año y género. La segunda línea se intenta hacer coincidir desde el
desde el principio hasta el final del documento para obtener los datos de la pista, normalmente el número y el título. los
Las expresiones regulares incluyen todas las características ofrecidas por Qt, que es la mayor parte de lo que
Ofertas de Perl. Las construcciones entre corchetes "(..)" crean búferes de captura para que los campos
import y están precedidos por códigos específicos de Kid3 para especificar qué campo capturar. los
Los códigos son los mismos que se utilizan para el formato de nombre de archivo, además de los códigos que se enumeran a continuación,
cualquier nombre de marco es posible:

·% S% {title} Título (canción)

·% A% {artist} Artista

·% L% {album} Álbum

·% C% {comentario} comentario

·% Y% {year} año

·% T% {track} Seguimiento

·% G% {genre} Género

·% D% {duration} Duración

Por ejemplo, una expresión regular de pista (segunda línea) para importar desde una lista de reproducción .m3u
podría ser "% {pista} (\ d +) \ s +% {título} (\ S [^ \ r \ n] *) \. mp3 [\ r \ n]". Todos los formatos se pueden cambiar
editando las expresiones regulares y el nombre y luego haciendo clic en Guardar configuración. Ellos
se almacenará en el archivo kid3rc en el directorio de configuración. Este archivo puede ser
editado directamente para tener más formatos de importación o se puede eliminar para volver a la
formatos predeterminados. Los formatos se pueden eliminar usando Eliminar.

La precisión muestra una estimación de qué tan bien la información importada coincide con el
pistas. Utiliza la duración de las pistas o los nombres de los archivos para calcular el nivel de similitud en
por ciento. Carátula muestra la URL de la imagen de la portada del álbum que se descargará.

Para comprobar si las pistas importadas coinciden con el conjunto actual de archivos, la duración de
las pistas importadas se pueden comparar con la duración de los archivos. Esta opción puede ser
habilitado con la casilla de verificación Verifique la diferencia de tiempo máxima permitida y la
La diferencia de tiempo tolerada se puede establecer en segundos. Si una discrepancia en una longitud es
detectada, la longitud se muestra con un fondo rojo en la tabla de vista previa.

Si los archivos están ordenados de manera diferente a las pistas importadas, sus pistas asignadas
tiene que ser cambiado. Esta tarea se puede facilitar utilizando los botones Match with Length,
Pista y Título, que reordenará las pistas según el campo correspondiente.
Para corregir las asignaciones manualmente, se puede arrastrar una pista con el botón izquierdo del mouse
y la tecla Ctrl, manténgala presionada y luego la suelte en la nueva ubicación.

Cuando se abre el cuadro de diálogo de importación, contiene el contenido real de las etiquetas. La etiqueta
El tipo (Etiqueta 1, Etiqueta 2, Etiqueta 1 y Etiqueta 2) se puede seleccionar mediante el cuadro combinado Destino.
El botón a la derecha de este cuadro combinado se puede utilizar para revertir la tabla a la
contenido actual de las etiquetas. Las casillas de verificación de la primera columna de la tabla se pueden utilizar para
seleccione las pistas que se importan. Esto puede resultar útil si una carpeta contiene el
pistas de ambos CD de un CD doble y solo las pistas del segundo CD deben ser
importado.

Para identificar las pistas que se importan, es posible mostrar los nombres de los archivos o
las rutas completas a los archivos utilizando el menú contextual del encabezado de la tabla. Los valores en
la tabla de importación se puede editar. El botón de revertir a la derecha del Destino
El cuadro combinado se puede utilizar para restaurar el contenido de las etiquetas, lo que también puede ser útil.
después de cambiar el Destino.

Casi todos los cuadros de diálogo cuentan con un botón Guardar configuración, que se puede utilizar para almacenar
configuraciones específicas del diálogo y el tamaño de la ventana de forma persistente.

Desde etiquetas conduce a un subdiálogo para establecer marcos de etiqueta a partir del contenido de otra etiqueta
marcos. Esto se puede usar para simplemente copiar información entre etiquetas o extraer una parte
de un marco e insértelo en otro.

Al igual que en la importación desde archivo / portapapeles, existen formatos configurables libremente para realizar
diferentes operaciones. Ya están preconfigurados los formatos para copiar el valor del álbum
Artista del álbum, compositor o director, y para extraer el número de pista de los campos de título
que contienen un número. También hay un formato para extraer un subtítulo de un título.
campo.

El siguiente ejemplo explica cómo agregar un formato personalizado, que establece la información
desde el campo Subtítulo también en el campo Comentario. Cree un nuevo formato usando Agregar y
establezca un nuevo nombre, por ejemplo, "Subtítulo para comentario". Luego ingrese "% {subtitle}" en Fuente y
"% {comentario} (. *)" para Extracción y haga clic en Guardar configuración.

La expresión en Fuente puede contener códigos de formato para marcos de etiquetas arbitrarios, múltiples
Los códigos se pueden utilizar para combinar el contenido de diferentes marcos. Para cada pista, un
el texto se genera a partir de sus etiquetas utilizando el formato de origen y la expresión regular
from Extraction se aplica a este texto para establecer nuevos valores para las etiquetas. Códigos de formato
se utilizan antes de los paréntesis de captura para especificar el marco de la etiqueta donde se capturaron
el texto se almacenará. Funciona de la misma forma que para la importación desde archivo / portapapeles.

Archivo → Importar desde gnudb.org ...
Importe desde un servidor freedb.org utilizando la búsqueda de álbumes de gnudb.org. Se abre este elemento de menú
el mismo diálogo de importación que Importar ..., pero abre directamente el diálogo de gnudb.org.

Archivo → Importar desde TrackType.org ...
Importar desde el servidor TrackType.org. Este elemento de menú abre el mismo cuadro de diálogo de importación que
Importar ..., pero abre directamente el cuadro de diálogo TrackType.org.

Archivo → Importar desde Discogs ...
Importar desde el servidor de Discogs. Este elemento de menú abre el mismo cuadro de diálogo de importación que
Importar ..., pero abre directamente el cuadro de diálogo Desde Discogs.

Archivo → Importar desde Amazon ...
Importar desde Amazon. Este elemento de menú abre el mismo cuadro de diálogo de importación que Importar ..., pero
abre directamente el cuadro de diálogo Desde Amazon.

Archivo → Importar desde MusicBrainz Release ...
Importar desde la base de datos de versiones de MusicBrainz. Este elemento de menú abre la misma importación
cuadro de diálogo como Importar ..., pero abre directamente el cuadro de diálogo Lanzamiento de MusicBrainz.

Archivo → Importar desde la huella digital de MusicBrainz ...
Importar desde un servidor MusicBrainz. Este elemento de menú abre el mismo cuadro de diálogo de importación que
Importar ..., pero abre directamente el cuadro de diálogo Huella digital From MusicBrainz.

Archivo → Importación automática ...
La importación automática permite importar información de varios álbumes desde varios sitios web.
servicios. Si se seleccionan directorios en la lista de archivos, realice un seguimiento de los datos del
Se importarán directorios. Si no se selecciona ningún directorio, todos los directorios del archivo
se importará la lista.

El tipo de etiqueta (Etiqueta 1, Etiqueta 2, Etiqueta 1 y Etiqueta 2) se puede seleccionar usando el Destino
caja combo.

Los perfiles determinan qué servidores serán contactados para obtener información del álbum. Algunos
Los perfiles están predefinidos (Todos, MusicBrainz, Discogs, Carátula), los perfiles personalizados se pueden
agregado usando el botón Agregar a la derecha del cuadro combinado Perfil.

La siguiente tabla muestra los servidores que se utilizarán al importar la información del álbum.
utilizando el perfil seleccionado. El proceso de importación de un álbum finaliza si todos
Se ha encontrado la información requerida, por lo que el orden de las filas en la tabla es
importante. Puede cambiarse usando los botones Subir y Bajar. Editar puede ser
utilizado para cambiar una entrada existente. La selección del servidor ofrece los mismos servidores que puede
ser utilizado en las funciones de importación. Las etiquetas estándar, las etiquetas adicionales y la carátula determinan
la información que se obtendrá del servidor. Por último, la precisión es la
precisión mínima que debe lograrse para aceptar los datos importados. Si la exactitud
es insuficiente, se probará con el siguiente servidor de la lista. El mismo diálogo que contiene
las propiedades del servidor aparecen cuando se hace clic en Agregar para agregar una nueva entrada de servidor. Existente
las entradas se pueden eliminar usando Eliminar.

Para iniciar una importación por lotes automática con el perfil seleccionado, haga clic en Iniciar. Detalles
acerca de la importación en ejecución se muestran en la parte superior del cuadro de diálogo. El proceso puede ser
abortado con el botón Abortar.

Archivo → Examinar carátula ...
El cuadro de diálogo Examinar carátula ayuda a encontrar la carátula del álbum. Artista / Álbum está lleno
de las etiquetas si es posible. Source ofrece una variedad de sitios web con carátulas de álbumes.
La URL con el artista y el álbum como parámetros se puede encontrar debajo del nombre. Codificado en URL
Los valores para el artista y el álbum se pueden insertar usando % u {artista} y % u {album}, Otros
Los valores de las etiquetas también son posibles, como se describe en Configurar Kid3, Acciones de usuario.
Se pueden ingresar más fuentes después de la entrada "Fuente personalizada" reemplazando "Personalizada
Source "con el nombre de la fuente, presionando Enter, luego insertando la URL y finalmente
presionando Guardar configuración. El comando del navegador resultante se muestra en la parte superior de la
cuadro de diálogo y se puede iniciar haciendo clic en Examinar. El navegador, que se puede configurar en
la configuración, se inicia con la fuente seleccionada. A continuación, se puede arrastrar una imagen de portada.
desde el navegador a la ventana de Kid3 y se establecerá en el marco de imagen del
archivos seleccionados

Porque no todos los navegadores admiten la función de arrastrar y soltar imágenes y las imágenes de los sitios web
a menudo tienen una URL, en tales casos Kid3 recibirá la URL y no la imagen. Si el
La URL apunta a una imagen, se descargará. Sin embargo, si la URL se refiere a alguna
otro recurso web, debe traducirse a la imagen correspondiente. Tal
las asignaciones se definen en la extracción de URL de la tabla. La columna de la izquierda Match contiene un
expresión regular que se compara con la URL. Si coincide, el capturado
las expresiones entre paréntesis se insertan en el patrón de la URL de imagen derecha
columna (en las posiciones marcadas con \ 1, etc.). La expresión regular reemplazada
contiene la URL de la imagen. De esta forma, se pueden importar las carátulas de Amazon,
Imágenes de Google, etc. mediante la función de arrastrar y soltar. También es posible definir su propio
mapeos.

Archivo → Exportar ...
El diálogo de exportación se utiliza para almacenar datos de las etiquetas en un archivo o en el portapapeles. los
El editor en la parte superior muestra una vista previa de los datos para exportar. Si los datos de exportación contienen
tabuladores, la exportación se muestra en una tabla. Los datos serán generados
de las etiquetas en el directorio actual según el formato configurado.

La configuración de formato es similar a la del cuadro de diálogo Importar: El campo superior contiene
el título (por ejemplo, "CSV sin comillas"), seguido del encabezado, que se generará en
el comienzo del archivo. Siguen los datos de la pista; se utiliza para todas las pistas. Finalmente,
el tráiler se puede utilizar para generar texto de acabado.

Los campos de formato no contienen expresiones regulares como en el cuadro de diálogo Importar, sino solo
Expresiones de formato de salida con% -expresiones especiales, que serán reemplazadas por valores
de las etiquetas. Todo funciona como el formato de nombre de archivo, y los mismos códigos son
utilizado más algunos códigos adicionales. No solo los códigos que se enumeran a continuación, sino todos los marcos de etiquetas
se pueden usar nombres.

·% S% {title} Título (canción)

·% A% {artist} Artista

·% L% {album} Álbum

·% C% {comentario} comentario

·% Y% {year} año

·% T% {track} Seguimiento (por ejemplo, 01)

·% T% {track.n} Seguimiento con ancho de campo n (por ejemplo, 001 para% {track.3})

·% T% {tracknumber} Pista (sin ceros a la izquierda, por ejemplo, 1)

·% G% {genre} Género

·% F% {file} Nombre de archivo

·% P% {filepath} Ruta

·% U% {url} URL

·% D% {duration} Duración en minutos: segundos

·% D% {segundos} Duración en segundos

·% N% {tracks} Número de pistas del álbum

·% E% {extension} Extensión de archivo

·% O% {tag1} El formato de la etiqueta 1 (ID3v1.1 o vacío si no existe)

·% O% {tag2} El formato de la etiqueta 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF o vacío si no existe)

·% B% {bitrate} Velocidad de bits en kbit / s

·% V% {vbr} VBR o vacío (solo para ID3v2.3 con id3lib)

·% R% {samplerate} Frecuencia de muestreo en Hz

·% M% {mode} Modo de canal (estéreo o estéreo conjunto)

·% H% {canales} Número de canales (1 o 2)

· Códec% k% {codec} (p. Ej. MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

Algunos formatos están predefinidos. "CSV sin comillas" separa los campos por pestañas. Datos en
este formato se puede importar nuevamente a Kid3 usando el formato de importación con el mismo
nombre. "CSV entre comillas" incluye además los campos entre comillas dobles, lo que facilita la
importar en aplicaciones de hoja de cálculo. Sin embargo, los campos no deben contener ningún doble
comillas cuando se utiliza este formato. "Extended M3U" y "Extended PLS" generan listas de reproducción
con atributos extendidos y nombres de ruta absolutos. "HTML" se puede utilizar para generar un
Página HTML con hipervínculos a las pistas. "Kover XML" crea un archivo que se puede
importado por el programa de impresión de portadas Kover. "Detalles técnicos" proporciona información
sobre velocidad de bits, frecuencia de muestreo, canales, etc. Finalmente, "Formato personalizado" se deja vacío para
definición de un formato personalizado. Puede definir más formatos propios agregando líneas
en el archivo kid3rc en el directorio de configuración. Los otros formatos se pueden adaptar a
tus necesidades.

Se puede seleccionar la fuente de las etiquetas para generar los datos de exportación (Etiqueta 1 o Etiqueta 2)
con un cuadro combinado. Empujar a archivo o al portapapeles almacena los datos en un archivo o en el
portapapeles. Aceptar y Cancelar cierran el cuadro de diálogo, mientras que Aceptar acepta el cuadro de diálogo actual
configuración.

Archivo → Crear lista de reproducción
Crea una lista de reproducción. El formato y el contenido de la lista de reproducción se pueden configurar mediante varios
.

El nombre de la lista de reproducción puede ser el mismo que el nombre del directorio o usar un formato con valores
de las etiquetas, por ejemplo, "% {artista} -% {álbum}" para tener el nombre del artista y el álbum en el
nombre del archivo de la lista de reproducción. Los códigos de formato son los mismos que para Exportar. La extensión depende
en el formato de lista de reproducción.

La ubicación de la lista de reproducción generada está determinada por la selección de Crear en
caja combo.

Directorio actual
La lista de reproducción se crea en el directorio actual y contiene solo archivos del
directorio actual.

Cada directorio
Se crea una lista de reproducción en cada directorio que contiene archivos enumerados, y cada
playlist contiene los archivos de ese directorio.

Directorio de nivel superior
Solo se crea una lista de reproducción en el directorio de nivel superior (es decir, el directorio del
lista de archivos) y contiene los archivos enumerados del directorio de nivel superior y todos los
sus subdirectorios.

El formato de la lista de reproducción puede ser M3U, PLS o XSPF.

Si se marca Incluir solo los archivos seleccionados, solo se mostrarán los archivos seleccionados.
incluido en la lista de reproducción. Si se selecciona un directorio, se seleccionan todos sus archivos.
Si esta casilla de verificación no está activada, todos los archivos de audio se incluyen en la lista de reproducción.

Ordenar por nombre de archivo selecciona el caso habitual en el que los archivos se ordenan por nombre de archivo.
Con el campo Ordenar por etiqueta, es posible ordenar por una cadena de formato con valores de etiqueta
los campos. Por ejemplo, "% {track.3}" se puede utilizar para ordenar por número de pista (el ".3" es
utilizado para obtener tres dígitos con ceros a la izquierda porque las cadenas se utilizan para ordenar). Eso
también es posible usar varios campos, por ejemplo, "% {genre}% {year}" para ordenar usando una cadena
compuesto por género y año.

Las entradas de la lista de reproducción tendrán rutas de archivo relativas o absolutas dependiendo de si
Se establece Usar ruta relativa para archivos en lista de reproducción o Usar ruta completa para archivos en lista de reproducción.

Cuando se establece la lista de archivos de solo escritura, la lista de reproducción solo contendrá las rutas al
archivos. Para generar una lista de reproducción ampliada con información adicional, una cadena de formato
se puede configurar usando el control Escribir información.

Archivo → Salir (Ctrl + Q)
Cierra la aplicación.

El Editar Menú
Editar → Seleccionar todo (Alt + A)
Selecciona todos los archivos.

Editar → Deseleccionar (Ctrl + Shift + A)
Deselecciona todos los archivos.

Editar → Seleccionar todo en el directorio
Selecciona todos los archivos del directorio actual.

Editar → Archivo anterior (Alt + Arriba)
Selecciona el archivo anterior.

Editar → Archivo siguiente (Alt + Abajo)
Selecciona el siguiente archivo.

Editar → Buscar ... (Ctrl + F)
Busque cadenas en los nombres de archivo y las etiquetas. El cuadro de diálogo Buscar es un subconjunto del
Reemplazar cuadro de diálogo, que se describe a continuación.

Editar → Reemplazar ... (Ctrl + R)
Esta función abre un cuadro de diálogo para buscar y reemplazar cadenas en los nombres de archivo y
etiquetas. El conjunto de fotogramas donde se realiza la búsqueda se puede restringir mediante
desactivando la casilla de verificación Seleccionar todo y seleccionando los fotogramas que se buscarán.
También hay opciones de búsqueda disponibles para buscar hacia atrás, distinguir entre mayúsculas y minúsculas y para
usa expresiones regulares.

Dependiendo del número de archivos, la búsqueda puede llevar algún tiempo, por lo que puede ser
abortado cerrando el diálogo.

El Herramientas Menú
Herramientas → Aplicar formato de nombre de archivo
Cuando Formato durante la edición está desactivado para el formato de nombre de archivo en la configuración
cuadro de diálogo, este elemento de menú se puede utilizar para aplicar el formato configurado a los nombres de los
archivos seleccionados. Esto también se puede utilizar para comprobar si los nombres de los archivos se ajustan a la
formato configurado aplicando el formato a todos los archivos guardados y luego verificando si hay alguno
Los archivos se cambiaron (y por lo tanto se marcaron con un símbolo de disco en el cuadro de lista de archivos).

Herramientas → Aplicar formato de etiqueta
Cuando Formato durante la edición está desactivado para el formato de etiqueta en la configuración
diálogo, este elemento de menú se puede utilizar para aplicar el formato configurado a las etiquetas del
archivos seleccionados. Esto también se puede utilizar para comprobar si las etiquetas se ajustan a la
formato configurado aplicando el formato a todos los archivos guardados y luego verificando si hay alguno
Los archivos se cambiaron (y por lo tanto se marcaron con un símbolo de disco en el cuadro de lista de archivos).

Herramientas → Aplicar codificación de texto
Establece la codificación de texto seleccionada en Configuración / Configurar Kid3 ... / Etiquetas / Etiqueta 2 para todos
archivos seleccionados. Si se selecciona UTF8, se utilizará UTF16 para las etiquetas ID3v2.3.0 porque
UTF8 no es compatible con este formato.

Herramientas → Cambiar nombre de directorio ...
Este cuadro de diálogo ofrece la posibilidad de cambiar automáticamente el nombre del
directorio de acuerdo con las etiquetas de los archivos. Varios formatos están preconfigurados para
incluya información sobre el artista, el álbum y el año en el nombre del directorio. Tambien es
posible establecer un formato personalizado, los siguientes códigos especiales se utilizan para insertar la etiqueta
valores en el nombre del directorio:

·% S% {title} Título (canción)

·% A% {artist} Artista

·% L% {album} Álbum

·% C% {comentario} comentario

·% Y% {year} año

·% T% {track} Seguimiento (por ejemplo, 01)

·% T% {track.n} Seguimiento con ancho de campo n (por ejemplo, 001 para% {track.3})

·% T% {tracknumber} Pista (sin ceros a la izquierda, por ejemplo, 1)

·% G% {genre} Género

Si se encuentra un separador de directorio "/" en el formato, se crean varios directorios.
Si desea crear un nuevo directorio en lugar de cambiar el nombre del directorio actual,
seleccione Crear directorio en lugar de Cambiar nombre de directorio. La fuente de la información de la etiqueta
se puede elegir entre Desde etiqueta 1 y Etiqueta 2, Desde etiqueta 1 y Desde etiqueta 2. Una vista previa de
la operación de cambio de nombre realizada en el primer archivo se puede ver en el campo Desde y Hasta
secciones del cuadro de diálogo.

Se puede cambiar el nombre de varios directorios seleccionándolos.

Herramientas → Numerar pistas ...
Si los números de pista en las etiquetas no están configurados o tienen valores incorrectos, esta función
puede numerar las pistas automáticamente en orden ascendente. El número de inicio se puede configurar en
el diálogo. Si solo es necesario numerar una parte de las pistas, es necesario seleccionarlas.

Cuando se marca el número total de pistas, el número de pistas también se establecerá en el
las etiquetas.

Es posible numerar las pistas en varios directorios. Las carpetas tienen que ser
expandido y seleccionado.

Si se marca Restablecer contador para cada directorio, la numeración de pistas se reinicia con el
dado el número para cada directorio cuando se seleccionan varias carpetas.

El cuadro de diálogo de número de pistas también se puede utilizar para formatear números de pista existentes sin
cambiando los valores cuando la casilla de verificación izquierda para Número de inicio está desactivada. El total
Se agregará un número de pistas si la casilla de verificación correspondiente está activa, que puede ser
se utiliza para establecer el total de todas las pistas seleccionadas. Si solo formatea el existente
Si desea números, esta casilla de verificación también debe desactivarse.

Herramientas → Filtro ...
El filtro se puede utilizar para mostrar solo aquellos archivos que coincidan con ciertos criterios. Esta
es útil si desea organizar una gran colección y editar solo aquellos archivos que
no están en el esquema deseado. La expresión que define qué archivos mostrar utiliza la
mismos códigos de formato que se utilizan en el formato de nombre de archivo, importación y exportación.

·% S% {title} Título (canción)

·% A% {artist} Artista

·% L% {album} Álbum

·% C% {comentario} comentario

·% Y% {year} año

·% T% {track} Seguimiento (por ejemplo, 01)

·% T% {track.n} Seguimiento con ancho de campo n (por ejemplo, 001 para% {track.3})

·% T% {tracknumber} Pista (sin ceros a la izquierda, por ejemplo, 1)

·% G% {genre} Género

·% F% {file} Nombre de archivo

·% P% {filepath} Ruta absoluta al archivo

·% E% {extension} Extensión de archivo

·% O% {tag1} El formato de la etiqueta 1 (ID3v1.1 o vacío si no existe)

·% O% {tag2} El formato de la etiqueta 2 (ID3v2.3.0, ID3v2.4.0, ID3v2.2.0, ID3v2.2.1,
Vorbis, APE, MP4, ASF o vacío si no existe)

·% B% {bitrate} Velocidad de bits en kbit / s

·% V% {vbr} VBR o vacío (solo para ID3v2.3 con id3lib)

·% R% {samplerate} Frecuencia de muestreo en Hz

·% M% {mode} Modo de canal (estéreo o estéreo conjunto)

·% H% {canales} Número de canales (1 o 2)

· Códec% k% {codec} (p. Ej. MPEG 1 Layer 3, MP4, Ogg Vorbis, FLAC, MPC, APE, ASF,
AIFF, WAV)

·% 1a% 1 {artista}, ... Usa el prefijo 1 para obtener los valores de la etiqueta 1

·% 2a% 2 {artista}, ... Usa el prefijo 2 para obtener los valores de la etiqueta 2

Estos códigos se reemplazan con los valores del archivo y las cadenas resultantes pueden
compararse con las siguientes operaciones:

· S1 es igual a s2: verdadero si s1 y s2 son iguales.

· S1 contiene s2: verdadero si s1 contiene s2, es decir, s2 es una subcadena de s1.

· S coincide con re: true si s coincide con la expresión regular re.

Las expresiones verdaderas se reemplazan por 1, las falsas por 0. Los valores verdaderos se representan por 1,
verdadero, activado y sí, valores falsos por 0, falso, desactivado y no. Las operaciones booleanas no lo son,
y, o (en este orden de precedencia) y se pueden agrupar entre paréntesis.

Algunas reglas de filtrado están predefinidas y pueden servir como ejemplos para sus propias expresiones:

Todos
Cuando se filtra la lista de archivos, esto se muestra con "[filtrado]" en el título de la ventana
- y todos los archivos se mostrarán nuevamente, el filtrado se puede revertir usando este
filtrar. Utiliza una expresión vacía, pero un valor verdadero tendría el mismo efecto.

La etiqueta de nombre de archivo no coincide
no (%{ruta de archivo} contiene "%{artista} - % {album} /% {track} %{título}")

Comprueba si la ruta del archivo se ajusta al formato del nombre del archivo. Esta regla es
se adapta automáticamente si cambia el formato del nombre del archivo.

Sin etiqueta 1
% {tag1} iguales ""

Muestra solo archivos que no tienen etiqueta 1.

Sin etiqueta 2
% {tag2} iguales ""

Muestra solo archivos que no tienen etiqueta 2.

Etiqueta ID3v2.3.0
% {tag2} iguales "ID3v2.3.0"

Muestra solo archivos que tienen una etiqueta ID3v2.3.0.

Etiqueta ID3v2.4.0
% {tag2} iguales "ID3v2.4.0"

Muestra solo archivos que tienen una etiqueta ID3v2.4.0.

Etiqueta 1! = Etiqueta 2
no (% 1 {título} iguales % 2 {título} y % 1 {album} iguales % 2 {album} y % 1 {artista}
iguales % 2 {artista} y %1 comentario} iguales %2 comentario} y %1 año} iguales %2 año}
y % 1 {track} iguales % 2 {track} y % 1 {género} iguales % 2 {género})

Muestra archivos con diferencias entre la etiqueta 1 y la etiqueta2.

Etiqueta 1 == Etiqueta 2
% 1 {título} iguales % 2 {título} y % 1 {album} iguales % 2 {album} y % 1 {artista} iguales
% 2 {artista} y %1 comentario} iguales %2 comentario} y %1 año} iguales %2 año} y
% 1 {track} iguales % 2 {track} y % 1 {género} iguales % 2 {género}

Muestra archivos con etiqueta 1 y etiqueta 2 idénticas.

Incompleto
%{título} iguales "" or %{artista} iguales "" or %{álbum} iguales "" or %{año} iguales
"" or %{número de pista} iguales "" or %{género} iguales ""

Muestra archivos con valores vacíos en las etiquetas estándar (título, artista, álbum, fecha,
número de pista, género).

No hay imagen
%{fotografía} iguales ""

Muestra solo archivos que no tienen imagen.

Filtro personalizado
Para agregar su propio filtro, seleccione esta entrada. Por ejemplo, si quieres tener un
filtro para artistas que comiencen con "El", reemplace "Filtro personalizado" por el nombre "El
Bands "y presione Enter. Luego, inserte la siguiente expresión en la línea de edición:

%{artista} cerillas "Los.*"

Luego haga clic en Guardar configuración. Haga clic en Aplicar para filtrar los archivos. Todos los archivos procesados ​​son
se muestra en la vista de texto, con un "+" para aquellos que coinciden con el filtro y un "-"
para los demás. Cuando termine, solo los archivos con un artista que comience con "The"
se muestran y el título de la ventana está marcado con "[filtrado]".

Herramientas → Convertir ID3v2.3 a ID3v2.4
Si hay etiquetas ID3v2.3 en los archivos seleccionados, se convertirán a ID3v2.4
etiquetas. Se descartarán los marcos que no sean compatibles con TagLib. Solo archivos sin
los cambios no guardados se convertirán.

Herramientas → Convertir ID3v2.4 a ID3v2.3
Si hay etiquetas ID3v2.4 en los archivos seleccionados, se convertirán a ID3v2.3
etiquetas. Solo se convertirán los archivos sin cambios sin guardar.

Herramientas → Jugar
Esto abre una barra de herramientas simple para reproducir archivos de audio. Contiene botones para lo básico
operaciones (Reproducir / Pausa, Detener reproducción, Pista anterior, Pista siguiente, Cerrar), controles deslizantes para
posición y volumen y una visualización de la posición actual. Si hay varios archivos
seleccionado, se reproducirán las pistas seleccionadas; de lo contrario, se reproducirán todos los archivos.

El Ajustes Menú
Configuración → Mostrar barra de herramientas
Alterna la visualización de la barra de herramientas.

Configuración → Mostrar barra de estado
Alterna la visualización de la barra de estado, que muestra acciones más largas como abrir o
guardar un directorio.

Configuración → Mostrar imagen
Alterna la visualización de la imagen de vista previa de la carátula del álbum.

Configuración → Ocultar etiquetas automáticamente
Las etiquetas vacías se ocultan automáticamente si esta opción está activa. El archivo, la etiqueta 1 y la etiqueta
2 secciones se pueden contraer y expandir manualmente haciendo clic en el correspondiente - / +
botones.

Preferencias → Configurar Kid3 ...
Abre el cuadro de diálogo de configuración, que consta de páginas para etiquetas, archivos, acciones del usuario,
y configuración de red.

Las opciones específicas de etiquetas se pueden encontrar en la página Etiquetas, que a su vez está separada en
tres pestañas para Etiqueta 1, Etiqueta 2 y Etiqueta 1 y Etiqueta 2.

Si se marca Marcar campos truncados, los campos ID3v1.1 truncados se marcarán en rojo. los
Los campos de texto de las etiquetas ID3v1.1 solo pueden tener 30 caracteres, el comentario solo 28
caracteres. Además, el género y los números de pista están restringidos, de modo que los campos se pueden
truncado cuando se importa o se transfiere desde ID3v2. Campos truncados y el archivo
se marcará en rojo, y la marca se eliminará después de que se haya editado el campo.

Con la codificación de texto para ID3v1 es posible establecer el juego de caracteres utilizado en ID3v1
etiquetas. Se supone que esta codificación es ISO-8859-1, por lo que se recomienda mantener esta
valor por defecto. Sin embargo, hay etiquetas con diferentes codificaciones, por lo que puede ser
establecer aquí y las etiquetas ID3v1 se pueden copiar a ID3v2 que admite Unicode.

La casilla de verificación Usar formato de pista / número total de pistas controla si la pista
El campo numérico de las etiquetas ID3v2 contiene simplemente el número de pista o, además, el total
número de pistas en el directorio.

Cuando se marca Género como texto en lugar de una cadena numérica, todos los géneros ID3v2 serán
almacenado como una cadena de texto incluso si hay un código correspondiente para los géneros ID3v1. Si
esta opción no está configurada, los géneros para los que existe un código ID3v1 se almacenan como el número
del código de género (entre paréntesis para ID3v2.3). Así, el género Metal se almacena como
"Metal" o "(9)" según esta opción. Géneros que no están en la lista de ID3v1
los géneros siempre se almacenan como una cadena de texto. Se mejora el propósito de esta opción
compatibilidad con dispositivos que no interpretan correctamente los códigos de género.

La codificación de texto define la codificación predeterminada utilizada para los fotogramas ID3v2 y se puede establecer en
ISO-8859-1, UTF16 o UTF8. UTF8 no es válido para marcos ID3v2.3.0; si está configurado,
En su lugar, se utilizará UTF16. Para los fotogramas ID3v2.4.0, son posibles las tres codificaciones.

La versión utilizada para las nuevas etiquetas determina si las nuevas etiquetas ID3v2 se crean como versión
2.3.0 o 2.4.0. En el primer caso, id3lib se utiliza como en versiones anteriores de
Kid3 y TagLib solo se aplican cuando se encuentra una etiqueta ID3v2.4.0. En el segundo
caso, ID3v2.4.0 (TagLib), TagLib se usa generalmente para archivos MP3; cambiado o recién
Las etiquetas creadas se guardarán en la versión 2.4.0. Cuando se selecciona ID3v2.3.0 (TagLib),
TagLib también se utiliza para etiquetas ID3v2.3.0.

Los dígitos del número de pista es el número de dígitos en los campos de Número de pista. Los ceros iniciales son
utilizado para rellenar. Por ejemplo, con un valor de 2, la pista número 5 se establece como "05".

El nombre del campo Comentario del cuadro combinado solo es relevante para archivos Ogg / Vorbis y FLAC y
establece el nombre del campo utilizado para los comentarios. Diferentes aplicaciones parecen utilizar
diferentes nombres, "COMENTARIO", por ejemplo, es usado por xmms, mientras que amaroK usa
"DESCRIPCIÓN".

El formato de las imágenes en los archivos Ogg / Vorbis está determinado por el nombre del campo Imagen, que
puede ser METADATA_BLOCK_PICTURE o COVERART. El primero es el estándar oficial y utiliza
el mismo formato que las imágenes en las etiquetas FLAC. COVERART es una forma no oficial anterior de
incluir imágenes en los comentarios de Vorbis. Se puede utilizar para compatibilidad con versiones anteriores.
jugadores.

Si la casilla Marcar si es mayor que está activada, los archivos que contienen el álbum incrustado
las carátulas que exceden el tamaño indicado en bytes están marcadas en rojo. Esto se puede usar para encontrar
archivos que contienen imágenes de gran tamaño que no son aceptadas por algunas aplicaciones y
jugadores. El valor predeterminado es 131072 bytes (128 KB).

Los géneros personalizados se pueden utilizar para definir géneros que no están disponibles en el estándar
lista de géneros, por ejemplo, "Gothic Metal". Dichos géneros personalizados aparecerán en el cuadro combinado Género.
de la etiqueta 2. Para las etiquetas ID3v1.1, solo se pueden utilizar los géneros predefinidos.

La lista de géneros personalizados también se puede utilizar para reducir la cantidad de géneros disponibles en
el cuadro combinado de género a los que se utilizan habitualmente. Si su colección contiene principalmente música
en los géneros Metal, Gothic Metal, Ancient y Hard Rock, puedes ingresar a esos géneros
y marque Mostrar solo géneros personalizados. El cuadro combinado Tag 2Genre solo contendrá
esos cuatro géneros y no tendrá que buscar en la lista completa de géneros para
ellos. En este ejemplo, solo el Metal y el Hard Rock se incluirán en los géneros de la etiqueta 1.
lista, porque esas dos entradas de géneros personalizados son géneros estándar. Si muestra solo personalizado
géneros no está activo, los géneros personalizados se pueden encontrar al final de la lista de géneros.

Marcos de acceso rápido define qué tipos de marcos se muestran siempre en la sección Etiqueta 2.
Estos marcos se pueden agregar sin usar primero el botón Agregar. El orden de estos
Los marcos de acceso rápido se pueden cambiar arrastrando y soltando elementos.

Formato de etiqueta contiene opciones para el formato de las etiquetas. Cuando Formatear durante la edición está
marcado, la configuración de formato se utiliza automáticamente al editar texto en la línea
ediciones. La conversión de mayúsculas y minúsculas se puede establecer en Sin cambios, Todo en minúsculas, Todo en mayúsculas,
Primera letra en mayúscula o Todas las primeras letras en mayúscula. Para utilizar la conversión con reconocimiento de configuración regional
entre minúsculas y mayúsculas, se puede seleccionar una configuración regional en el cuadro combinado
debajo. La lista de reemplazo de cadenas se puede establecer en asignaciones de cadenas arbitrarias. Para agregar un
nueva asignación, seleccione la celda Desde de una fila e inserte el texto para reemplazar, luego vaya a
la columna Para e ingrese el texto de reemplazo. Para eliminar un mapeo, configure la celda Desde en
un valor vacío (por ejemplo, escribiendo primero un espacio y luego un retroceso). Insertar y eliminar
filas también es posible usando un menú contextual que aparece cuando el botón derecho del mouse
se hace clic. El reemplazo solo está activo si la casilla de verificación Reemplazo de cadena está marcada.

En la página Archivos, se puede marcar la casilla de verificación Cargar los últimos archivos abiertos para que Kid3
abra y seleccione el último archivo seleccionado cuando se inicie la próxima vez. Preservar
La marca de tiempo del archivo se puede comprobar para conservar la marca de tiempo de modificación del archivo. Nombre del archivo
para portada establece el nombre que se sugiere cuando una imagen incrustada se exporta a una
archivo.

Si Marcar cambios está activo, los campos modificados se marcan con una etiqueta gris claro
fondo.

Formato de nombre de archivo contiene opciones para el formato de los nombres de archivo. Las mismas opciones que
en formato de etiqueta están disponibles.

La página Acciones del usuario contiene una tabla con los comandos que están disponibles en la
menú contextual de la lista de archivos. Para operaciones críticas como eliminar archivos, es
Es aconsejable marcar Confirmar para que aparezca un cuadro de diálogo de confirmación antes de ejecutar la
mando. La salida se puede marcar para ver la salida escrita por los comandos de la consola (estándar
salida y error estándar). Nombre es el nombre que se muestra en el menú contextual. Mando
es la línea de comando que se ejecutará. Los argumentos se pueden pasar utilizando los siguientes códigos:

·% F% {archivos} Rutas de archivo (una lista si se seleccionan varios archivos)

·% F% {file} Ruta de archivo a un solo archivo

·% UF% {urls} URL (una lista si se seleccionan varios archivos)

·% Uf% {url} URL a un solo archivo

·% D% {directorio} Directorio

·% S% {title} Título (canción)

·% A% {artist} Artista

·% L% {album} Álbum

·% C% {comentario} comentario

·% Y% {year} año

·% T% {track} Seguimiento (por ejemplo, 01)

·% T% {track.n} Seguimiento con ancho de campo n (por ejemplo, 001 para% {track.3})

·% T% {tracknumber} Pista (sin ceros a la izquierda, por ejemplo, 1)

·% G% {genre} Género

·% B% {browser} Comando para iniciar el navegador web

·% Q% {qmlpath} Directorio base de los archivos QML proporcionados

El código especial @separador se puede configurar como un comando para insertar un separador en el
menú contextual de acciones del usuario. Los elementos del menú se pueden colocar en un submenú encerrándolos con
@comenzarmenu y @endmenu comandos. El nombre del submenú está determinado por el Nombre
columna de la @comenzarmenu mando.

Para ejecutar scripts QML, @qml se utiliza como nombre de comando. La ruta al script QML es
pasado como parámetro. Los scripts proporcionados se pueden encontrar en la carpeta
% {qmlpath} / script / (en Linux normalmente / usr / share / kid3 / qml / script /, en Windows
qml / script / dentro del directorio de instalación y en OS X en la carpeta de la aplicación
kid3.app/Contents/Resources/qml/script/). Los scripts personalizados se pueden almacenar en cualquier
directorio. Si el código QML usa componentes GUI, @qmlview se utilizará en lugar de
@qml. Los parámetros adicionales se pasan al script QML donde estarán disponibles.
mediante el getArguments () función. Una descripción general de algunas funciones y propiedades que
están disponibles en QML se pueden encontrar en el apéndice Interfaz QML.

El comando que se insertará con% {browser} se puede definir en el navegador web
editar línea arriba. Los comandos que comienzan con% {browser} se pueden usar para obtener información
sobre los archivos de audio de la web, por ejemplo

%{navegador} http://lyricwiki.org/% u {artista}:% u {título}

consultará la letra de la canción actual en LetraWiki[10]. La "u" en% u {artista} y
% u {title} se utiliza para codificar en URL el artista% {artist} y la información% {title} de la canción. Eso
es fácil definir sus propias consultas de la misma manera, por ejemplo, una búsqueda de imágenes con
Google[11]:

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

Para agregar la carátula del álbum a la etiqueta 2, puede buscar imágenes con Google o Amazon usando
los comandos descritos anteriormente. La imagen se puede agregar a la etiqueta arrastrando y soltando.
También puede agregar una imagen con Agregar, luego seleccionar el marco de imagen e importar una imagen
archivar o pegar desde el portapapeles. Los marcos de imagen son compatibles con ID3v2, MP4, FLAC,
Etiquetas Ogg y ASF.

Para agregar y eliminar entradas en la tabla, se puede utilizar un menú contextual.

La página Red contiene solo un campo para insertar la dirección del proxy y, opcionalmente, la
puerto, separados por dos puntos. El proxy se utilizará al importar desde Internet.
servidor cuando la casilla de verificación está marcada.

En la página Complementos, los complementos disponibles se pueden habilitar o deshabilitar. Los complementos son
separados en dos secciones. La lista de complementos y prioridades de metadatos contiene complementos
que admiten formatos de archivo de audio. El orden de los complementos es importante porque
se prueban de arriba a abajo. Algunos formatos son compatibles con varios complementos, por lo que los archivos
se abrirá con el primer complemento que los admita. TaglibMetadata es compatible con la mayoría
formatos, si está en la parte superior de la lista, abrirá la mayoría de los archivos. Si quieres
para utilizar un complemento diferente para un formato de archivo, asegúrese de que aparece antes de la
Complemento TaglibMetadata. Detalles sobre el complemento de metadatos y por qué es posible que desee utilizarlo
ellos en lugar de TagLib se enumeran a continuación.

· Id3libMetadata: Usos id3lib[12] para etiquetas ID3v1.1 e ID3v2.3 en MP3, MP2, AAC
archivos. Admite algunos tipos de marcos más que TagLib. Otra razón para usarlo es
que TagLib solo es compatible con ID3v2.3 desde la versión 1.8.

· OggFlacMetadata: Usos libogg[13], libvorbis, archivolibvorbis[14] para archivos Ogg y
además libFLAC ++ y libFLAC[15] para archivos FLAC. Las razones para usarlos son
imágenes en archivos Ogg, que no son compatibles con TagLib y que son las
bibliotecas oficiales para estos formatos.

· TaglibMetadata: Usos EtiquetaLib[16] que admite muchos formatos de archivos de audio. Ya que
versión 1.8, también es compatible con ID3v2.3, por lo que se puede usar para todos los archivos de audio
apoyado por Kid3.

· Mp4v2Metadatos: mp4v2[17] fue utilizado originalmente por Kid3 para admitir archivos M4A.
Sin embargo, las versiones más recientes de TagLib brindan un buen soporte M4A, por lo que este complemento no es
construido por defecto.

La sección Complementos disponibles enumera los complementos restantes. Su orden no es
importante, pero se pueden habilitar o deshabilitar mediante las casillas de verificación.

· AmazonImport: se utiliza para la función Importar desde Amazon ...

· DiscogsImport: Se utiliza para la función Importar desde Discogs ...

· FreedbImport: se utiliza para importar desde gnudb.org ... e importar desde
TrackType.org ... funciones.

· MusicBrainzImport: se utiliza para la función Importar desde MusicBrainz Release ...

· AcoustidImport: se utiliza para la función Importar desde MusicBrainz Fingerprint ...
que depende de la cromaprint[18] y libav[19] bibliotecas.

Los complementos que estén deshabilitados no se cargarán. Esto se puede utilizar para optimizar los recursos.
tiempo de uso y puesta en marcha. La configuración de esta página solo tiene efecto después de reiniciar
Niño3.

Preferencias → Configurar accesos directos ...
Abre un cuadro de diálogo para asignar atajos de teclado para la mayoría de las funciones del programa. Allí
incluso hay funciones disponibles sin el menú o botón correspondiente, p. ej., archivo siguiente,
archivo anterior, seleccione todo.

El Ayuda Menú
Ayuda → Manual de Kid3
Abre este manual.

Ayuda → Acerca de Kid3
Muestra una breve información sobre Kid3 ;.

KID3-CLI

Comandos
niño3-cli ofrece una interfaz de línea de comandos para Kid3. Si se utiliza una ruta de directorio, el
se abre el directorio. Si se proporcionan una o más rutas de archivo, se abre el directorio común
y se seleccionan los archivos. Los comandos posteriores funcionarán en estos archivos. Comandos
se especifican usando -c opciones. Si se pasan varios comandos, se ejecutan en el
orden dada. Si los archivos son modificados por los comandos, se guardarán al final. Si no
se pasan las opciones de comando, niño3-cli comienza en modo interactivo. Se pueden ingresar comandos
y operará en la selección actual. Las siguientes secciones enumeran todos los disponibles
comandos.

Ayuda
ayuda [COMANDO-NOMBRE]

Muestra ayuda sobre los parámetros de COMANDO-NOMBRE o sobre todos los comandos si no hay comando
se da el nombre.

Tiempo de espera
tiempo de espera [predeterminado | apagado | HORA]

Sobrescriba el tiempo de espera del comando predeterminado. Los comandos CLI abortan después de un comando específico
el tiempo de espera ha expirado. Este tiempo de espera es de 10 segundos para ls y albúm de arte, 60 segundos para
autoimportar y filtrary 3 segundos para todos los demás comandos. Si una gran cantidad de archivos
debe procesarse, estos tiempos de espera pueden ser demasiado restrictivos, por lo que el tiempo de espera para todos
los comandos se pueden configurar para HORA ms, desactivado por completo o dejarlo en el valor predeterminado
valores.

Dejar solicitud en línea.
salida [fuerza]

Salir de la aplicación. Si hay archivos modificados sin guardar, el forzar el parámetro es
requerida.

Cambios directorio
cd [De miembros]

Si no es correcto De miembros se da, cambie al directorio de inicio. Si se proporciona un directorio,
cambiar al directorio. Si se proporcionan una o más rutas de archivo, cambie a su común
directorio y seleccione los archivos.

Imprimir las corriente trabajando directorio
pwd

Imprime el nombre de archivo del directorio de trabajo actual.

Directorio lista
ls

Enumere el contenido del directorio actual. Esto corresponde a la lista de archivos en el
Kid3 GUI. Cuatro caracteres antes de los nombres de los archivos muestran el estado del archivo.

·> Archivo está seleccionado.

· * Archivo modificado.

· 1 El archivo tiene una etiqueta 1; de lo contrario, se muestra '-'.

· 2 El archivo tiene una etiqueta 2; de lo contrario, se muestra '-'.

kid3-cli> ls
1- 01 Introducción.mp3
> 12 02 Solo tenemos este.mp3
* 1- 03 Outro.mp3

En este ejemplo, todos los archivos tienen una etiqueta 1, el segundo archivo también tiene una etiqueta 2 y es
seleccionado. Se modifica el tercer archivo.

Guardar las cambiado archivos
ahorrar

Seleccione presentar
selecciona [todos | ninguno | primero | anterior | siguiente | ARCHIVO...]

Para seleccionar todos los archivos, ingrese selecciona todos, para anular la selección de todos los archivos, ingrese selecciona ninguna. Para
atravesar los archivos en el directorio actual comience con selecciona la primera, luego avanza
usando selecciona Next o al revés usando selecciona anterior. Se pueden agregar archivos específicos a
la selección actual dando sus nombres de archivo. Los comodines son posibles, por lo que selecciona
* .mp3 seleccionará todos los archivos MP3 en el directorio actual.

kid3-cli> selecciona la primera
kid3-cli> ls
> 1- 01 Intro.mp3
12 02 Solo tenemos este.mp3
* 1- 03 Outro.mp3
kid3-cli> selecciona Next
kid3-cli> ls
1- 01 Introducción.mp3
> 12 02 Solo tenemos este.mp3
* 1- 03 Outro.mp3
kid3-cli> selecciona * .mp3
kid3-cli> ls
> 1- 01 Intro.mp3
> 12 02 Solo tenemos este.mp3
> * 1- 03 Outro.mp3

Seleccione etiqueta
etiqueta [NÚMEROS DE ETIQUETA]

Muchos comandos tienen un opcional NÚMEROS DE ETIQUETA parámetro, que especifica si el
El comando opera en la etiqueta 1 o en la etiqueta 2. Si se omite este parámetro, la etiqueta predeterminada
Se utilizan números, que se pueden configurar con este comando. Al inicio, se establece en 12, que
significa que la información se lee de la etiqueta 2 si está disponible, de lo contrario, de la etiqueta 1; modificaciones
se realizan en la etiqueta 2. El NÚMEROS DE ETIQUETA se puede configurar para 1 or 2 para operar solo en el
etiqueta correspondiente. Si se omite el parámetro, se muestra la configuración actual.

Recibe etiqueta marco
obtener [todos | MARCO-NOMBRE] [NÚMEROS DE ETIQUETA]

Este comando se puede utilizar para leer el valor de un marco de etiqueta específico u obtener información
sobre todos los marcos de etiquetas (si el argumento se omite o todos se utiliza). Los fotogramas modificados son
marcado con un '*'.

kid3-cli> obtener
Archivo: MPEG 1 Layer 3 192 kbps 44100 Hz Joint Stereo
Nombre: 01 Intro.mp3
Etiqueta 1: ID3v1.1
Introducción al título
Artista One Hit Wonder
Álbum Let's Tag
Fecha 2013
Número de pista 1
Género pop
kid3-cli> obtener título
Introducción

Para guardar el contenido de un marco de imagen en un archivo, use

obtener imagen: "/ ruta / a / carpeta.jpg"

Para guardar letras sincronizadas en un archivo LRC, use

obtener SYLT: "/ ruta / a / lyrics.lrc"

Set etiqueta marco
set {MARCO-NOMBRE} {MARCO-VALOR} [NÚMEROS DE ETIQUETA]

Este comando establece el valor de un marco de etiqueta específico.

kid3-cli> set remixer "OH Preguntarse"

Para configurar el contenido de un marco de imagen desde un archivo, use

set imagen: "/ ruta / a / carpeta.jpg" "Fotografía Descripción"

Para configurar letras sincronizadas desde un archivo LRC, use

set SYLT: "/ ruta / a / lyrics.lrc" "Letra Descripción"

Revertir
revertir

Revertir todas las modificaciones en los archivos seleccionados (o todos los archivos si no hay archivos
seleccionado).

Importa en presentar or portapapeles
importar {ARCHIVO} {FORMATO-NOMBRE} [NÚMEROS DE ETIQUETA]

Las etiquetas se importan del archivo ARCHIVO (o del portapapeles si portapapeles se utiliza para
ARCHIVO) en el formato con el nombre FORMATO-NOMBRE (p.ej "CSV no cotizado", consulte Importar).

Automático importar
autoimportar [NOMBRE DE PERFIL] [NÚMEROS DE ETIQUETA]

Importación por lotes usando perfil NOMBRE DE PERFIL (ver Importación automática, "Todos" se usa si
omitido).

Descargar álbum Protectora obras de arte
albúm de arte {Enlance} [todos]

Configure la carátula del álbum descargando una imagen de Enlance. Las reglas definidas en el
El cuadro de diálogo Examinar portada se utiliza para transformar URL generales (por ejemplo, de Amazon)
URL de la imagen. Para configurar la portada del álbum desde un archivo de imagen local, use el comando set.

kid3-cli> albúm de arte
http://www.amazon.com/Versus-World-Amon-Amarth/dp/B000078DOC

Exportar a presentar or portapapeles
exportar {ARCHIVO} {FORMATO-NOMBRE} [NÚMEROS DE ETIQUETA]

Las etiquetas se exportan a un archivo ARCHIVO (o al portapapeles si portapapeles se utiliza para ARCHIVO) en
el formato con el nombre FORMATO-NOMBRE (p.ej "CSV no cotizado", consulte Exportar).

Crear lista de reproducción
lista de reproducción

Cree una lista de reproducción en el formato establecido en la configuración, consulte Crear lista de reproducción.

Aplicá nombre de archivo formato
formato de nombre de archivo

Aplicar formato de nombre de archivo establecido en la configuración, consulte Aplicar formato de nombre de archivo.

Aplicá etiqueta formato
formato de etiqueta

Aplicar formato de nombre de etiqueta establecido en la configuración, consulte Aplicar formato de etiqueta.

Aplicá texto codificación
codificacion de texto

Aplique el conjunto de codificación de texto en la configuración, consulte Aplicar codificación de texto.

rebautizar directorio
renombrar [FORMATO] [crear | renombrar | dryrun] [NÚMEROS DE ETIQUETA]

Cambie el nombre o cree directorios a partir de los valores de las etiquetas de acuerdo con un determinado FORMATO
(p.ej %{artista} - %{álbum}, consulte Cambiar nombre de directorio), si no se proporciona un formato, el formato
definido en el cuadro de diálogo Cambiar nombre de directorio. El modo predeterminado es rebautizar; crear
directorios, Para crear debe darse explícitamente. Se realizarán las acciones de cambio de nombre
inmediatamente, para ver qué se haría, utilice el seco .

Número pistas
pistas numéricas [NÚMERO DE PISTA] [NÚMEROS DE ETIQUETA]

Numere las pistas seleccionadas empezando por NÚMERO DE PISTA (1 si se omite).

Filtrar
filtrar [NOMBRE DEL FILTRO | FORMATO DE FILTRO]

Filtre los archivos para que solo los archivos que coincidan FORMATO DE FILTRO son visibles. los
nombre de una expresión de filtro predefinida (p. ej. "Nombre del archivo Etiqueta Discordancia") puede ser usado
en lugar de una expresión de filtro, consulte Filtro.

kid3-cli> filtrar '%{título} contiene "tro" '
empezar?
/ inicio / urs / One Hit Wonder - Vamos a etiquetar
+ 01 Introducción.mp3
- 02 Solo tenemos este.mp3
+ 03 Outro.mp3
Terminados
kid3-cli> ls
1- 01 Introducción.mp3
1- 03 Outro.mp3
kid3-cli> filtrar Todos
empezar?
/ inicio / urs / One Hit Wonder - Vamos a etiquetar
+ 01 Introducción.mp3
+ 02 Solo tenemos este.mp3
+ 03 Outro.mp3
Terminados
kid3-cli> ls
1- 01 Introducción.mp3
12 02 Solo tenemos este.mp3
1- 03 Outro.mp3

Convertir ID3v2.3 a ID3v2.4
to24

Convertir ID3v2.4 a ID3v2.3
to23

Nombre del archivo en etiqueta
de la etiqueta [FORMATO] [NÚMEROS DE ETIQUETA]

Establezca los nombres de archivo de los archivos seleccionados a partir de los valores de las etiquetas, por ejemplo de la etiqueta
"%{pista} - %{título}" 1. Si no se especifica ningún formato, se utiliza el formato establecido en la GUI.

Etiqueta en nombre de archivo
etiquetar [FORMATO] [NÚMEROS DE ETIQUETA]

Establecer los marcos de etiquetas a partir de los nombres de archivo, por ejemplo etiquetar "%{artista de un album} -
% {album} /% {track} %{título}" 2. Si no se especifica ningún formato, el formato establecido en la GUI es
usó. Si el formato del nombre de archivo no coincide con este patrón, algunos otros
se prueban los formatos usados.

Etiqueta a otros etiqueta
sincronizar {NÚMERO DE ETIQUETA}

Copie los marcos de etiquetas de una etiqueta a la otra etiqueta, por ejemplo, para configurar la etiqueta ID3v2 desde el
Etiqueta ID3v1, utilice sincronizar 2.

Copiar
copia [NÚMERO DE ETIQUETA]

Copie los marcos de etiquetas del archivo seleccionado al búfer de copia interno. Entonces pueden ser
establecido en otro archivo usando el pastas mando.

Pasta
pastas [NÚMERO DE ETIQUETA]

Establecer marcos de etiquetas a partir del contenido de la copia búfer en los archivos seleccionados.

Eliminar
remove [NÚMERO DE ETIQUETA]

Quite una etiqueta.

Jugar
PLAY [pausa | detener | anterior | Siguiente]

Inicie la reproducción de audio. Una vez iniciado, se puede controlar con el pausa
(pausar y reanudar), detener, anterior y Next .

Ejemplos
Configure la portada del álbum en todos los archivos de un directorio utilizando la función de importación por lotes:

niño3-cli -c 'autoimportar "Cubrir Arte"' / ruta / a / dir

Elimine los marcos de comentarios y aplique el formato de etiqueta en ambas etiquetas de todos los archivos MP3 de un
directorio:

niño3-cli -c 'colocar comentario "" 1' -c 'colocar comentario "" 2' \
-c 'formato de etiqueta 1' -c 'formato de etiqueta 2' /ruta/a/dir/*.mp3

Importe automáticamente la etiqueta 2, sincronice con la etiqueta 1, establezca los nombres de archivo de la etiqueta 2 y finalmente
crear una lista de reproducción:

niño3-cli -c autoimportar -c 'syncto 1' -c de la etiqueta -c lista de reproducción \
/ruta/a/dir/*.mp3

Para todos los archivos con una etiqueta ID3v2.4.0, conviértalos a ID3v2.3.0 y elimine el marco del organizador:

niño3-cli -c "filtrar 'ID3v2.4.0 Etiqueta'" -c "Seleccione todos" -c to23 \
-c "colocar arranger '' " / ruta / a / dir

Este script de Python usa niño3-cli para generar cuadros iTunes Sound Check iTunNORM desde
reproducir información de ganancia.

#!/ usr / bin / env pitón
# Generar prueba de sonido de iTunes desde ReplayGain.
de __future__ import print_function
importar sistema operativo, sistema, subproceso

def rg2sc (ruta de directorio):
para root, dirs, archivos en os.walk (dirpath):
para el nombre en los archivos:
if name.endswith (('. mp3', '.m4a', '.aiff', '.aif')):
fn = os.path.join (raíz, nombre)
rg = subprocess.check_output ([
'kid3-cli', '-c', 'obtener "replaygain_track_gain"',
fn]). tira ()
si rg termina con (b 'dB'):
rg = rg [: - 3]
tratar:
rg = flotar (rg)
excepto ValueError:
print ('Valor% s de% s en no flotante'% (rg, fn))
continue
sc = ('' + ('% 08X'% int ((10 ** (-rg / 10)) * 1000))) * 10
subprocess.call ([
'kid3-cli', '-c', 'establece iTunNORM "% s"'% sc, fn])

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

CRÉDITOS Y LICENCIA

Kid3

Programa escrito por Urs Fleisch

LDF[ 20 ]

LPG[ 21 ]

INSTALACIÓN

Cómo a obtener Kid3
Kid3 se puede encontrar en http://kid3.sourceforge.net.

Requisitos
Kid3 necesita Qt[22]. KDE[23] se recomienda pero no es necesario, ya que Kid3 también se puede compilar
como una aplicación Qt. Kid3 se puede compilar para sistemas donde estas bibliotecas están
disponible, por ejemplo, para GNU / Linux, Windows y Mac OS X. Para etiquetar archivos Ogg / Vorbis, libogg[13],
libvorbis y archivolibvorbis[14] son ​​obligatorios, para archivos FLAC libFLAC ++ y libFLAC[15].
id3lib[12] se utiliza para archivos MP3. Estos cuatro formatos también son compatibles con EtiquetaLib[16],
que también puede manejar archivos Opus, MPC, APE, MP2, Speex, TrueAudio, WavPack, WMA, WAV, AIFF
y módulos de seguimiento. Para importar de huellas dactilares acústicas, cromaprint[18] y libav[ 19 ]
son usados.

Kid3 está disponible para la mayoría de las distribuciones de Linux, Windows y Mac OS X. Se pueden encontrar enlaces
on http://kid3.sourceforge.net.

Compilación y Instalación
Puede compilar Kid3 con o sin KDE. Sin KDE, Kid3 es una aplicación Qt simple y
carece de algunas funciones de configuración y sesión.

Para una versión de KDE, vaya al directorio superior y escriba

% cmake .
% para lograr
% para lograr instalar

Para compilar para diferentes versiones de Qt o KDE, configure el correspondiente cmake .

Si no todas las bibliotecas están presentes, Kid3 se construye con funcionalidad reducida. Entonces deberías
asegúrese de tener instalados todos los paquetes de desarrollo deseados. Por otro lado,
cmake-options controlan en qué bibliotecas se compilan. El valor predeterminado es -D
WITH_TAGLIB: BOOL = ON -D WITH_MP4V2: BOOL = APAGADO -D WITH_ID3LIB: BOOL = ON -D
WITH_CHROMAPRINT: BOOL = ON -D WITH_VORBIS: BOOL = ON -D WITH_FLAC: BOOL = ON . Estas opciones pueden
ser deshabilitado usando OFF.

Para construir Kid3 como una aplicación Qt sin KDE, use el cmake opción -DWITH_APPS = Qt. Para
construya una aplicación KDE y Qt, configure -DWITH_APPS = "Qt; KDE".

Se pueden utilizar Qt 4 o Qt 5. Para forzar el uso de Qt 4, configure -DWITH_QT4 = ACTIVADO, para forzar el uso de
Qt 5, juego -DWITH_QT5 = ACTIVADO, si ambas opciones están DESACTIVADAS (predeterminado), se prefiere Qt 4 si
ambas versiones están instaladas. Para usar una instalación Qt específica, configure
-DQT_QMAKE_EXECUTABLE = / ruta / a / qmake. Si la compilación de la aplicación KDE está habilitada, la configuración
Qt 4 utilizará KDE 4, mientras que la configuración de Qt 5 utilizará KDE 5.

La generación de paquetes RPM es compatible con el archivo kid3.spec, para los paquetes Debian, el
El script build-deb.sh está disponible.

La aplicación Qt también se puede compilar para Windows y Mac OS X. Los scripts en el
Las carpetas win32 y macosx se pueden utilizar para construir y crear paquetes. Las bibliotecas pueden ser
instalado usando buildlibs.sh.

Configuración
Con KDE, el filtro y formato de nombre de archivo, los formatos de importación, el nombre de archivo e ID3
formatos, la barra de herramientas y la configuración de la barra de estado, así como el tamaño de la ventana, se guardarán en
la ubicación estándar en el archivo kid3rc. Como aplicación Qt, este archivo está en
.config / Kid3 / Kid3.conf. En Windows, la configuración se almacena en el registro.

D-BUS INTERFAZ

D-Autobús Ejemplos
Las versiones Qt 4 y KDE 4 en Linux ofrecen una interfaz D-Bus para controlar Kid3 mediante scripts.
Los scripts se pueden escribir en cualquier idioma con enlaces D-Bus (por ejemplo, en Python) y se pueden
agregado a las acciones del usuario para ampliar la funcionalidad de Kid3.

El artista en la etiqueta 2 del archivo actual se puede establecer en el valor "One Hit Wonder" con el
siguiente código:

Cáscara

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

o más fácil con Qt's qdbus (visor qdbus se puede utilizar para explorar la interfaz en una GUI):

qdbus net.sourceforge.kid3 / Kid3 setFrame 2 Artist \
'One Hit Wonder'

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-> sesión-> get_service (
"net.sourceforge.kid3") -> get_object (
"/ Niño3", "net.sourceforge.Kid3");
$ kid3-> setFrame (2, "Artista", "One Hit Wonder");

D-Autobús API
La API de D-Bus se especifica en net.sourceforge.Kid3.xml. La interfaz Kid3 tiene la
siguientes métodos:

Abierto presentar or directorio
booleano openDirectory (cadena camino);

camino
ruta al archivo o directorio

Devuelve verdadero si está bien.

Guardar todos modificado archivos
booleano guardar (anular);

Devuelve verdadero si está bien.

Recibe a detallado error mensaje previsto by algo métodos
cadena getErrorMessage (void);

Devuelve un mensaje de error detallado.

Revertir cambios in las seleccionado archivos
revertir (anular);

Inicio an y automática lote importar
booleano batchImport (int32 etiquetaMáscara, cadena nombre de perfil);

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

nombre de perfil
nombre del perfil de importación por lotes que se utilizará

Importa etiquetas en a presentar
booleano importFromFile (int32 etiquetaMáscara, cadena camino, int32 fmtidx);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

camino
ruta de archivo

fmtidx
índice de formato

Devuelve verdadero si está bien.

Descargar álbum Protectora artículo
downloadAlbumArt (cadena url, booleano todos los archivos en dir);

url
URL del archivo de imagen o recurso de la carátula del álbum

todos los archivos en dir
true para agregar la imagen a todos los archivos en el directorio

Exportar etiquetas a a presentar
booleano exportToFile (int32 etiquetaMáscara, cadena camino, int32 fmtidx);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

camino
ruta de archivo

fmtidx
índice de formato

Devuelve verdadero si está bien.

Crear a lista de reproducción
booleano createPlaylist (vacío);

Devuelve verdadero si está bien.

Dejar las solicitud en línea.
salir (anular);

Seleccione todos archivos
selectAll (vacío);

Deseleccionar todos archivos
deselectAll (anular);

Set las la primera presentar as las corriente presentar
booleano firstFile (vacío);

Devuelve verdadero si hay un primer archivo.

Set las anterior presentar as las corriente presentar
booleano previousFile (void);

Devuelve verdadero si hay un archivo anterior.

Set las Next presentar as las corriente presentar
booleano nextFile (vacío);

Devuelve verdadero si hay un archivo siguiente.

Seleccione las la primera presentar
booleano selectFirstFile (void);

Devuelve verdadero si hay un primer archivo.

Seleccione las anterior presentar
booleano selectPreviousFile (void);

Devuelve verdadero si hay un archivo anterior.

Seleccione las Next presentar
booleano selectNextFile (void);

Devuelve verdadero si hay un archivo siguiente.

Seleccione las corriente presentar
booleano selectCurrentFile (void);

Devuelve verdadero si hay un archivo actual.

Expandir or colapso las corriente presentar ít if it is a directorio
booleano expandDirectory (vacío);

Un elemento de la lista de archivos es un directorio si getFileName () devuelve un nombre con '/' como último
carácter.

Devuelve verdadero si el elemento del archivo actual es un directorio.

Aplicá las presentar nombre formato
applyFilenameFormat (void);

Aplicá las etiqueta formato
applyTagFormat (vacío);

Aplicá texto codificación
applyTextEncoding (void);

Set las directorio nombre en las etiquetas
booleano setDirNameFromTag (int32 etiquetaMáscara, cadena formato, booleano Para crear);

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

formato
formato de nombre de directorio

Para crear
Verdadero para crear, falso para cambiar el nombre

Devuelve verdadero si está bien, de lo contrario, el mensaje de error está disponible usando getErrorMessage ().

Set posterior seguir números in las seleccionado archivos
numberTracks (int32 etiquetaMáscara, int32 primerTrackNr);

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

primerTrackNr
número que se utilizará para el primer archivo

Filtrar las archivos
filtro (cadena expresión);

expresión
expresión de filtro

Convertir ID3v2.3 etiquetas a ID3v2.4
convertToId3v24 (void);

Convertir ID3v2.4 etiquetas a ID3v2.3
convertToId3v23 (void);

Devuelve verdadero si está bien.

Recibe camino of directorio
cadena getDirectoryName (void);

Devuelve la ruta absoluta del directorio.

Recibe nombre of corriente presentar
cadena getFileName (void);

Devuelve el verdadero nombre de archivo absoluto, termina con "/" si es un directorio.

Set nombre of seleccionado presentar
setFileName (cadena nombre );

nombre
nombre de archivo

El archivo cambiará de nombre cuando se guarde el directorio.

Set formato a utilizan el cuando pólipo las nombre de archivo en las etiquetas
setFileNameFormat (cadena formato);

formato
formato de nombre de archivo

Set las presentar nombres of las seleccionado archivos en las etiquetas
setFileNameFromTag (int32 etiquetaMáscara);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

Recibe propuesta de of marco
cadena getFrame (int32 etiquetaMáscara, cadena nombre );

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

nombre
nombre del fotograma (por ejemplo, "artista")

Para obtener datos binarios como una imagen, el nombre de un archivo para escribir se puede agregar después de la
nombre , por ejemplo, "Imagen: / ruta / a / archivo". De la misma manera, las letras sincronizadas pueden ser
exportado, por ejemplo, "SYLT: / ruta / a / archivo".

Devuelve el valor del marco.

Set propuesta de of marco
booleano setFrame (int32 etiquetaMáscara, cadena nombre , cadena propuesta de);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

nombre
nombre del fotograma (por ejemplo, "artista")

propuesta de
valor del marco

Para la etiqueta 2 (etiquetaMáscara 2), si no hay marco con nombre existe, se agrega un nuevo marco, si propuesta de is
vacío, el marco se elimina. Para agregar datos binarios como una imagen, se puede agregar un archivo
después de la nombre , por ejemplo, "Imagen: / ruta / a / archivo". "SYLT: / ruta / a / archivo" se puede utilizar para
importar letras sincronizadas.

Devuelve verdadero si está bien.

Recibe todos marcos of a etiqueta
matriz of cadena getTag (int32 etiquetaMáscara);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

Devuelve una lista con valores y nombres de fotogramas alternos.

Recibe técnico información Sobre Nosotros presentar
matriz of cadena getInformation (vacío);

Las propiedades son formato, tasa de bits, frecuencia de muestreo, canales, duración, modo de canal, VBR, etiqueta
1, etiqueta 2. Se omiten las propiedades que no están disponibles.

Devuelve una lista con valores y nombres de propiedad alternos.

Set etiqueta en presentar nombre
setTagFromFileName (int32 etiquetaMáscara);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

Set etiqueta en otros etiqueta
setTagFromOtherTag (int32 etiquetaMáscara);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

Copiar etiqueta
copyTag (int32 etiquetaMáscara);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

Pasta etiqueta
pasteTag (int32 etiquetaMáscara);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

Eliminar etiqueta
removeTag (int32 etiquetaMáscara);

etiquetaMáscara
bit de etiqueta (1 para etiqueta 1, 2 para etiqueta 2)

Reanalizar las configuración
reparseConfiguration (vacío);

Los cambios de configuración automatizados son posibles modificando el archivo de configuración y
luego repasando la configuración.

Obras de teatro las seleccionado archivos
playAudio (vacío);

QML INTERFAZ

QML Ejemplos
Los scripts QML se pueden invocar a través del menú contextual de la lista de archivos y se pueden configurar en la pestaña
Acciones de usuario del cuadro de diálogo de configuración. Los scripts que se establecen allí se pueden utilizar como
ejemplos para programar scripts personalizados. QML usa JavaScript, aquí está el obligatorio "Hola
Mundo":

importar Kid3 1.0

Guión para niños {
en Ejecutar: {
console.log ("Hola mundo, el directorio es", app.dirName)
Qt. Salir ()
}
}

Si este script se guarda como /path/to/Example.qml, el comando de usuario se puede definir como @qml
/ruta/a/Ejemplo.qml con nombre QML Probar y Salida comprobada. Luego se puede comenzar a usar
el elemento Prueba QML en el menú contextual de la lista de archivos, y la salida será visible en el
ventana.

Alternativamente, el script también podría iniciarse independientemente de Kid3 usando las herramientas QML.

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

Para Qt 5, los 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

puede ser usado. En Windows y OS X, la ruta de importación debe adaptarse a la carpeta de importaciones
dentro del directorio de instalación. Los scripts iniciados fuera de Kid3 usarán el actual
directorio, por lo que debe cambiarse de antemano.

Para enumerar los títulos en las etiquetas 2 de todos los archivos en el directorio actual, lo siguiente
El script podría usarse:

importar Kid3 1.0

Guión para niños {
en Ejecutar: {
app.firstFile ()
hacer {
si (app.selectionInfo.tagFormatV2)
console.log (app.getFrame (tagv2, "título"))
} while (app.nextFile ())
}
}

Si el directorio contiene muchos archivos, tal secuencia de comandos podría bloquear la interfaz de usuario para
a veces. Para operaciones más largas, por lo tanto, debe tomarse un descanso de vez en cuando. los
La implementación alternativa a continuación tiene el trabajo de un solo archivo trasladado a una función.
Esta función se invoca a sí misma con un tiempo de espera de 1 ms al final, dado que hay más archivos
para ser procesado. Esto garantizará que la GUI siga respondiendo mientras se ejecuta el script.
funcionando.

importar Kid3 1.0

Guión para niños {
en Ejecutar: {
function doWork () {
si (aplicación.selectionInfo.tagFormatV2) {
console.log (app.getFrame (tagv2, "título"))
}
if (! app.nextFile ()) {
Qt. Salir ()
} Else {
setTimeout (doWork, 1)
}
}

app.firstFile ()
hacer trabajo()
}
}

Más scripts de ejemplo vienen con Kid3 y ya están registrados como comandos de usuario.

· ReplayGain a SoundCheck (ReplayGain2SoundCheck.qml): crea iTunNORM SoundCheck
información de los fotogramas de ganancia de reproducción.

· Cambiar el tamaño de la carátula del álbum (ResizeAlbumArt.qml): Cambie el tamaño de las imágenes de carátula incrustadas que son
más grande que 500x500 píxeles.

· Extraer la carátula del álbum (ExtractAlbumArt.qml): extrae todas las imágenes de carátula incrustadas
evitando duplicados.

· Incrustar la carátula del álbum (EmbedAlbumArt.qml): incrustar la carátula que se encuentra en los archivos de imagen en el audio
archivos en la misma carpeta.

· Insertar letras (EmbedLyrics.qml): recupera letras no sincronizadas del servicio web.

· Codificación de texto ID3v1 (ShowTextEncodingV1.qml): ayuda a encontrar la codificación de las etiquetas ID3v1
mostrando las etiquetas del archivo actual en todas las codificaciones de caracteres disponibles.

· Exportar CSV (ExportCsv.qml): exporta de forma recursiva todas las etiquetas de todos los archivos a un archivo CSV.

· Consola QML (QmlConsole.qml): Consola simple para jugar con la API QML de Kid3.

QML API
La API se puede explorar fácilmente utilizando la consola QML, que está disponible como ejemplo.
script con una interfaz de usuario.

Kid3Script
Kid3Script es un componente QML normal ubicado dentro del directorio de complementos. Tú podrías
utilice otro componente QML también. El uso de Kid3Script facilita el inicio
función de script usando el en Ejecutar manejador de señales. También oculta las diferencias entre
las versiones QtQuick, para que los scripts sean compatibles con Qt 4 y Qt 5.
Además ofrece algunas funciones:

onRun: controlador de señales que se invoca cuando se inicia el script
tagv1, tagv2, tagv2v1: constantes para parámetros de etiqueta
script: acceso a funciones de scripting
configs: acceso a los objetos de configuración
getArguments (): Lista de argumentos del script
isStandalone (): verdadero si el script no se inició desde Kid3
setTimeout (devolución de llamada, retraso): inicia la devolución de llamada después de un retraso de ms

scripting Clave
Como JavaScript y, por lo tanto, QML también tiene solo un conjunto limitado de funciones para la creación de scripts,
las guión El objeto tiene algunos métodos adicionales, por ejemplo:

script.properties (obj): Cadena con propiedades Qt
script.writeFile (filePath, data): escribe datos en el archivo, verdadero si está bien
script.readFile (filePath): leer datos del archivo
script.removeFile (filePath): Eliminar archivo, verdadero si está bien
script.fileExists (filePath): verdadero si el archivo existe
script.renameFile (oldName, newName): cambiar el nombre del archivo, verdadero si está bien
script.tempPath (): ruta al directorio temporal
script.listDir (ruta, [nameFilters], [classify]): Lista de entradas del directorio
script.system (programa, [args], [msecs]): inicia sincrónicamente un comando del sistema,
[código de salida, salida estándar, error estándar] si no se agotó el tiempo de espera
script.getEnv (varName): Obtiene el valor de la variable de entorno
script.setEnv (varName, value): establece el valor de la variable de entorno
script.getQtVersion (): cadena de versión Qt, por ejemplo, "5.4.1"
script.getDataMd5 (data): Obtiene la cadena hexadecimal del hash MD5 de los datos
script.getDataSize (datos): obtiene el tamaño de la matriz de bytes
script.dataToImage (datos, [formato]): crea una imagen a partir de bytes de datos
script.dataFromImage (img, [formato]): obtiene bytes de datos de la imagen
script.loadImage (filePath): carga una imagen desde un archivo
script.saveImage (img, filePath, [formato]): guarda una imagen en un archivo, verdadero si está bien
script.imageProperties (img): Obtiene las propiedades de una imagen, mapa que contiene
"ancho", "alto", "profundidad" y "colorCount", vacíos si la imagen no es válida
script.scaleImage (img, ancho, [alto]): escala una imagen, devuelve una imagen escalada
script.selectFileName (título, directorio, filtro, saveFile): Abrir diálogo de archivo para
seleccione un archivo

Aplicación Contexto
Con QML, se puede acceder a una gran parte de las funciones de Kid3. La API es similar a
el utilizado para D-Bus. Para obtener más información, consulte las notas respectivas.

app.openDirectory (ruta): directorio abierto
app.saveDirectory (): Guardar directorio
app.revertFileModifications (): Revertir
app.importTags (etiqueta, ruta, fmtIdx): archivo de importación
app.downloadImage (url, allFilesInDir): Descargar imagen
app.exportTags (etiqueta, ruta, fmtIdx): archivo de exportación
app.writePlaylist (): escribir lista de reproducción
app.selectAllFiles (): Seleccionar todo
app.deselectAllFiles (): Deseleccionar
app.firstFile ([seleccionar]): al primer archivo
app.nextFile ([seleccionar]): al siguiente archivo
app.previousFile ([seleccionar]): al archivo anterior
app.selectCurrentFile ([select]): selecciona el archivo actual
app.requestExpandFileList (): Expandir todo
app.applyFilenameFormat (): Aplicar formato de nombre de archivo
app.applyTagFormat (): Aplicar formato de etiqueta
app.applyTextEncoding (): aplicar codificación de texto
app.numberTracks (nr, total, tag, [options]): número de pistas
app.applyFilter (expr): Filtro
app.convertToId3v23 (): convierte ID3v2.4.0 a ID3v2.3.0
app.convertToId3v24 (): convierte ID3v2.3.0 a ID3v2.4.0
app.getFilenameFromTags (etiqueta): nombre de archivo de las etiquetas
app.getTagsFromFilename (etiqueta): nombre de archivo a las etiquetas
app.getAllFrames (etiqueta): Obtiene el objeto con todos los marcos
app.getFrame (etiqueta, nombre): Obtener marco
app.setFrame (etiqueta, nombre, valor): Establecer marco
app.getPictureData (): obtiene datos del marco de imagen
app.setPictureData (data): establece los datos en el marco de la imagen
app.copyToOtherTag (etiqueta): Etiquetas a otras etiquetas
app.copyTags (etiqueta): Copiar
app.pasteTags (etiqueta): Pegar
app.removeTags (etiqueta): Eliminar
app.playAudio (): Reproducir
app.readConfig (): Leer configuración
app.applyChangedConfiguration (): Aplicar configuración
app.dirName: nombre del directorio
app.selectionInfo.fileName: nombre de archivo
app.selectionInfo.filePath: ruta de archivo absoluta
app.selectionInfo.detailInfo: Detalles de formato
app.selectionInfo.tagFormatV1: formato de etiqueta 1
app.selectionInfo.tagFormatV2: formato de etiqueta 2
app.selectionInfo.formatString (etiqueta, formato): códigos sustitutos en cadena de formato

Para operaciones asincrónicas, las devoluciones de llamada se pueden conectar a las señales.

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

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

Configuración Objetos
Las diferentes secciones de configuración son accesibles a través de métodos de configs. Su
las propiedades se pueden listar en la consola QML.

script.properties (configs.networkConfig ())

Las propiedades se pueden configurar:

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 en línea usando los servicios de onworks.net