# Manual de &haruna;

George Florea Bănuș georgefb899@gmail.com
2019-2022 George Florea Bănuș
&CCBYSA4Notice;
2022-08-17
Haruna 0.9.0

Haruna es un reproductor multimedia de código abierto creado con Qt/QML y libmpv.

Haruna KDE kdemultimedia vídeo película

## Preferencias

Explica algunas de las preferencias más complejas de Haruna.

###

### General

#### Ubicación del diálogo de archivos

La carpeta que se abrirá en el diálogo de archivos cuando se use para abrir un archivo. Si está vacío se recordará la carpeta desde donde se abrió el último archivo.

#### Número máximo de archivos recientes

Número de archivos recientes que se deben guardar y mostrar en el menú de archivos recientes.

#### Recordar el tamaño y la posición de la ventana

Restaura el tamaño y la posición que tenía la ventana cuando se cerró. En Wayland solo se restaura el tamaño.

#### Tema de iconos Brisa

Si está marcada, la aplicación usa el tema de iconos Brisa.

Si no está marcada, la aplicación usa el tema de iconos del sistema. No siempre funciona como se espera.

#### Estilo de la interfaz de usuario

Permite cambiar el estilo de los controles de Qt Quick (botones, casillas, etc.) a los estilos disponibles en el sistema.

### Reproducción

#### Pasos de avance

Cuánto se debe avanzar cuando se lleva a cabo la acción correspondiente. El modo de avance es exacto https://mpv.io/manual/stable/#command-interface-seek-<target>-[<flags>].

#### Abrir el último archivo reproducido durante el inicio

Al iniciar, abre el archivo que se estaba reproduciendo la última vez que se cerró la aplicación.

#### Avanzar hasta la última posición de reproducción

Al abrir un archivo que se ha reproducido con anterioridad, se avanzará hasta la posición en la que se detuvo la reproducción.

#### Empezar la reproducción

Esto se aplica solo cuando se reanuda la reproducción (avanzando hasta la última posición de reproducción) de un archivo que se ha reproducido con anterioridad.

#### Pausar al minimizar

Pausa el reproductor cuando la ventana está minimizada. La reproducción continúa cuando se restaura la ventana.

#### Descodificación por hardware

Si activa la descodificación por hardware, se recomienda que use las opciones automáticas de seguridad o las opciones automáticas.

Puede leer más sobre cada opción aquí: https://mpv.io/manual/stable/#options-hwdec.

Si quiere usar «vaapi» en X11, debe establecer la variable de entorno QT_XCB_GL_INTEGRATION a xcb_egl.

#### Recordar la posición del tiempo

Determina si se debe guardar y restaurar la posición de los archivos reproducidos con anterioridad.

El primer campo controla para qué archivos se debe guardar la posición:

- -1: la funcionalidad está desactivada

- 0: guardar para todos los archivos

- 1-9999: guardar para los archivos mayores que el valor definido, en minutos

El segundo campo controla la frecuencia con la que se debe guardar la posición.

#### Omitir capítulos

Cuando está activada, se omitirán automáticamente los capítulos que contengan ciertas palabras o caracteres.

Las palabras o caracteres que se deben omitir se definen como una cadena de textos separados por comas.

La coincidencia no es exacta, lo que significa que ap coincidirá con palabras que la contengan, como apertura.

#### Selección de formato de youtube-dl

Haruna usa «youtube-dl» para reproducir vídeos en línea. Algunos sitios ofrecen varias versiones del vídeo/sonido (diferentes códecs, resolución). Esta preferencia le permite configurar la versión del vídeo/sonido que selecciona «youtube-dl». Dispone de más información en: https://github.com/ytdl-org/youtube-dl/blob/master/README.md#format-selection.

### Vídeo

#### Plantilla de captura de pantalla

https://mpv.io/manual/stable/#screenshot

Indique la plantilla de nombre de archivo que se usará para guardar las capturas de pantalla. La plantilla especifica el nombre del archivo sin la extensión y puede contener especificadores de formato, que se sustituirán al realizar una captura de pantalla. De forma predeterminada, la plantilla es «mpv-shot%n», que da como resultado nombres de archivo similares a «mpv-shot0012.png», por ejemplo.

La plantilla puede comenzar con una ruta relativa o absoluta para especificar la ubicación de directorio donde se deben guardar las capturas de pantalla.

Si el nombre de archivo final de la captura de pantalla apunta a un archivo ya existente, dicho archivo no se sobrescribirá. La captura de pantalla no se guardará o, si la plantilla contiene %n, se guardará con un nombre de archivo diferente recién generado.

Especificadores de formato permitidos:

