= Инструкция использованию коробки для кошек

[[PageOutline(2-3,содержание)]]

== Быстрый старт
Конфигурация сети, калибровка экрана, запуск тв, ютуба, сериалов, фильмов.

== Главный экран #main-screen

Главный экран состоит из горизонтальной карусели главного меню (3). В зависимости от выбранного меню под ним может быть отображено подменю (4), а над ним информация(2), ярлыки (1) и виджет (5).

Пункты горизонтальной карусели главного меню могут быть выбраны кнопками на пульте со стрелками влево и вправо. Подменю, ярлыки и виджет изменяются в зависимости от выбранного меню и выбираются кнопками на пульте со стрелками вверх и вниз.

Фото главного с выбранным разделом `видео` (инвертировано по цвету в целях экономии краски при печати):[[br]]
[[Image(главное меню 1.jpg, 777px, nolink)]]

Фото главного с выбранным разделом `сериалы` (инвертировано по цвету в целях экономии краски при печати):[[br]]
[[Image(главное меню 2.jpg, 777px, nolink)]]


=== Пункт меню `видео` #menu-video
Включает в себя подменю из одного пункта `юлента` и двух ярлыков `YouTube` и `Elementum`. Вход в меню `видео` откроет список источников видео. Под источниками видео подразумевается локальные или сетевые папки с фильмами или сериалами. По умолчанию в списке источников пусто. Добавить источник видео можно через пункт `Добавить видео…`.

