Provided by: mkvtoolnix_8.8.0-1_amd64 bug

NOMBRE

       mkvpropedit - Modifica las propiedades existentes en archivos Matroska(TM) sin multiplexar

SINOPSIS

       mkvpropedit [opciones] {archivo-origen} {acciones}

DESCRIPCIÓN

       Este programa analiza un archivo Matroska(TM) y modifica alguna de sus propiedades.
       Entonces escribe estas modificaciones en el archivo existente. Entre las propiedades que
       pueden ser modificadas están los elementos de la información del segmento (p.e. el título)
       y los encabezados de pista (p.e. el código del idioma, el flag de 'pista predefinida' o el
       nombre).

       Opciones:

       -l, --list-property-names
           Enumera todos los conocidos y editables nombres, su tipo (texto, entero, booleano,
           etc...) y una pequeña descripción. El programa después sale. Por lo tanto, el
           parámetro nombre-archivo no tiene que ser suministrado.

       -p, --parse-mode modo
           Establece el modo de análisis. El parámetro 'modo' puede ser 'fast' (que es el
           predeterminado) o 'full'. El modo 'fast' no analiza el archivo entero pero usa los
           elementos de meta búsqueda para localizar los elementos necesarios del archivo
           original. En el 99% de los casos es suficiente. Sin embargo, para archivos que no
           contienen elementos de meta búsqueda o que están dañados, el usuario debería de usar
           el modo de análisis 'full'. Un análisis completo de un archivo puede llevar bastantes
           minutos mientras que un análisis rápido sólo lleva unos segundos.

       Acciones que tienen que ver con las propiedades de información de la pista y segmento:

       -e, --edit selector
           Establece la sección del archivo Matroska(TM) (información del segmento o ciertos
           encabezados de pista) sobre la que se centrarán todas las acciones: add, set y delete.
           Esta opción puede ser múltiples veces de manera que puede ser modificado más de un
           elemento a la vez.

           Por defecto, mkvpropedit(1) editará la sección de información del segmento.

           Mire la sección sobre selectores de edición para una completa descripción de la
           sintaxis.

       -a, --add name=valor
           Añade una propiedad name con el contenido de valor. Esta propiedad será añadida
           incluso si dicha propiedad ya existe. Tenga en cuenta que la mayoría de propiedades
           son únicas y sólo existe una instancia de ellas.

       -s, --set name=valor
           Establece todas las instancias de la propiedad name con el contenido valor. Si no
           existe dicha propiedad entonces será añadida.

       -d, --delete nombre
           Borra todas las instancias de la propiedad name. Tenga en cuenta que algunas
           propiedades son necesarias y no pueden ser eliminadas.

       Acciones que tienen que ver con las etiquetas y capítulos:

       -t, --tags selector:nombre
           Reemplaza o añade las etiquetas del archivo llamado nombre o las elimina si nombre
           está vacío.  mkvpropedit(1) lee el mismo formato de etiquetas XML que mkvmerge(1)
           también puede leer.

           El selector debe ser una de estas palabras: all, global o track. Para all,
           mkvpropedit(1) reemplazará o eliminará todas las etiquetas del archivo. Con global
           sólo las etiquetas globales serán reemplazadas o eliminadas. Por ejemplo: mkvpropedit
           "nombre-archivo.mkv" --tags global:etiquetas.xmlmkvpropedit "nombre-archivo.mkv"
           --tags global:

           Con track, mkvpropedit(1) reemplazará las etiquetas de la pista especificada. Además,
           las etiquetas leídas desde nombre serán asignadas a la misma pista. La pista se
           especifica de la misma manera que con los selectores de edición (mire abajo). Por
           ejemplo: mkvpropedit "nombre-archivo.mkv" --tags track:a1:nuevas-etiquetas-audio.xml.

       --add-track-statistics-tags
           Calculates statistics for all tracks in a file and adds new statistics tags for them.
           If the file already contains such tags then they'll be updated.

       --delete-track-statistics-tags
           Deletes all existing track statistics tags from a file. If the file doesn't contain
           track statistics tags then it won't be modified.

       -c, --chapters nombre
           Reemplaza o añade los capítulos del archivo llamado nombre o las elimina si nombre
           está vacío.  mkvpropedit(1) lee el mismo formato de capítulos simple y XML que
           mkvmerge(1) también puede leer.

       Acciones para manipular adjuntos:

       --add-attachment nombre-archivo
           Añade un nuevo adjunto a nombre-archivo.

           Si la opción --attachment-name es usada antes de esta opción entonces su valor es
           usado como el nuevo nombre del adjunto. Por el contrario, se deriva del
           nombre-archivo.

           Si la opción --attachment-mime-type es usada antes de esta opción entonces su valor es
           usado como el nuevo tipo MIME del adjunto. Por el contrario, es auto-detectado a
           partir del contenido del nombre-archivo.

           Si la opción --attachment-description es usada antes de esta opción entonces su valor
           es usado como la nueva descripción del adjunto. Por el contrario, ninguna descripción
           será establecida.

           If the option --attachment-uid has been used prior to this option then its value is
           used as the new attachment's UID. Otherwise a random UID will be generated
           automatically.

       --replace-attachment selector:nombrearchivo
           Reemplaza uno o más adjuntos que coincidan con el selector del archivo nombre-archivo.
           Si más de un adjunto existente coincide con el selector entonces todo su contenido
           será reemplazado por el contenido del nombre-archivo.

           El selector puede tener una de estas cuatro formas: ID, UID, Name y MIME type. Están
           explicadas más abajo en la sección selectores de adjuntos.

           If the option --attachment-name has been used prior to this option then its value is
           set as the new name for each modified attachment. Otherwise the names aren't changed.

           If the option --attachment-mime-type has been used prior to this option then its value
           is set as the new MIME type for each modified attachment. Otherwise the MIME types
           aren't changed.

           If the option --attachment-description has been used prior to this option then its
           value is set as the new description for each modified attachment. Otherwise the
           descriptions aren't changed.

           If the option --attachment-uid has been used prior to this option then its value is
           set as the new UID for each modified attachment. Otherwise the UIDs aren't changed.

       --update-attachment selector
           Sets the properties of one or more attachments that match selector. If more than one
           existing attachment matches selector then all of their properties will be updated.

           El selector puede tener una de estas cuatro formas: ID, UID, Name y MIME type. Están
           explicadas más abajo en la sección selectores de adjuntos.

           If the option --attachment-name has been used prior to this option then its value is
           set as the new name for each modified attachment. Otherwise the names aren't changed.

           If the option --attachment-mime-type has been used prior to this option then its value
           is set as the new MIME type for each modified attachment. Otherwise the MIME types
           aren't changed.

           If the option --attachment-description has been used prior to this option then its
           value is set as the new description for each modified attachment. Otherwise the
           descriptions aren't changed.

           If the option --attachment-uid has been used prior to this option then its value is
           set as the new UID for each modified attachment. Otherwise the UIDs aren't changed.

       --delete-attachment selector
           Elimina uno o más adjuntos que coincida con el selector.

           El selector puede tener una de estas cuatro formas: ID, UID, Name y MIME type. Están
           explicadas más abajo en la sección selectores de adjuntos.

       Opciones para acciones sobre adjuntos:

       --attachment-name nombre
           Establece el nombre a usar en la operación --add-attachment o --replace-attachment.

       --attachment-mime-type mime-type
           Establece el tipo MIME a usar en la operación --add-attachment o --replace-attachment.

       --attachment-description descripción
           Establece la descripción a usar en la operación --add-attachment o
           --replace-attachment.

       Otras opciones:

       --command-line-charset conjunto-caracteres
           Establece el conjunto de caracteres a convertir las cadenas de texto dadas desde la
           línea de comandos. Por defecto, se ajusta al conjunto de caracteres dado por la
           configuración local del sistema.

       --output-charset conjunto-caracteres
           Establece el conjunto de caracteres para convertir las cadenas de texto que serán
           usadas en el archivo de salida. Por defecto, se ajusta al conjunto de caracteres dado
           por la configuración local del sistema.

       -r, --redirect-output nombre-archivo
           Escribe todos los mensajes al archivo nombre-archivo en vez de en la consola. Aunque
           esto se puede hacer fácilmente con la opción de redirección hay casos en los que es
           necesaria esta opción: cuando el terminal reinterpreta la salida antes de escribirlo
           al archivo. El conjunto de caracteres establecido con --output-charset se respeta.

       --ui-language código
           Fuerza el uso de la traducción de un concreto código de idioma (p.e. 'es_ES' para el
           Español). Pienso que es preferible usar las variables de entorno LANG, LC_MESSAGES y
           LC_ALL. Introducir 'list' como el valor del código provocará que mkvextract(1) genere
           una lista de traducciones disponibles.

       --debug topic
           Habilita la depuración para una característica concreta. Esta opción sólo es útil para
           desarrolladores.

       --engage característica
           Habilita características experimentales. Una lista de características disponibles
           puede ser solicitada con la instrucción mkvpropedit --engage list. Estas
           características no están indicadas para ser usadas en situaciones normales.

       --gui-mode
           Habilita el modo GUI. En este modo las líneas especialmente formateadas pueden ser
           generadas para decirle a un control de la GUI lo que está pasando. Estos mensajes se
           rigen bajo el formato '#GUI#mensaje'. El mensaje puede ser continuado por pares de
           valores/claves como en '#GUI#mensaje#clave1=valor1#clave2=valor2...'. Ni los mensajes
           ni las claves pueden ser traducidas y siempre se generan en inglés.

       -v, --verbose
           Habilita el modo detallado y muestra todos los elementos Matroska(TM) importantes que
           pueden ser leídos.

       -h, --help
           Muestra información de uso y sale.

       -V, --version
           Muestra la información de la versión y sale.

       --check-for-updates
           Comprueba online si hay nuevas versiones al descargar el archivo ubicado en la URL
           http://mkvtoolnix-releases.bunkus.org/latest-release.xml. Cuatro líneas serán
           generadas del tipo clave=valor: la URL desde donde se obtuvo la información (clave
           version_check_url), la versión actual (clave running_version), la última versión
           disponible (clave available_version) y la URL de descarga (clave download_url).

           Después el programa sale con un código de salida 0 si ninguna versión nueva está
           disponible, con 1 si hay disponible una versión más actual y con 2 si ocurre algún
           error (p.e. si la información de la actualización no puede ser obtenida).

           Esta opción sólo está disponible si el programa fue creado con compatibilidad para
           libcurl.

       @archivo-opciones
           Lee argumentos adicionales de la línea de comandos desde el archivo archivo-opciones.
           Las líneas que tengan en el primer carácter una almohadilla ('#') serán tratados como
           comentarios y se ignorarán. Espacios en blanco al inicio y final de la línea serán
           descartados. Cada línea debe contener exactamente una opción.

           Diversos caracteres pueden ser interpretados como de escape, p.e. si necesitas que una
           línea, que comience con una almohadilla '#', no sea interpretada como un comentario.
           Las normas están descritas en la sección sobre caracteres de escape en texto.

           La línea de comandos 'mkvpropedit archivo.mkv --edit track:a2 --set name=Comentarios'
           puede ser convertida en un archivo de opciones del modo que se indica a continuación:

               # Modifica nombre.mkv
               nombre.mkv
               # Edita la segunda pista de audio
               --edit
               track:a2
               # y establece el título como 'Comentarios'
               --set
               name=Comments

