# Підручник з &haruna;

George Florea Bănuș georgefb899@gmail.com
2019-2022 George Florea Bănuș
&CCBYSA4Notice;
17 серпня 2022 року
Haruna 0.9.0

Haruna — мультимедійний програвач із відкритим кодом, який побудовано на основі Qt/QML і libmpv.

Haruna KDE kdemultimedia відео фільм

## Параметри

Пояснення щодо деяких складніших параметрів Haruna.

###

### Загальне

#### Місце для вікна роботи з файлами

Тека, яку буде завантажено до діалогового вікна роботи з файлами для відкриття файла. Якщо має порожнє значення, програма запам'ятає останню теку, з якої було відкрито файл.

#### Максимальна кількість нещодавніх файлів

Кількість нещодавніх файлів, записи яких буде збережено і показано у меню нещодавніх файлів.

#### Запам'ятати останній розмір вікна і його позицію

Відновлює розмір і розташування вікна, яке воно мало під час закриття. У Wayland буде відновлено лише розмір.

#### Тема піктограм Breeze

Якщо позначено, програма використовуватиме тему піктограм Breeze.

Якщо не позначено, програма використовуватиме загальносистемну тему піктограм. Таке використання працює не завжди.

#### Стиль графічного інтерфейсу

Надає змогу змінити стиль елементів керування Qt Quick (кнопок, пунктів для позначення тощо) на один зі стилів, які доступні у системі.

### Відтворення

#### Кроки позиціювання

Крок позиціювання при виборі відповідного пункту дії. Режимом позиціювання є точно https://mpv.io/manual/stable/#command-interface-seek-<target>-[<flags>].

#### Відкривати попередній відтворюваний файл під час запуску

Після запуску програма відкриває файл, який відтворювала програм у момент її закриття.

#### Виконувати позиціювання до останньої позиції відтворення

При відкритті файла, який ви прослуховували раніше, позиціювання відбудеться до позиції, де його було припинено попереднього разу.

#### Почати відтворення

Це стосується лише відновлення відтворення (позиціювання до останньої позиції відтворення) файла, який програма раніше відтворювала.

#### Призупиняти при мінімізації

Призупиняє відтворення, якщо вікно мінімізовано. Відтворення відновиться, щойно вікно буде знову розгорнуто.

#### Апаратне декодування

Якщо ви увімкнули апаратне декодування, рекомендуємо скористатися параметром auto-safe або auto.

Ознайомитися із описом кожного з параметрів можна тут: https://mpv.io/manual/stable/#options-hwdec.

Якщо ви хочете скористатися vaapi у X11, вам слід встановити для змінної середовищаQT_XCB_GL_INTEGRATION значення xcb_egl.

#### Запам'ятати останню позицію

Визначає, коли зберігати і відновлювати позицію у раніше відтворених файлах.

Перше поле керує тим, для яких файлів зберігати позицію:

- -1: можливість вимкнено

- 0: зберегти для усіх файлів

- 1-9999: зберігати для файлів, тривалість відтворення яких перевищує встановлене значення, у хвилинах

Друге поле керує тим, наскільки часто слід зберігати позицію.

#### Пропустити розділи

Якщо увімкнено, автоматично пропускає глави, що містять певні слова або символи.

Слова або символи, які слід пропускати, визначають за допомогою списку відокремлених комами значень.

Відповідність не є точно, тобто пошук від призведе до отримання списку записів, які містять цей рядок, наприклад, відкриття.

#### Вибір формату Youtube-dl

Haruna використовує для відтворення інтернет-відео youtube-dl. На деяких сайтах пропонують декілька версій відео або звукових даних (різні кодеки, роздільна здатність). За допомогою цього параметра ви можете налаштувати, яку з версії відео або звукових даних має вибрати youtube-dl. Додаткові відомості: https://github.com/ytdl-org/youtube-dl/blob/master/README.md#format-selection

### Відео

#### Шаблон знімка вікна

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

Вказати шаблон назви файла, який буде використано для знімків вікон. Шаблон визначає назву файла без суфікса і може містити специфікатори формату, які буде замінено під час створення знімка вікна. Типовим шаблоном є mpv-shot%n. Цей шаблон, наприклад, може давати назви файлів, подібні до mpv-shot0012.png.

Шаблон може починатися з відносного або абсолютного шляхів для визначення каталогу, куди слід зберігати знімки вікон.

Якщо остаточна назва файла збігається із назвою наявного файла, файл не буде перезаписано. Програма або не стане зберігати знімок вікна взагалі, або, якщо у шаблоні міститься %n, буде збережено файл із іншою, заново створеною, назвою.

Дозволені специфікатори форматів:

