# El manual de l'&haruna;

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

L'Haruna és un reproductor multimèdia de codi obert construït amb Qt/QML i la «libmpv».

Haruna KDE kdemultimedia vídeo pel·lícula

## Configuració

Explica alguna de les opcions més complexes de l'Haruna.

###

### General

#### Ubicació en el diàleg de fitxers

La carpeta que el diàleg de fitxers carregarà quan s'utilitzi per a obrir un fitxer. Si està buida, recordarà l'última carpeta des de la qual s'ha obert un fitxer.

#### Nombre màxim de fitxers recents

Quants fitxers recents s'han de desar i mostrar al menú de fitxers recents.

#### Recorda la mida i la posició de la finestra

Restaura la mida i la posició de la finestra quan es va tancar. En el Wayland només es restaura la mida.

#### Tema d'icones Brisa

Quan està marcada, l'aplicació utilitza el tema d'icones Brisa.

Quan no està marcada, l'aplicació utilitza el tema d'icones del sistema. No sempre funciona com s'espera.

#### Estil de la IGU

Permet canviar l'estil dels Qt Quick Controls (botons, caselles de selecció, etc.), als estils disponibles al sistema.

### Reproducció

#### Passos de cerca

Quant s'ha de cercar quan s'activa l'acció corresponent. El mode de cerca és exact https://mpv.io/manual/stable/#command-interface-seek-<target>-[<flags>].

#### Obre el darrer fitxer reproduït en iniciar

En iniciar, obre el fitxer que s'estava reproduint quan es va tancar l'aplicació.

#### Ves a la darrera posició de reproducció

Quan s'obri un fitxer que s'ha reproduït abans, es tornarà a la posició en què es trobava quan s'aturà la reproducció.

#### Inicia la reproducció

Això només s'aplica quan es reprèn la reproducció (se cerca l'última posició de reproducció) d'un fitxer que s'ha reproduït abans.

#### En minimitzar fes pausa

Posa en pausa el reproductor mentre es minimitza la finestra, quan es restauri es reprendrà la reproducció.

#### Descodificació per maquinari

Si activeu la descodificació per maquinari, es recomana utilitzar les opcions «auto-safe» o «auto».

Podeu llegir més sobre cada opció aquí: https://mpv.io/manual/stable/#options-hwdec.

Si voleu utilitzar «vaapi» a l'X11, heu d'establir la variable d'entorn QT_XCB_GL_INTEGRATION a xcb_egl.

#### Recorda la posició del temps

Determina quan desar i restaurar la posició dels fitxers reproduïts anteriorment.

El primer camp controla per a quins fitxers desar la posició:

- -1: la característica està desactivada

- 0: desa per a tots els fitxers

- 1-9999: desa per als fitxers més llargs que el valor establert, en minuts

El segon camp controla amb quina freqüència es desarà la posició.

#### Omet els capítols

Quan està activat, s'ometen automàticament els capítols que contenen certes paraules/caràcters.

Les paraules/caràcters a ometre es defineixen com una cadena separada per comes.

La coincidència no és exacta, el que significa que ob coincidirà amb paraules que la continguin com obrint.

#### Selecció del format Youtube-dl

L'Haruna utilitza «youtube-dl» per reproduir vídeos en línia. Alguns llocs ofereixen diverses versions de vídeo/àudio (còdecs diferents, resolució). Aquest paràmetre permet configurar quina versió de vídeo/àudio selecciona «youtube-dl». Més informació: 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

Especifiqueu la plantilla de nom de fitxer utilitzada per a desar captures de pantalla. La plantilla especifica el nom de fitxer sense extensió de fitxer, i pot contenir especificadors de format, els quals seran substituïts quan es faci una captura de pantalla. De manera predeterminada, la plantilla és «mpv-shot%n», el qual resulta en noms de fitxer com «mpv-shot0012.png», per exemple.

La plantilla pot començar per un camí relatiu o absolut, per tal d'especificar una ubicació del directori on s'han de desar les captures de pantalla.

Si el nom de fitxer final de captura de pantalla apunta a un fitxer ja existent, el fitxer no se sobreescriurà. La captura de pantalla no es desarà, o si la plantilla conté %n, es desarà usant un nom de fitxer diferent generat nou.

Especificadors de format permesos:

