{"id":13575546,"url":"https://github.com/GyverLibs/GyverHub","last_synced_at":"2025-04-04T22:31:26.937Z","repository":{"id":154384401,"uuid":"615466376","full_name":"GyverLibs/GyverHub","owner":"GyverLibs","description":"Панель управления для ESP8266, ESP32 и других Arduino. Конструктор интерфейса. Интеграция в умный дом. Esp8266, esp32 and Arduino Dashboard library","archived":false,"fork":false,"pushed_at":"2024-04-13T21:10:38.000Z","size":5740,"stargazers_count":269,"open_issues_count":1,"forks_count":20,"subscribers_count":17,"default_branch":"main","last_synced_at":"2024-04-14T06:53:38.961Z","etag":null,"topics":["arduino","dashboard","esp32","esp8266","iot","mqtt","ui"],"latest_commit_sha":null,"homepage":"http://hub.gyver.ru","language":"C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/GyverLibs.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null}},"created_at":"2023-03-17T19:03:20.000Z","updated_at":"2024-04-15T11:18:37.888Z","dependencies_parsed_at":"2024-01-17T12:35:15.667Z","dependency_job_id":"f8208e3f-474e-42e4-b5c3-631c75d09b6c","html_url":"https://github.com/GyverLibs/GyverHub","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GyverLibs%2FGyverHub","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GyverLibs%2FGyverHub/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GyverLibs%2FGyverHub/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/GyverLibs%2FGyverHub/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/GyverLibs","download_url":"https://codeload.github.com/GyverLibs/GyverHub/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247260629,"owners_count":20910042,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["arduino","dashboard","esp32","esp8266","iot","mqtt","ui"],"created_at":"2024-08-01T15:01:01.988Z","updated_at":"2025-04-04T22:31:21.928Z","avatar_url":"https://github.com/GyverLibs.png","language":"C","funding_links":[],"categories":["C"],"sub_categories":[],"readme":"[![latest](https://img.shields.io/github/v/release/GyverLibs/GyverHub.svg?color=brightgreen)](https://github.com/GyverLibs/GyverHub/releases/latest/download/GyverHub.zip)\n[![PIO](https://badges.registry.platformio.org/packages/gyverlibs/library/GyverHub.svg)](https://registry.platformio.org/libraries/gyverlibs/GyverHub)\n[![Foo](https://img.shields.io/badge/Website-AlexGyver.ru-blue.svg?style=flat-square)](https://alexgyver.ru/)\n[![Foo](https://img.shields.io/badge/%E2%82%BD%24%E2%82%AC%20%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B0%D1%82%D1%8C-%D0%B0%D0%B2%D1%82%D0%BE%D1%80%D0%B0-orange.svg?style=flat-square)](https://alexgyver.ru/support_alex/)\n[![Foo](https://img.shields.io/badge/README-ENGLISH-blueviolet.svg?style=flat-square)](https://github-com.translate.goog/GyverLibs/GyverHub?_x_tr_sl=ru\u0026_x_tr_tl=en)  \n\n[![Foo](https://img.shields.io/badge/ПОДПИСАТЬСЯ-НА%20ОБНОВЛЕНИЯ-brightgreen.svg?style=social\u0026logo=telegram\u0026color=blue)](https://t.me/GyverLibs)\n\n# GyverHub [beta]\nПанель управления для esp8266, esp32 и других Arduino. Конструктор интерфейса, интеграция в умный дом.\n\n|⚠️⚠️⚠️\u003cbr\u003e**Бета-версия, проект в разработке!. Более подробные примеры, документация, уроки, видеоролики и прочее по GyverHub - ПОСЛЕ РЕЛИЗА. Когда - не знаю, может в этом году. [Обсуждение тут](https://github.com/GyverLibs/GyverHub/issues/44) и в [Телеграм чате](https://t.me/AlexGyverChat/441438)**\u003cbr\u003e⚠️⚠️⚠️|\n| --- |\n\n\u003e Если вам нужна старая версия библиотеки или приложения (2023 год) - они в ветке [old](https://github.com/GyverLibs/GyverHub/tree/old)\n\n\u003e \u003cbr\u003e**Документация находится в [Wiki репозитория](https://github.com/GyverLibs/GyverHub/wiki). English docs - [translate](https://github-com.translate.goog/GyverLibs/GyverHub/wiki?_x_tr_sl=ru\u0026_x_tr_tl=en)**\u003cbr\u003e\u003cbr\u003e\n\n\u003e \u003cbr\u003e**Внимание! Перед началом работы обязательны к прочтению главы по [установке библиотеки](https://github.com/GyverLibs/GyverHub/blob/main/docs/2.start.md) и [настройке приложения](https://github.com/GyverLibs/GyverHub/blob/main/docs/3.app.md)**\u003cbr\u003e\u003cbr\u003e\n\n## О проекте\n![promo](/docs/promo.png)\n\nGyverHub - это платформа, состоящая из библиотеки для *устройства* (Arduino-совместимого микроконтроллера) и *приложения* для управления. Приложение написано на JavaScript и может работать:\n- Как онлайн версия на официальном сайте **hub.gyver.ru**: [HTTP](http://hub.gyver.ru/) и [HTTPS](https://hub.gyver.ru/) версия, есть [HTTPS](https://alexgyver.github.io/GyverHub/) зеркало на GitHub Pages\n- Как веб-приложение (оффлайн PWA): официальный сайт можно установить на любое устройство (Android/iOS/Linux/Windows/Mac...)\n- Как [телеграм-приложение](https://t.me/GyverHUB_bot)\n- Как нативное приложение:\n  - Android: [Google Play](https://play.google.com/store/apps/details?id=ru.alexgyver.GyverHub), [скачать APK](https://github.com/GyverLibs/GyverHub-app/releases/latest)\n  - iOS: [App Store](https://apps.apple.com/kz/app/gyverhub/id6474273925)\n  - Desktop (Windows/Linux/Mac): [скачать](https://github.com/neko-neko-nyan/gyverhub-desktop/releases/latest)\n- Как автономная вебморда из Flash памяти ESP8266/ESP32 - [инструкция](https://github.com/GyverLibs/GyverHub/blob/main/docs/3.app.md#%D0%B2%D0%B5%D0%B1%D0%BC%D0%BE%D1%80%D0%B4%D0%B0-esp)\n\nУстройством может быть:\n- ESP8266 и ESP32 - библиотека нативно поддерживает их WiFi функции для работы по HTTP/WS/MQTT\n- Любые Arduino - работают в [ручном режиме](https://github.com/GyverLibs/GyverHub/blob/main/docs/9.bridge.md) по любому способу связи\n- Компьютер (персональный, одноплатный) - [библиотека сервера](https://github.com/neko-neko-nyan/pygyverhubd) на Python (в разработке)\n\nУстройство и приложение обмениваются данными по своему протоколу через различные интерфейсы связи: \n- **MQTT** - через Интернет (свой или сторонний MQTT брокер)\n- **HTTP + WebSocket** - в локальной WiFi сети\n- **Serial** - по USB или Bluetooth Serial\n- **Bluetooth** - через Bluetooth BLE\n- **Telegram** - через телеграм-ботов\n\nОсновные моменты:\n- Приложение может обнаруживать устройства в своей \"сети\"\n- В прошивке для устройства \"собирается\" графический интерфейс, который отправляется в приложение\n- Можно управлять устройством в приложении или с сайта, даже через Интернет\n- Библиотека позволяет максимально просто добавить устройство в систему умного дома по MQTT (Алиса, Home Assistant...)\n- Полностью автоматический парсинг данных с приложения и умного дома\n- Более 30 виджетов панели управления (кнопки, слайдеры, выключатели...)\n- Полная кастомизация: можно создавать свои виджеты, подключать скрипты и стили в приложение\n- Доп. модули: сенсорный графический дисплей, менеджер файлов, информация об устройстве, OTA обновление, проверка обновлений на GitHub, защита паролем, командная строка...\n- 1000 FontAwesome иконок оформления для кнопок и списка устройств\n- Тёмная и светлая темы, несколько цветовых схем, мультиязычный интерфейс\n- Не имеет своего сервера и \"личного кабинета\", работает полностью автономно на ПК/смартфоне\n- Открытая [база пользовательских проектов](https://github.com/GyverLibs/GyverHub-projects)\n- OTA обновление проектов с GitHub, прошивка проектов из браузера по USB\n\nВ отличие от аналогов (RemoteXY, Blynk) GyverHub:\n- Полностью бесплатный\n- Не имеет ограничений\n- Не привязан к серверам разработчика\n- Не нуждается в локальном сервере\n- Может работать без приложения и без доступа к Интернет\n\n## Благодарности\n- **neko-neko-nyan** - идеи, советы и доработки И МНОГО МНОГО ВСЕГО ЕЩЁ!\n- **ZMain**, **DiTheRX** - [мобильное приложение](https://github.com/GyverLibs/GyverHub-app) (Android, iOS)\n- **neko-neko-nyan** - [десктопное приложение](https://github.com/neko-neko-nyan/gyverhub-desktop) (Windows)\n- **Serega88kos** - тестирование, идеи\n- **DenysChuhlib** - идеи\n- **IliaSalaur** - идеи\n\n## Версии\n- beta\n\n## Обновление\n- Рекомендую всегда обновлять библиотеку: в новых версиях исправляются ошибки и баги, а также проводится оптимизация и добавляются новые фичи\n- Через менеджер библиотек IDE: найти библиотеку как при установке и нажать \"Обновить\"\n- Вручную: **удалить папку со старой версией**, а затем положить на её место новую. \"Замену\" делать нельзя: иногда в новых версиях удаляются файлы, которые останутся при замене и могут привести к ошибкам!\n\n## Баги и обратная связь\nПри нахождении багов создавайте **Issue**, а лучше сразу пишите на почту [alex@alexgyver.ru](mailto:alex@alexgyver.ru)  \nБиблиотека открыта для доработки и ваших **Pull Request**'ов!\n\nПри сообщении о багах или некорректной работе библиотеки нужно обязательно указывать:\n- Версия библиотеки\n- Какой используется МК\n- Версия SDK (для ESP)\n- Версия Arduino IDE\n- Корректно ли работают ли встроенные примеры, в которых используются функции и конструкции, приводящие к багу в вашем коде\n- Какой код загружался, какая работа от него ожидалась и как он работает в реальности\n- В идеале приложить минимальный код, в котором наблюдается баг. Не полотно из тысячи строк, а минимальный код\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGyverLibs%2FGyverHub","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FGyverLibs%2FGyverHub","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FGyverLibs%2FGyverHub/lists"}