================================================================================
          ИНСТРУКЦИЯ ПО УСТАНОВКЕ И ИСПОЛЬЗОВАНИЮ ИНТЕГРАЦИИ "artLink"
                (Artlist to Premiere Pro & After Effects)
================================================================================

artLink — это профессиональный инструмент для видеомонтажеров, который позволяет в 
один клик скачивать музыку и видео с сайта Artlist.io, автоматически конвертировать 
их в монтажные форматы высокого качества (WAV и Apple ProRes) и сразу импортировать 
в открытый проект Adobe Premiere Pro или After Effects.

--------------------------------------------------------------------------------
1. ПОДГОТОВКА И ТРЕБОВАНИЯ
--------------------------------------------------------------------------------
* Операционная система: Windows (10 или 11).
* Adobe Premiere Pro и/или After Effects (версии 2019–2026+).
* Браузер: Google Chrome (или любой браузер на базе Chromium, например, Яндекс.Браузер).

--------------------------------------------------------------------------------
2. ПОШАГОВАЯ УСТАНОВКА
--------------------------------------------------------------------------------

ШАГ 1: Установка панели в Adobe Premiere Pro / After Effects
1. Перейдите в папку с программой.
2. Найдите файл "install.ps1".
3. Нажмите на него ПРАВОЙ кнопкой мыши и выберите пункт "Выполнить с помощью PowerShell" 
   (Run with PowerShell).
   * Этот скрипт автоматически пропишет настройки разработчика в реестре Windows 
     и скопирует панель расширения в нужную системную папку Adobe.
4. Если во время выполнения скрипта Premiere Pro или After Effects были открыты — 
   ОБЯЗАТЕЛЬНО перезапустите их.

ШАГ 2: Установка расширения в Google Chrome
1. Откройте Premiere Pro и откройте панель расширения: 
   "Окно" -> "Расширения" -> "VS Art Link" (Window -> Extensions -> VS Art Link).
2. На панели в блоке "Settings & Tools" нажмите кнопку "Show Chrome Ext". 
   Откроется окно проводника с папкой расширения.
3. Откройте Google Chrome и перейдите по адресу: chrome://extensions/
4. В правом верхнем углу включите переключатель "Режим разработчика" (Developer mode).
5. Перетащите папку "extension" из открытого окна проводника в любое место на странице 
   расширений Chrome (или нажмите кнопку "Загрузить распакованное расширение" и выберите ее).
   * В списке расширений появится карточка "VS Art Link".

ШАГ 3: Автоматическая настройка аудио-кодека (FFmpeg)
Для правильной работы перекодирования звука и видео программе требуется утилита FFmpeg. 
Мы сделали её установку полностью автоматической:
1. Откройте панель в Premiere Pro ("Окно" -> "Расширения" -> "VS Art Link").
2. Если внизу горит красное предупреждение "FFmpeg Required", нажмите на кнопку:
   "Download & Install FFmpeg (Auto)".
3. Панель сама скачает необходимый файл и установит его. Через пару секунд статус 
   сменится на зеленый индикатор "Local FFmpeg".

--------------------------------------------------------------------------------
3. КАК ПОЛЬЗОВАТЬСЯ ИНТЕГРАЦИЕЙ
--------------------------------------------------------------------------------

ОСНОВНОЕ ПРАВИЛО: Для работы интеграции панель расширения в Adobe Premiere Pro или 
After Effects ДОЛЖНА быть открыта (индикаторы "Server" и "FFmpeg" должны гореть зеленым).

Импорт музыки (аудио):
1. Откройте сайт Artlist.io в Chrome и включите любой трек.
2. В правом нижнем углу экрана появится плавающий темный виджет интеграции.
3. В нем вы увидите название текущего трека и две кнопки:
   * "to PR (WAV)" — скачать и импортировать в Premiere Pro.
   * "to AE (WAV)" — скачать и импортировать в After Effects.
4. Нажмите нужную кнопку. Файл скачается на компьютер, автоматически перекодируется 
   в несжатый WAV (без потери качества и задержек звука на таймлайне) и импортируется 
   в ваш открытый проект в отдельную папку "Artlist Downloads".

Импорт видео (футажей):
1. Наведите курсор мыши на плитку любого видео на сайте Artlist.io.
2. В правом верхнем углу превью видео появятся две маленькие кнопки-плашки: "PR" и "AE".
3. Нажмите на них для быстрого импорта:
   * Видео автоматически скачается, перекодируется в профессиональный монтажный 
     кодек Apple ProRes (формат .mov) и мгновенно появится в проекте Adobe!
4. Если вы открыли страницу видео, вы также можете использовать плавающий виджет 
   в правом углу экрана, где будут доступны кнопки импорта текущего видео.

--------------------------------------------------------------------------------
4. НАСТРОЙКИ И УТИЛИТЫ НА ПАНЕЛИ ADOBE
--------------------------------------------------------------------------------
* Destination Folder (Папка назначения): Здесь отображается путь, куда сохраняются 
  скачанные файлы. Нажмите кнопку "Select", чтобы выбрать другую папку на диске.
* Save directly to project folder: Если галочка включена, файлы будут скачиваться 
  в ту же папку, где сохранен ваш проект Premiere Pro/After Effects.
* Show Chrome Ext: Быстро открыть папку расширения для установки в браузер.
* Fix Registry: Если после обновления Adobe Premiere панель исчезла из меню, 
  нажмите эту кнопку и перезапустите Premiere.
* Reload Panel: Перезапуск интерфейса панели (полезно при смене настроек).
* Open Downloads: Открыть папку со скачанными медиафайлами в Проводнике Windows.
* Ссылки vshut.ru: Клик по ссылкам откроет ваш сайт в браузере по умолчанию.

--------------------------------------------------------------------------------
5. РЕШЕНИЕ ВОЗМОЖНЫХ ПРОБЛЕМ
--------------------------------------------------------------------------------

Проблема: Кнопки на сайте не активны или статус горит красным "Offline".
Решение:
1. Проверьте, открыта ли панель "VS Art Link" внутри Premiere Pro / After Effects.
2. Нажмите кнопку "Reload Panel" на панели Adobe.
3. Обновите страницу Artlist.io в браузере Chrome.
4. Убедитесь, что расширение Chrome включено на странице chrome://extensions/.

Проблема: Не импортируются файлы в проект Premiere Pro.
Решение:
1. Убедитесь, что у вас открыт какой-либо проект (пустой или рабочий). Если проект 
   не открыт, импортировать файлы некуда.
2. Проверьте статус "FFmpeg Encoder". Если он горит красным, выполните Шаг 3 
   из раздела установки.

================================================================================
Сайт: https://vshut.ru/
================================================================================