- %[#][0X]n

  Un número de seqüència, emplenat amb zeros a la longitud X (per defecte: 04). Per exemple, si passeu el format %04n, obtindreu 0012 a la 12a captura de pantalla. El número s'incrementa cada vegada que es fa una captura de pantalla o si el fitxer ja existeix. La longitud X ha d'estar en l'interval 0-9. Amb el signe # opcional, el «mpv» utilitzarà el número més baix disponible. Per exemple, si es prenen tres captures de pantalla (0001, 0002, 0003) i se suprimeixen les dues primeres, les dues pròximes captures de pantalla no seran 0004 i 0005, sinó 0001 i 0002 una altra vegada.

- %f

  Nom del fitxer del vídeo que s'està reproduint.

- %F

  Igual que %f, però elimina l'extensió del fitxer, inclòs el punt.

- %x

  Camí del directori del vídeo que s'està reproduint. Si el vídeo no és al sistema de fitxers (però, per exemple, http://), això s'expandeix a una cadena buida.

- %X{alternativa}

  Igual que %x, però si el fitxer de vídeo no és al sistema de fitxers, retorna la cadena alternativa dins de {...}.

- %p

  Temps de reproducció actual, en el mateix format que s'utilitza a l'OSD. El resultat és una cadena de la forma «HH:MM:SS». Per exemple, si el vídeo es troba a la posició de temps de 5 minuts i 34 segons, %p serà substituït per «00:05:34».

- %P

  Similar a %p, però ampliat amb el temps de reproducció en mil·lisegons. Es dona format com a «HH:MM:SS.mmm», amb «mmm» sent els mil·lisegons del temps de reproducció.

  Nota

  Aquesta és una manera senzilla d'obtenir marques horàries úniques per fotograma. (Els nombres de fotograma serien més intuïtius, però no es poden implementar fàcilment perquè els formats de contenidors solen utilitzar marques horàries per identificar fotogrames)

- %wX

  Especifica l'hora de reproducció actual utilitzant la cadena de format X. %p és com %wH:%wM:%wS, i %P és com %wH:%wM:%wS.%wT.

  Especificadors de format vàlids:

  - %wH

    hora (omplerta amb 0 fins a dos dígits)

  - %wh

    hora (sense omplir)

  - %wM

    minuts (00-59)

  - %wm

    minuts totals (inclou hores, a dunlike %wM)

  - %wS

    segons (00-59)

  - %ws

    segons totals (inclou hores i minuts)

  - %wf

    com %ws, però com a flotant

  - %wT

    mil·lisegons (000-999)

- %tX

  Especifica la data/hora local actual utilitzant el format X. Aquest especificador de format utilitza internament la funció strftime() d'UNIX, i insereix el resultat de passar «%X» a strftime. Per exemple, %tm inserirà el número del mes actual com a número. Heu d'utilitzar múltiples especificadors %tX per a construir una cadena de data/hora completa.

- %{prop[:text alternatiu]}

  Insereix el valor de la propietat d'entrada «prop». P. ex., %{filename} és el mateix que %f. Si la propietat no existeix o no està disponible, s'inserirà un text d'error, llevat que s'especifiqui una alternativa.

- %%

  Substitut pel mateix caràcter %.

### Ordres personalitzades

#### Ordre

Quina ordre «mpv» executar, vegeu les Ordres de l'MPV per a una llista d'ordres disponibles.

No totes les ordres funcionaran, ja que algunes són específiques de l'«mpv».

El més útil són les ordres per manipular propietats, com «set», «add», «cycle».

set: estableix el valor d'una propietat `set volume-max 150`.

add: augmenta/disminueix el valor d'una propietat `add volum 15`, augmenta el volum en 15. Per reduir el valor, utilitzeu `add volum -15`.

cycle: circula a través dels valors d'una propietat `cycle aid up`.

#### Missatge OSD

Un missatge OSD a mostrar quan s'activa una ordre personalitzada de tipus d'acció.

Utilitzeu ${property_name} per mostrar el valor d'una propietat Volum: ${volume}.

#### Drecera de teclat

L'ordre s'activarà amb una drecera. La drecera es pot establir després de desar.

#### Executa a l'inici

L'ordre s'executarà en iniciar l'aplicació. Les ordres d'inici es poden commutar, el qual vol dir que podreu triar si s'estableixen o no en iniciar, això estarà disponible després de desar.

## Crèdits i llicència

&haruna;

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

Col·laboradors:

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

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

Traductor de la documentació: &credits.JosepMa.Ferrer;

&underCCBYSA4; &underGPL;