В этом кратком руководстве я расскажу как подготовить вашу систему к запуске приложения, а также расскажу как им пользоваться. Данное руководство подойдет для пользователей без навыков программирования.

Так как PUSSY поставляется в виде исходного кода, то для его запуска нужен интерпретатор. Для этого переходите на сайт python.org и скачивайте дистрибутив для своей операцинной системы. Далее я опишу процесс установки для Windows.

После скачивания запускайте исполняемый файл отметьте поле «Add Python 3.8 to the PATH» (Добавить Python 3.8 к системной переменной PATH), как на рисунке (это может выглядеть по-разному в зависимости от версии, которую вы устанавливаете).

Нажимайте «Install Now», чтобы начать установку немедленно или «Customize installation» для тонкой настройки установки.

После установки Python нужно установки пакет PySide6. Для этого запустите приложение Командная строка нажатием «Win+R» и введите «cmd» и Enter, должно появиться окно терминала, затем введите команду:

pip install PySide6

После скачивания пакета приложение готово к запуску.

Для скачивания перейдите в репозиторий или ищите дополнительные способы загрузки на Странице проекта. На GitHub щелкайте по кнопке «Code» и выберите пункт «Download ZIP», скачивайте архив. После скачивания распакуйте содержимое в месте по своему усмотрению. Запустите двойным щелчком файл PUSSY.pyw в папке PUSSY/manager.

Если все предыдущие шаги были выполнены правильно то на экране предстанет главное окно Менеджера. В главном окне будут отображены вкладки Плагинов, которые на данный момент установлены и активированы. Плагины по умолчанию запускаются после того как будет активирована вкладка, если нужно инициализировать его при запуске, то далее будет рассказано как это сделать.

Чтобы перейти к списку установленных плагинов надо нажать Ctrl+Alt+P, тогда появиться следующее - список плагинов. В первом столбце показаны имена Плагинов; во втором - кнопки активации, с их помощью можно выключать или включать плагины в любое время; в третьем - кнопки перехода к настройкам, если кнопка не не активна, то настройки не доступны; в четвертом - дополнительные опции: Plugin Info - информация о плагине; Reset Settings - сброс настроек; Initialize on startup - инициализация плагина при запуске.

Менеджер имеет небольшой перечень настроек, чтобы перейти к ним надо нажать Ctrl+Alt+S. В первом разделе собраны настройки для настройки интерфейса, описывать каждый из них нет смысла, так как их назначение должно быть понятно. Во втором разделе одна опция: «Exterrnal plugin directories» - это список папок, где Менеджер производит поиск плагинов, о них мы поговорим позднее. Чтобы применить настройки нужно нажать на «Apply settings». Кнопка « Delete invalid data» - удаляет данные о плагина, которые были удалены или недоступны.

Есть еще один раздел, не должен быть интересен обычным пользователям, но в некоторых случаях он может быть полезен, если Плагины работают некорректно, речь идет о логах, чтобы перейти к ним надо нажать Ctrl+Alt+L. Там будет иноформация о работе плагинов, если сообщения выделены зеленым, то все в порядке, если красным, то явно что-то не так. Чтобы выводить детальную информацию нужно в настройках отметить опцию «Display error info in Logs».

Плагин это по сути это пакет, исходя из терминологии Python, если говорить простыми словами это папка с файлами, которые содержат исходный код. Для того чтобы установить новый плагин нужно просто скопировать папку с кодом в директорию PUSSY/manager/Plugins, либо в любую другую, которая указана в настройках, в пункте «Exterrnal plugin directories».

Удаление производится аналоги образом. Перезагрузите Менеджер. Чтобы удалить служебную информацию об удаленных плагинах нужно нажать на « Delete invalid data».

О том как разрабатывать собственные плагины смотрите соответствующие материалы на этом сайте.