Decky Loader

Удобный загрузчик плагинов для Steam Deck

📖 О проекте

Данный репозиторий представляет собой форк проекта Decky Loader с адаптацией под российскую платформу GitFlic и автономные сценарии установки.

Decky Loader — это загрузчик плагинов для портативной консоли Steam Deck (и клиента Steam в Big Picture / Gaming Mode). С его помощью можно настраивать темы оформления, изменять системные звуки, регулировать параметры экрана, управлять питанием и частотами, а также устанавливать множество полезных утилит прямо через меню быстрого доступа (Quick Access Menu ...).

🎨 Возможности

• 🧹 Чистая инъекция: одновременная и безопасная загрузка нескольких плагинов.
• 🔒 Устойчивость к обновлениям: сохранение работоспособности после системных апдейтов SteamOS и перезагрузок.
• 🔗 Двустороннее взаимодействие: асинхронный обмен данными между плагинами и ядром загрузчика.
• 🐍 Python + TypeScript/React: запуск серверной логики на Python и нативный интерфейс на TypeScript React.
• 🌐 Сетевая свобода: выполнение fetch-запросов плагинами без ограничений CORS.

🤔 Частые вопросы

• Syncthing может занимать порт 8080 на Steam Deck, необходимый для работы Decky Loader. Если вы используете Syncthing, смените его порт (рекомендуется 8384).
• Если у вас запущено стороннее ПО, использующее порт 1337 или 8080, измените порт этой программы.
• Если после крупного обновления SteamOS загрузчик перестал отображаться, просто выполните установку повторно.

💾 Установка

🖱️ Установка через ярлык на рабочем столе (как в оригинале)

1. Перейдите в Режим рабочего стола (Desktop Mode):
   Кнопка Steam ➔ Выключение ➔ Перейти к рабочему столу.
2. Нажмите зелёную кнопку ЗАГРУЗИТЬ вверху страницы (файл decky_installer.desktop автоматически скачается в «Загрузки»).
   (В браузере Firefox файл может сохраниться с расширением .desktop.download — в таком случае переименуйте его обратно в decky_installer.desktop).
3. Перетащите скачанный файл decky_installer.desktop на Рабочий стол (Desktop) и запустите его двойным кликом.
4. Выберите версию для установки и дождитесь завершения.
5. Запустите ярлык «Return to Gaming Mode» на рабочем столе.

🚀 Быстрая установка напрямую через терминал (Konsole)

В режиме рабочего стола откройте Konsole и выполните:

curl -sL https://subdeck.shop/install.sh | sh

👋 Удаление

Для полного удаления загрузчика и системной службы выполните в терминале:

curl -sL https://subdeck.shop/uninstall.sh | sh

(Плагины и настройки в папке ~/homebrew при этом сохраняются).

🚀 Начало работы и использование

1. Нажмите кнопку ... (Quick Access Menu) и перейдите на вкладку с иконкой штекера (Decky).
2. Нажмите на иконку магазина для открытия каталога плагинов (Plugin Store).
3. Выберите нужный плагин и нажмите «Install».
4. Для обновления, перезагрузки или настройки плагинов используйте меню шестеренки (Настройки) во вкладке Decky.

🛠️ Сборка и разработка

1. Клонируйте репозиторий:

   git clone https://gitflic.ru/project/rosakodu/decky-loader.git
   cd decky-loader
   

2. Соберите фронтенд:

   cd frontend
   pnpm install
   pnpm run build
   

3. Для тестирования на Steam Deck разверните изменения с помощью скрипта deck.sh или задач VS Code.

📄 Лицензия

Распространяется под лицензией GPL-3.0.