SELECTORES DE EDICIÓN

       La opción --edit establece la sección del archivo Matroska(TM) (información del segmento o
       ciertos encabezados de pista) sobre la que se centrarán todas las acciones: add, set y
       delete. Esto es válido hasta que se encuentra el siguiente parámetro --edit. El argumento
       para esta opción se llama el selector de edición.

       Por defecto, mkvpropedit(1) editará la sección de información del segmento.

   Información del segmento
       La información del segmento puede ser seleccionada con una de estas tres palabras: 'info',
       'segment_info' o 'segmentinfo'. Contiene propiedades como el título o el UID del segmento
       .

   Encabezados de pista
       Los encabezados de la pista pueden ser seleccionados con un selector ligeramente más
       complejo. Todas las variantes comienzan con 'track:'. Las propiedades del encabezado de
       pista incluye elementos como el código de idioma, el flag de 'pista predefinida' o el
       nombre de la pista.

       track:n
           Si el parámetro n es un número entonces la pista con número n será seleccionada. El
           orden de pista es el mismo que se genera con la opción --identify de mkvmerge(1).

           La numeración empieza en 1.

       track:tn
           Si el parámetro empieza con el carácter t seguido por n entonces la pista con número n
           de un tipo específico de pista será seleccionada. El parámetro del tipo de pista t
           debe ser uno de estos cuatro caracteres: 'a' para una pista de audio, 'b' para un
           pista de botón, 's' para una pista de subtítulo y 'v' para una pista de video. El
           orden de pista es el mismo que se genera con la opción --identify de mkvmerge(1).

           La numeración empieza en 1.

       track:=uid
           Si el parámetro empieza con un '=' seguido por un número de uid entonces será
           seleccionada la pista cuyo UID coincida con este uid. Los UIDs de pista puede ser
           obtenido con mkvinfo(1).

       track:@número
           Si el parámetro empieza con un '@' seguido por un número entonces será seleccionada la
           pista cuyo número de elemento coincida con este número. El número de pista puede ser
           obtenido con mkvinfo(1).

   Notas
       Debido a la naturaleza de los selectores de edición de pista es posible que actualmente
       algunos selectores coincidan con los mismos encabezados de pista. En muchos casos, todas
       las acciones para estos selectores de edición serán combinados y ejecutados en el orden en
       el que fueron dadas en la línea de comandos.