Подменю `юлента` показывает список всех доступных видеозаписей из всех подписок в `YouTube` начиная с самой свежей. Для отображения этих подписок необходимо авторизоваться в `YouTube`. Процесс авторизации описывается в разделе [#youtube-usage Использование `YouTube`].

Ярлыки `YouTube` и `Elementum` вызывают соответствующие дополнения. Первое дополнение позволяет использовать `YouTube`, процесс использования которого описывается в разделе "Использование `YouTube`. Дополнение `Elementum` используется для поиска, просмотров фильмов и сериалов. Данный процесс описан далее в соответствующих разделах.

=== Пункт меню `фильмы`
Включает в себя массу подменю с разделением фильмов по разным признакам. Вход в меню открывает раздел `фильмы` из дополнения `Elementum`. В этом разделе можно искать и смотреть фильмы. Описание просмотра фильмов более подробно описывается в разделе [#watching-movies Просмотр фильмов].

Все подменю используют источники, которые были добавлены из пункта меню `видео`, т.е. локальные или сетевые папки. Информация содержит статистику по общему, просмотренному и не просмотренному количеству фильмов из добавленных источников.

Виджет `тренд` показывает фильмы, которые сейчас в тренде. Данные фильмы можно попробовать включить для просмотра. Описание просмотра фильмов более подробно описывается в разделе [#watching-movies Просмотр фильмов].

=== Пункт меню `сериалы`
Включает в себя массу подменю с разделением сериалов по разным признакам. Вход в меню открывает раздел “Сериалы” из дополнения `Elementum`. В этом разделе можно искать и смотреть сериалы. Описание просмотра фильмов более подробно описывается в разделе [#watching-shows Просмотр сериалов].

Все подменю используют источники, которые были добавлены из пункта меню `видео`, т.е. локальные или сетевые папки. Информация содержит статистику по общему, просмотренному и не просмотренному количеству сериалов из добавленных источников.

Виджет `тренд` показывает сериалы, которые сейчас в тренде. Данные сериалы можно попробовать включить для просмотра. Описание просмотра сериалов более подробно описывается в разделе [#watching-shows Просмотр фильмов].

=== Пункт меню `ТВ`
Включает в себя почти бесполезное подменю поиска ТВ каналов. Вход в меню открывает список ТВ каналов. Эти ТВ каналы можно попробовать запустить для просмотра.

Виджет показывает последние просмотренные ТВ каналы. Эти ТВ тоже можно попробовать запустить для просмотра. Описание просмотра ТВ канало более подробное описывается в разделе [#watching-tv Просмотр ТВ].

=== Пункт меню `погода`
Включает в себя подменю `<<<` и `>>>` и виджет почасовой погоды. При выборе данного меню информация отображает текущую погоду для выбранного города. Вход в меню открывает дополнение `Погода`. Описание работы с погодой более подробно описывается в разделе [#watching-weather Просмотр погоды].

== Использование `YouTube` #youtube-usage

=== Запуск дополнения #youtube-launch
Для запуска дополнения `YouTube` на [#main-screen главном экране] из [#menu-video пункта меню видео] выбрать ярлык `YouTube`. После нажатия на [#remote-buttons пульте управления] кнопки `OK` будет открыто дополнение `YouTube`.

=== Поиск по названию #youtube-search
Самый быстрый способ воспользоваться дополнением - это найти нужные видеоролики по названию. Для этого после [#youtube-launch запуска дополнения] необходимо выбрать меню `Поиск`, потом `Новый поиск` и, воспользовавшись [#screen-keyboard экранной клавиатурой], ввести поисковую фразу.

После некоторого времени, которое необходимо на поиск, на экран будет выведены три директории: `Каналы`, `Плейлисты`, `Прямой эфир`, а так же список найденных видеороликов. Любой из найденных видеороликов можно выбрать и сразу же запустить для просмотра. Внутри директорий будут отображены соответственно каналы, плейлист и прямой эфир, которые нашлись по введённой фразе для поиска.

=== Авторизация #youtube-authorization
Дополнение `YouTube` умеет авторизоваться в сервисе `YouTube`. Это может пригодиться для [#youtube-feed ленты видеороликов (юлента)] со всех каналов, на которые есть подписка. Для того, чтобы авторизоваться, необходимо после запуска дополнения выбрать меню `Авторизация`.

Во время авторизации нужно следовать указаниям на экране. В соответствии с этим необходимо будет на компьютере или мобильном телефоне в браузере открыть указанный адрес и ввести код с экрана. Такое будет запрошено дважды - это не ошибка, так и должно быть. После ввода одного из кодов, браузер сообщит о том, что приложение не проверено:[[br]][[Image(youtube-warning.jpg, nolink)]]

Необходимо нажать сначала на ссылку `Дополнительные настройки`, тогда должна появиться ссылка `Перейти на страницу "kodi youtube" (небезопасно)`. После этого нужно нажать нажать на появившуюся ссылку, не обращая внимания на предупреждение о небезопасности.

Причина предупреждения `Google` заключается в том, что авторизация коробочки в `YouTube` выполняется для двух сторон. Первая сторона - это ты, как пользователь, использующий коробочку. Вторая сторона - это приложение, которое обеспечивает коробочке доступ до `YouTube`. Это приложение в базе данных `Google`.

Приложение создано мной в базе данных `Google`, но не отправлено на проверку. Во-первых потому, что для прохождения проверки необходимы дополнительные усилия. А во-вторых проверка стоит денег. Учитывая моё максимальное старание никому никогда ни за что не платить, прохождение проверки этому противоречит.

=== Юлента #youtube-feed
Подменю открывает ленту видеороликов со всех каналов, на которые подписан аккаунт, авторизованный через [#youtube-authorization авторизацию youtube], описанную в предыдущем параграфе. В этой ленте показывается список видеороликов, отсортированный по дате появления в обратном порядке - самые свежие сверху. Удобно для просмотра новых роликов на интересующих каналах.

== Просмотр фильмов #watching-movies

=== Поиск конкретного фильма
Текст
=== Использование списков
Текст

== Просмотр сериалов #watching-shows
=== Поиск конкретного сериала
Текст
=== Использование списков
Текст

== Просмотр ТВ #watching-tv
Текст

== Просмотр погоды #watching-weather
Текст

== Решение проблем
=== В случае загрузки андроида
Текст

== Использование вспомогательного функционала
=== Описание кнопок пульта управления #remote-buttons

Фото пульта управления
(инвертировано по цвету в целях экономии краски при печати):

[[Image(пульт.jpg, 777px, nolink)]]
- Левая кнопка со знаком электропитания. Включает приставку, если она выключена при индикация красным на корпусе. При включенной приставке вызывает меню выключения.
- Правая кнопка выключения программируемая для включения и выключения подключенного телевизора.
- Кнопки `SET`, `TV IN`, `VOL-`, `VOL+` программируемые для управления подключенным телевизором. Программирование кнопок пульта описано в отдельном параграфе.
- Функции цветных кнопок `SETUP` и `APP` я не задавал, но так получилось, что при просмотре видео кнопка `SETUP` выходит из полноэкранного режима просмотра, а кнопка `APP` последовательно переключает звуковые дорожки. В режиме меню эти кнопки не выполняют никаких функций.
- Цветные кнопки `VOL-` и `VOL+` регулируют громкость звука отдельно от телевизора.
- Кнопка с пиктограммой домика (`🏠`) - возврат в главное меню из любого другого местоположения.
- Кнопка `назад` (справа от домика) - выход в предыдущее меню.
- Четыре стрелки (вправо, влево, вверх и вниз) управляют передвижением курсора.
- Кнопка `OK` активирует подсвеченный курсором элемент. Во время воспроизведения видео отображает меню управления воспроизведением.
- Кнопка меню (`☰`) вызывает контекстное меню на подсвеченном курсором элементе.
- Кнопка с пиктограммой компьютерной мыши включает курсор мыши для более точного выбора (используется только в android).
- Кнопки от `0` до `9` используются для цифрового ввода.
- Кнопка отключения звука, очевидно, полностью отключает звук.
- Кнопка прямоугольника с одним треугольным ребром и крестом внутри при вводе удаляет символ слева от курсора.
- При воспроизведении видео кнопка `0` включает и выключает паузу у видео. При длительном нажатии во время воспроизведения видео кнопка 0 включает и выключает информацию о видео. 

=== Программирование кнопок пульта
1. Нажмите и удерживайте кнопку `SET` около 6 секунд пока не загорится светодиод. После этого пульт перейдёт в режим обучения
1. Нажмите кнопку, на которую хотите провести обучение. Светодиод должен начать моргать.
1. Поместите сторонний пульт управления в одну горизонтальную линию с обучаемым на расстояние 3-4 см.
1. Нажмите и около 3 секунд удерживайте на другом пульте кнопку, которой хотите обучить.
1. Светодиод должен 3 раза быстро моргнуть, если пульт получил сигнал от стороннего пульта.
1. Нажмите кнопку SET для того чтобы подтвердить назначение.
1. Повторите, начиная с пункта 1 для обучения других кнопок.

=== Экранная клавиатура #screen-keyboard
Для ввода текста с использованием [#remote-buttons унылого пульта] оболочка предоставляет достаточно удобную экранную клавиатуру (инвертировано по цвету в целях экономии краски при печати):[[br]]
[[Image(screen-keyboard.jpg, 777px, nolink)]]

Ввод текста происходит в верхнюю строку. Для того, чтобы ввести символ, нужно выбрать его кнопками со стрелками на пульте и нажать кнопку `OK`. Выбор и нажатие на экранной клавиутуре:
- `English QWERTY` переключит раскладку клавиатуры на русский язык.
- `Shift` включит верхний регистр для ввода одной следующей буквы.
- `Caps Lock` включить верхний регистр для ввода всех следующих букв. Что бы отключить этот режим, нужно снова нажать на `Caps lock`.
- `IP` откроет вспомогательную клавиатуру для ввода IP-адреса.
- `@#!*` включит раскладку для ввода специальных символов.
- `Готово` закроет клавиатуру и отправит текущий ввод в то место, откуда была вызвана клавиатура.
- `Пробел` введёт пробел.
- `Крест` удалит один символ слева от курсора.
- `<` и `>` переместит курсор на один символ влево или вправо.
- `Отмена` отменит текущий ввод и закроет клавиатуру.

== Управление просмотром видео #video-control
После запуска видео оболочка переходит в режим контроля просмотра. В этом разделе я опишу основные возможности этого режима.

=== Главное меню режима просмотра
При нажатии на кнопку `OK` на пульте появится главное меню просмотра. Изображение главного меню посмотра (инвертировано по цвету в целях экономии краски при печати):[[br]]
[[Image(video-control1.jpg, 777px, nolink)]]

Чтобы это меню не мешало просмотра, его можно отключить с помощью кнопки `назад` (справа от домика) на пульте. Главное меню просмотра отображает информацию о видео, шкалу времени воспроизведения, а так же круглые кнопки контроля. Опишу их слева направо:
1. Переход к предыдущей главе или началу видео, если текущая глава самая первая или видео не разделено на главы. Переход к предыдущему видео при воспроизведении видео из списка.
1. Включение перемотки назад в режиме воспроизведения, увеличение скорости перемотки назад при перемотке назад или уменьшение скорости перемотки вперёд при перемотке вперёд.
1. Постановка видео на паузу без выхода из режима воспроизведения.
1. Остановка видео с выходом из режима воспроизведения.
1. Включение перемотки вперёд в режиме воспроизведения, увеличение скорости перемотки вперёд при перемотке вперёд или уменьшение скорости перемотки назад при перемотке назад.
1. Переход к следующей главе или следующему видео при воспроизведении видео из списка.
1. Вызов меню настройки субтитров, описывается в одном из [#video-control-subs следующих параграфов].
1. Вызов меню настройки видео, описывается в одном из [#video-control-video следующих параграфов].
1. Вызов меню настройки звука, описывается в одном из [#video-control-sound следующих параграфов].
1. Вызов списка глав и закладок.

=== Меню настройки субтитров #video-control-subs
Изображение меню настройки субтитров (инвертировано по цвету в целях экономии краски при печати):[[br]]
[[Image(video-control2.jpg, 777px, nolink)]]

Функции меню настройки субтитров:
1. `Включить субтитры` - включение или выключение субтитров.
1. `Смещение субтитров` - установка смещения субтитров на случай, если они убегают или отстают.
1. `Субтитры` - выбор встроенных субтитров при их наличии в воспроизводимом файле.
1. `Выбрать субитры...` - выбор субтитров из внешнего файла.
1. `Скачать субтитры...` - скачивание субтитров из интернет (не будет работать, потому что не сконфигурировано)
1. `Установить по-умолчанию` - установка текущих настроек по-умолчанию для всех видео.

Например, если нужно чтобы для всех видео субтитры были выключены, то нужно погасить флажок включенности субтитров и нажать `Установить по-умолчанию для всех медиа`.

=== Меню настройки видео #video-control-video
Изображение меню настройки видео (инвертировано по цвету в целях экономии краски при печати):[[br]]
[[Image(video-control3-1.jpg, 777px, nolink)]][[br]]
[[Image(video-control3-2.jpg, 777px, nolink)]]

Функции меню настройки видео:
1. `Видеопоток` - выбор видео-дорожки. Почти всегда неактивно, поскольку большинство видео имеют только одну основную видео-дорожку. Может быть активно при запуске видео из `YouTube` с возможностью выбора определённого кодека и битрейта. Хотя при текущей конфигурации коробочки нет необходимости об этом думать.
1. `Метод деинтерлейсинга` - выбор метода для видео, которые записаны с использованием интерлейсинга. В современных реалиях встречается крайне редко, поэтому в большинстве случаев будет неактивно.
1. `Режим просмотра` - выбор режима позиционирования или растяжения видео при наличии чёрных полос по бокам или сверху и снизу. Не лучший вариант решения проблемы, лучше воспользоваться следующим пунктом.
1. `Степень увеличения` - увеличение или уменьшение видео для частичного избавления от чёрных полос сверху/снизу для новых видео или по бокам для старых видео.
1. `Вертикальное смещение` - выбор вертикального смещения видео. Ни разу не сталкивался с необходимостью использования этого.
1. `Пропорции` - выбор пропорций видео. При выборе пункта можно растянуть видео по вертикали или горизонтали. Для нормальных видео без необходимости, однако может помочь улучшить просмотр для чего-нибудь криво закодированного.
1. `Ориентация` выбор ориентации видео. Тоже без необходимости для нормальных видео, но может помочь улучшить просмотр для чего-нибудь криво закодированного.
1. `Яркость` и `Контрастность` - управление яркостью и контрастностью видео.
1. `Нелинейное увеличение` - не удалось выяснить на что влияет включение или выключение.
1. `Стереоскопический режим видео` и `Инверсный стереоскопический 3D режим` - не тестировалось, но должно неплохо работать в режиме `авто`.
1. `Установить по-умолчанию` - установка текущих настроек по-умолчанию для всех видео.
1. `Калибровка дисплея...` - установка ширины, высоты, позиции субтитров и пропорций краёв экрана по отношению к краям телевизора. Будет не лишним использовать если края экрана вылазят за края телевизора или наоборот сверху, снизу и по сторонам видны чёрные полосы.

=== Меню настройки звука #video-control-sound
Изображение меню настройки видео (инвертировано по цвету в целях экономии краски при печати):[[br]]
[[Image(video-control4.jpg, 777px, nolink)]]

Функции настройки меню звука:
1. `Громкость` - управление громкостью звука. Выполняет ту же самую функцию, что и кнопки громкости на пульте управления.

== Разное
https://yau.o6a.ru/wiki/catbox - оригинал и последняя версия этого документа