- %[#][0X]n

  Номер у послідовності із доповненням нулями до довжини X (типове значення — 04). Наприклад, формат %04n дасть 0012 для 12-го знімка вікна. Номер збільшується кожного разу при створенні знімка або виявленні наявного файла. Довжина X має перебувати у діапазоні від 0 до 9. Якщо додано символ #, mpv використає найменший доступний номер. Наприклад, якщо ви створите три знімка вікна — 0001, 0002, 0003 — і вилучите перші два, наступними знімками вікон будуть не 0004 і 0005, а знову 0001 і 0002.

- %f

  Назва файла поточного відтворюваного відео.

- %F

  Те саме, що і %f, але з вилученням суфікса назви файла, включно з крапкою.

- %x

  Каталог поточного відтворюваного відео. Якщо відео не перебуває у файловій системі (наприклад, http://), буде розгорнуто до порожнього рядка.

- %X{резерв}

  Те саме, що і %x, але якщо відеофайл перебуває не у файловій системі, повертає резервний рядок у {...}.

- %p

  Поточний час відтворення у тому самому форматі, який використано на екранній панелі. Результатом буде рядок у форматі «ГГ:ХХ:СС». Наприклад, якщо позиція у відео — 5 хвилин і 34 секунд, %p буде замінено на «00:05:34».

- %P

  Подібний до %p, але з додаванням мілісекунд позиції відтворення. Форматування є таким: «ГГ:ХХ:СС.ммм», де «ммм» є мілісекундна частина позиції відтворення.

  Зауваження

  Це простий спосіб отримання унікальних для кадрів часових позначок. (Номери кадрів були б інтуїтивно зрозумілішими, але реалізувати їх не просто, оскільки формати контейнерів, зазвичай, використовують часові позначки для ідентифікації кадрів.)

- %wX

  Вказати поточний час відтворення з використанням форматування рядка X. %p подібний до %wH:%wM:%wS, а %P — до %wH:%wM:%wS.%wT.

  Коректні специфікатори формату:

  - %wH

    години (з доповненням 0 до двох цифр)

  - %wh

    години (без доповнення)

  - %wM

    хвилини (00-59)

  - %wm

    загальні хвилини (включно з годинами, на відміну від %wM)

  - %wS

    секунди (00-59)

  - %ws

    загальна кількість секунд (включно із годинами і хвилинами)

  - %wf

    подібно до %ws, але у форматі дійсного числа з рухомою крапкою (float)

  - %wT

    мілісекунди (000-999)

- %tX

  Вказати поточну місцеву дату і час з використанням форматування X. У цьому специфікаторі формату використано на внутрішньому рівні функцію UNIX strftime(), а результат буде розгорнуто передаванням «%X» функції strftime. Наприклад, %tm вставить число поточного місяця як звичайне число. Вам слід скористатися декількома специфікаторами %tX для побудови повного рядка дати і часу.

- %{властивість[:резервний текст]}

  Вставити значення властивості вхідних даних «властивість». Наприклад, %{filename} є тим самим, що і %f. Якщо властивості не існує або вона є недоступною, буде вставлено текст помилки, якщо не вказано резервного тексту.

- %%

  Буде замінено на сам символ %.

### Нетипові команди

#### Команда

Визначає команду mpv, якою слід скористатися, див. список доступних команд на сторінці команд MPV.

Працюватимуть не усі команди, оскільки деякі є специфічними для mpv.

Найкориснішими є команди для керування властивостями, зокрема set, add, cycle.

set: встановлює значення властивості, наприклад `set volume-max 150`.

add: збільшує або зменшує значення властивості. Приклад: `add volume 15` — збільшує гучність на 15. Щоб зменшити значення, скористайтеся командою `add volume -15`.

cycle: циклічний перехід між значеннями властивості. Приклад: `cycle aid up`.

#### Повідомлення екранної панелі

Повідомлення не екранній панелі, яке слід показати при введенні нетипової команди дії.

Скористайтеся ${назва_властивості} ля показу значення властивості. Гучність: ${volume}.

#### Клавіатурне скорочення

Команда, яку буде викликано у відповідь на використання скорочення. Скорочення можна буде встановити після збереження.

#### Запускати при запуску програми

Команду буде запущено при запуску програми. Початкові команди можна перемикати, тобто вмикати або вимикати їх при запуску. Доступ до цієї можливості буде відкрито після збереження.

## Подяки і ліцензування

&haruna;

Авторські права на програму належать George Florea Bănuș, 2019-2021

Учасники розробки:

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

Авторські права на документацію до програми належать © George Florea Bănuș georgefb899@gmail.com, 2019-2021

Переклад українською: Юрій Чорноіван yurchor@ukr.net

&underCCBYSA4; &underGPL;