SELECTORES DE ADJUNTOS

       Un selector de adjuntos se utiliza con las dos acciones --replace-attachment y
       --delete-attachment. Puede tener una de las cuatros formas siguientes:

        1. Selección mediante el ID de adjunto. De esta forma el selector es un simple número, el
           ID del adjunto tal y como se genera con el comando de identificación de mkvmerge(1).

        2. Selección mediante el UID de adjunto (Único ID). De esta forma el selector es el signo
           igual = acompañado por un número, el UID del adjunto tal y como se genera con el
           comando de identificación detallado (verbose) de mkvmerge(1).

        3. Selección mediante el name (nombre) de adjunto. De esta forma el selector es la
           palabra literal name: seguida por el nombre del adjunto. Si el selector es usado con
           --replace-attachment entonces los dos puntos que pudiera contener el nombre deberán
           ser escapados con \c.

        4. Selección mediante el MIME type (tipo MIME). De esta forma el selector es la palabra
           mime-type: seguida por el tipo MIME del adjunto. Si el selector es usado con
           --replace-attachment entonces los dos puntos que pudiera contener el tipo MIME deberán
           ser escapados con \c.

EJEMPLOS

       El siguiente ejemplo edita un archivo llamado 'película.mkv'. Establece el título del
       segmento y modifica el código de idioma de una pista de audio y subtítulo. Tenga en cuenta
       que este ejemplo puede ser acortado al omitir la primera opción --edit ya que editar el
       elemento de información del segmento está incluido por defecto para todas las opciones
       encontradas antes de la primera opción --edit.

           mkvpropedit película.mkv --edit info --set "title=La película" --edit track:a1 --set language=spa --edit track:a2 --set language=eng

       El segundo ejemplo elimina 'flag de pista predefinida' de la primera pista de subtítulo y
       la establece para la segunda. Tenga en cuenta que mkvpropedit(1), a diferencia de
       mkvmerge(1), no establece automáticamente a '0' el valor de 'flag de pista predefinida'
       cuando otra pista se ha establecido a '1'.

           mkvpropedit película.mkv --edit track:s1 --set flag-default=0 --edit track:s2 --set flag-default=1

       Reemplaza las etiquetas para la segunda pista de subtítulos de un archivo:

           mkvpropedit película.mkv --tags track:s2:nuevas-etiquetas-subtítulo.xml

       Elimina todas las etiquetas que hay en el archivo:

           mkvpropedit película.mkv --tags all:

       Reemplaza los capítulos en un archivo:

           mkvpropedit película.mkv --chapters nuevos-capítulos.xml

       Elimina todos los capítulos del archivo:

           mkvpropedit película.mkv --chapters ""

       Añade un archivo de tipo fuente (Arial.ttf) como un adjunto:

           mkvpropedit película.mkv --add-attachment Arial.ttf

       Añade un archivo de tipo fuente (89719823.ttf) como un adjunto y proporciona información
       de como es la fuente Arial:

           mkvpropedit película.mkv --attachment-name Arial.ttf --attachment-description "La fuente Arial como TrueType"
           --attachment-mime-type application/x-truetype-font --add-attachment 89719823.ttf

       Reemplaza el archivo adjunto (Comic.ttf) del archivo por otro (Arial.ttf):

           mkvpropedit película.mkv --attachment-name Arial.ttf --attachment-description "La fuente Arial como TrueType"
           --replace-attachment name:Comic.ttf:Arial.ttf

       Elimina el segundo archivo adjunto:

           mkvpropedit película.mkv --delete-attachment 2

       Elimina todos las fuentes adjuntas por tipo MIME:

           mkvpropedit película.mkv --delete-attachment mime-type:application/x-truetype-font