- %[#][0X]n

  Un número de secuencia, con ceros al principio hasta la longitud X (por omisión es 04). Por ejemplo, pasando el formato «%04n» producirá «0012» para la duodécima captura de pantalla. El número se incrementa cada vez que se realiza una captura de pantalla o si el archivo existe. La longitud X debe estar en el intervalo 0-9. Con el signo # opcional, mpv usará el número disponible más bajo. por ejemplo, si hace tres capturas de pantalla (0001, 0002 y 0003) y borra las dos primeras, las dos siguientes capturas de pantalla no serán 0004 y 0005, sino 0001 y 0002 de nuevo.

- %f

  Nombre de archivo del vídeo reproducido actualmente.

- %F

  Lo mismo que %f, pero eliminando la extensión del archivo (incluido el punto).

- %x

  Ruta del directorio del vídeo reproducido actualmente. Si el vídeo no está en el sistema de archivos (sino, por ejemplo, en la web), esto se expande a un texto vacío.

- %X{fallback}

  Lo mismo que %x, pero si el archivo de vídeo no está en el sistema de archivos, devuelve la cadena de texto alternativa dentro del {...}.

- %p

  Tiempo de reproducción actual, en el mismo formato que se usa en el OSD. El resultado es una cadena con la forma «HH:MM:SS». Por ejemplo, si el vídeo está en la posición de tiempo de 5 minutos y 34 segundos, %p se sustituirá con «00:05:34».

- %P

  Similar a %p, pero extendida con el tiempo de reproducción en milisegundos. Está formateada como «HH:MM:SS.mmm», siendo «mmm» la parte de los milisegundos del tiempo de reproducción.

  Nota

  Esta es una forma sencilla de obtener marcas de tiempo únicas por fotograma. (Los números de fotograma serían más intuitivos, pero no se pueden implementar fácilmente porque los formatos de contenedor suelen usar las marcas de tiempo para identificar fotogramas).

- %wX

  Indique el tiempo de reproducción actual usando el formato de cadena X. %p es como %wH:%wM:%wS, y %P es como %wH:%wM:%wS.%wT.

  Especificadores de formato válidos:

  - %wH

    hora (rellenada con 0 a dos dígitos)

  - %wh

    hora (sin relleno)

  - %wM

    minutos (00-59)

  - %wm

    minutos totales (include horas, al contrario que %wM)

  - %wS

    segundos (00-59)

  - %ws

    segundos totales (incluye horas y minutos)

  - %wf

    como %ws, pero en coma flotante

  - %wT

    milisegundos (000-999)

- %tX

  Especifica la fecha/hora local actual usando el formato X. Este especificador de formato usa internamente la función strftime() de UNIX e inserta el resultado de pasar «%X» a strftime. Por ejemplo, %tm insertará el número del mes actual como un número. Tendrá que usar varios especificadores %tX para construir una cadena de fecha/hora completa.

- %{prop[:texto alternativo]}

  Inserta el valor de la propiedad de entrada «prop». Por ejemplo, %{filename} es lo mismo que %f. Si la propiedad no existe o no está disponible, se inserta un texto de error, a menos que se especifique un texto alternativo.

- %%

  Se sustituye con el propio carácter %.

### Órdenes personalizadas

#### Orden

La orden de mpv que se debe ejecutar. Consulte las Órdenes de MPV para ver una lista de las órdenes disponibles.

No funcionarán todas las órdenes, ya que algunas son específicas de mpv.

Las más útiles son las órdenes para manejar las propiedades, como «set», «add» y «cycle».

set: define el valor de una propiedad `set volume-max 150`.

add: aumenta o disminuye el valor de una propiedad `add volume 15`, aumenta el volumen en 15. Para disminuir el valor, use `add volume -15`.

cycle: recorrer los valores de una propiedad `cycle aid up`.

#### Mensaje OSD

Un mensaje OSD que se muestra al ejecutar una orden personalizada de tipo acción.

Use ${nombre_propiedad} para mostrar el valor de una propiedad. Volumen: ${volume}.

#### Acceso rápido del teclado

La orden se lanzará mediante un acceso rápido de teclado. El acceso rápido se puede usar tras guardarlo.

#### Ejecutar durante el inicio

La orden se ejecutará durante el inicio de la aplicación. Las órdenes de inicio se pueden conmutar, lo que significa que puede escoger si se definen durante el inicio o no. Esto está disponible tras guardar.

## Créditos y licencia

&haruna;

Copyright del programa 2019-2021 George Florea Bănuș

Colaboradores:

- George Florea Bănuș georgefb899@gmail.com

Copyright de la documentación © 2019-2021 George Florea Bănuș georgefb899@gmail.com

Traducido por Eloy Cuadra ecuadra@eloihr.net.

&underCCBYSA4; &underGPL;