> ## Documentation Index
> Fetch the complete documentation index at: https://docs.youka.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Расширение Youka

> Откройте возможности десктопной версии в браузере: создание по URL видео, поиск текста песен и локальный экспорт

Расширение Youka добавляет в ваш браузер мощные возможности десктопной версии: позволяет создавать караоке по URL видео, автоматически искать текст песен и экспортировать видео локально. Локальный экспорт бесплатный; облачный экспорт по‑прежнему использует кредиты.

## Что вы получаете

После установки расширения Youka вам становятся доступны три ключевые функции:

* **Создание по URL видео** — Загружайте и создавайте караоке прямо по ссылкам на видео
* **Онлайн‑поиск текста песен** — Автоматически находите и импортируйте текст песен из интернета
* **Бесплатный локальный экспорт** — Рендерьте видео локально на компьютере без использования облачных кредитов

## Установка

### Скачайте расширение

1. Перейдите на [страницу загрузки расширения](/extension)
2. Нажмите кнопку загрузки для вашей операционной системы (Windows, macOS или Linux)
3. Запустите установщик и следуйте инструкциям
4. Расширение запускается в системном трее (вы увидите небольшой значок)

### Подключение к браузеру

После установки расширение автоматически подключается, когда вы заходите в Youka Online:

1. Откройте [online.youka.io](https://online.youka.io) в браузере
2. Найдите индикатор расширения в правом верхнем углу (должно отображаться «Connected»)
3. Всё готово — можно пользоваться всеми функциями расширения!

## Создание караоке по URL видео

Вместо загрузки файлов теперь можно создавать караоке прямо по ссылке на видео:

1. На главной странице нажмите **Create Karaoke**
2. Выберите вкладку **From URL**
3. Вставьте URL видео с предпочитаемой стриминговой платформы
4. Нажмите **Download**
5. Расширение скачает видео и извлечёт аудио
6. Далее работайте с текстом как обычно

**Примечание**: перед использованием этой функции убедитесь, что расширение запущено и подключено.

## Автоматический поиск текста песен

При добавлении текста к караоке расширение может найти его в интернете за вас:

1. В области ввода текста вы увидите кнопку **Search** (она отображается только когда расширение подключено)
2. Нажмите **Search**, чтобы автоматически найти текст по названию песни
3. Если текст найден, он будет импортирован в текстовое поле
4. При необходимости отредактируйте или скорректируйте

Это избавляет от ручного поиска и копирования текста с других сайтов.

## Бесплатный локальный экспорт

Экспортируйте караоке‑видео локально без использования облачных кредитов. Облачный экспорт по‑прежнему расходует кредиты:

1. Откройте проект в редакторе Studio
2. Нажмите **Export**, чтобы открыть окно экспорта
3. Вы увидите два варианта экспорта:
   * **Cloud Export** — Использует кредиты, рендерится в облаке
   * **Local Export** — Бесплатно, рендерится на вашем компьютере (требуется расширение)
4. Выберите **Local Export**
5. Выберите настройки экспорта (resolution, quality, FPS, transparency)
6. Нажмите **Start Export**
7. Расширение отрендерит видео локально и сохранит его на ваш компьютер

**Преимущества локального экспорта:**

* Полностью бесплатно — кредиты не требуются
* Неограниченное число экспортов
* Ваши файлы остаются на компьютере
* Полный контроль над местом сохранения результата

## Устранение неполадок

### Расширение не подключается

Если расширение не подключается автоматически:

1. Убедитесь, что расширение запущено (проверьте системный трей)
2. Перезапустите приложение расширения
3. Обновите страницу в браузере
4. Убедитесь, что используете поддерживаемый браузер (Chrome, Edge, Firefox)

### Не удалось скачать

Если загрузка видео не удаётся:

1. Проверьте, что URL — это корректная ссылка на видео
2. Убедитесь, что видео доступно публично (не приватное/с возрастными ограничениями)
3. Попробуйте другое видео для проверки
4. Обновите расширение до последней версии

### Экспорт занимает слишком много времени

Локальный экспорт рендерится на вашем компьютере, поэтому скорость зависит от:

* Производительности CPU/GPU
* Длины и разрешения видео
* Настроек качества экспорта

Чтобы ускорить экспорт, попробуйте уменьшить resolution или quality.

## Системные требования

* **Операционная система**: Windows 10+, macOS 10.15+ или Linux (Ubuntu 20.04+)
* **Память**: минимум 4GB RAM, рекомендуется 8GB+
* **Хранилище**: 500MB для расширения, плюс место для видеофайлов
* **Интернет**: требуется для скачивания видео и поиска текста песен

## Конфиденциальность и безопасность

Расширение Youka:

* Работает локально на вашем компьютере
* Подключается к Youka Online только когда вы используете веб‑приложение
* Не собирает и не отправляет персональные данные
* Загрузки обрабатываются на вашем устройстве
* Экспортированные файлы остаются на вашем компьютере (никогда не загружаются)

## Обновления

Расширение автоматически проверяет обновления при запуске. Чтобы обновить вручную:

1. Скачайте последнюю версию со [страницы загрузки расширения](/extension)
2. Запустите новый установщик (он обновит существующую установку)
3. Перезапустите расширение

## Помощь

Если возникли проблемы:

* Посмотрите раздел [устранения неполадок](#troubleshooting) выше
* Напишите нам на [support@youka.io](mailto:support@youka.io)