CÓDIGOS DE SALIDA

       Mkvpropedit(1) finaliza con uno de estos tres códigos de salida:

       •   0 -- Este código de salida significa que la extracción se ha realizado correctamente.

       •   1 -- En este caso mkvpropedit(1) genera una salida con al menos una advertencia, pero
           la extracción continuó. Una advertencia es prefijada con el texto 'Advertencia:'.
           Dependiendo de los fallos involucrados los archivos creados serán correctos o no. El
           usuario es instado a que revise tanto las advertencias como los archivos creados.

       •   2 -- Este código de salida es usado después de que ocurra un error.  mkvpropedit(1)
           aborta el proceso justo después de mostrar el mensaje de error. El rango de los
           mensajes de error va desde los argumentos de la línea de comandos, por delante de los
           errores de lectura/escritura, hasta los archivos erróneos.

CONVERSIÓN DE ARCHIVOS DE TEXTO Y CONJUNTO DE CARACTERES

       Para una discusión en profundidad sobre como la suite de MkvToolNix manipula las
       conversiones de caracteres, la codificación entrada/salida y la codificación de la línea
       de comandos y consola, por favor consulte la sección llamada de igual manera en la pagina
       del manual para mkvmerge(1).

CARACTERES ESPECIALES DE ESCAPE EN EL TEXTO

       Hay pocos sitios en los que los caracteres especiales en el texto puedan o deban ser
       escapados. Las reglas del escape son simples: cada carácter que necesite ser escapado es
       reemplazado con una barra invertida seguida de otro carácter.

       Las reglas son: ' ' (un espacio) se convierte a '\s', '"' (doble comillas) sería '\2', ':'
       se convierte a '\c', '#' se reemplazada como '\h' y '\' (una barra invertida) se
       expresaría como '\\'.

