Tuya Widget Desktop

Полноценный виджет для управления умными лампами Tuya на рабочем столе Windows, созданный с использованием Electron.

Особенности

• 🏠 Виджет для рабочего стола - работает как полноценный виджет Windows
• 💡 Управление лампами Tuya - включение/выключение, регулировка яркости и цвета
• 🔐 Безопасная авторизация - поддержка Smart Life и Tuya аккаунтов
• 🎨 Современный интерфейс - красивый дизайн с темной темой
• ⌨️ Горячие клавиши - Alt+T для показа/скрытия виджета
• 💾 Сохранение настроек - автоматическое сохранение данных авторизации
• 🔄 Автообновление - автоматическое обновление токенов доступа

Установка

Требования

• Node.js 16+
• npm или yarn
• Windows 10/11

Шаги установки

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

   git clone https://github.com/ilfae/Tuya-Widget
   cd tuya-widget

2. Установите зависимости:

   npm install

3. Запустите в режиме разработки:

   npm run dev

4. Соберите приложение:

   npm run build

Использование

Первый запуск

1. Запустите приложение
2. Нажмите кнопку "Авторизация" (🔑)
3. Введите данные вашего Tuya/Smart Life аккаунта:
   • Логин - email или номер телефона
   • Пароль - пароль от аккаунта
   • Регион - выберите ваш регион (EU/US/CN)
   • Платформа - выберите Tuya или Smart Life
4. Нажмите "Войти"
5. Выберите устройство из списка

Управление лампами

• Включить/Выключить - кнопки с иконкой питания
• Яркость - слайдер с иконкой солнца
• Цвет - цветовой слайдер для RGB ламп
• Быстрые действия - кнопки для быстрого управления

Управление окном

• Перетаскивание - перетащите заголовок для перемещения
• Свернуть - кнопка с иконкой минуса
• Переключить режим - кнопка с иконкой развернуть/свернуть
• Закрыть - кнопка с иконкой X (скрывает виджет)
• Горячие клавиши - Alt+T для показа/скрытия

Структура проекта

tuya-widget/
├── main.js              # Основной процесс Electron
├── preload.js           # Preload скрипт для безопасности
├── package.json         # Конфигурация проекта
├── renderer/            # Файлы интерфейса
│   ├── index.html       # HTML разметка
│   ├── styles.css       # Стили
│   └── widget.js        # Логика виджета
├── icons/               # Иконки приложения
└── dist/                # Собранное приложение

Настройка

Режимы окна

• Виджет режим (по умолчанию):

  • Размер: 320x480
  • Поверх всех окон
  • Скрыт из панели задач
  • Перетаскиваемый

• Обычный режим:

  • Размер: 400x600
  • Обычное окно
  • Видим в панели задач

Сохранение данных

Приложение автоматически сохраняет:

• Данные авторизации
• Список устройств
• Позицию окна
• Настройки пользователя

Разработка

Команды

npm start          # Запуск приложения
npm run dev        # Запуск в режиме разработки
npm run build      # Сборка приложения
npm run dist       # Создание установщика

Отладка

Для отладки используйте:

• F12 - открыть DevTools
• Ctrl+Shift+I - открыть DevTools
• Ctrl+R - перезагрузить приложение

Безопасность

• Используется contextIsolation для безопасности
• Все API вызовы проходят через preload скрипт
• Данные сохраняются в защищенном хранилище Electron
• Нет прямого доступа к Node.js API из renderer процесса

Поддерживаемые устройства

• RGB лампы Tuya/Smart Life
• Белые лампы с регулировкой яркости
• Умные розетки (базовое управление)

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

Проблемы с авторизацией

1. Проверьте правильность логина и пароля
2. Убедитесь, что выбран правильный регион
3. Попробуйте использовать VPN если есть проблемы с доступом

Проблемы с подключением

1. Проверьте интернет соединение
2. Убедитесь, что устройства подключены к сети
3. Попробуйте обновить список устройств

Проблемы с приложением

1. Перезапустите приложение
2. Очистите сохраненные данные
3. Переустановите приложение

Лицензия

MIT License

Поддержка

Если у вас возникли проблемы или есть предложения по улучшению, создайте issue в репозитории проекта.