VARIABLES DE ENTORNO

       mkvpropedit(1) usa las variables predefinidas que se determinan en la configuración local
       del sistema (p.e.  LANG y la familia LC_*). Variables adicionales:

       MKVPROPEDIT_DEBUG, MKVTOOLNIX_DEBUG and its short form MTX_DEBUG
           El contenido se trata como si se hubiese pasado a través de la opción --debug.

       MKVPROPEDIT_ENGAGE, MKVTOOLNIX_ENGAGE and its short form MTX_ENGAGE
           El contenido se trata como si se hubiese pasado a través de la opción --engage.

       MKVPROPEDIT_OPTIONS, MKVTOOLNIX_OPTIONS and its short form MTX_OPTIONS
           El contenido es dividido en espacios en blanco. Las cadenas de texto parciales
           resultantes son tratadas como si hubiesen sido pasadas como opciones a la línea de
           comandos. Si necesitas pasar caracteres especiales (p.e. espacios) entonces tienes que
           escaparlos (vea la sección caracteres especiales de escape en el texto).

VEA TAMBIÉN

       mkvmerge(1), mkvinfo(1), mkvextract(1), mkvtoolnix-gui(1)

WWW

       La última versión se puede encontrar siempre en la página de MKVToolNix[1].

AUTOR

       Moritz Bunkus <moritz@bunkus.org>
           Desarrollador

NOTAS

        1. la página de MKVToolNix
           https://mkvtoolnix.download/