{"id":24621547,"url":"https://github.com/alryaz/hass-pik-intercom","last_synced_at":"2025-05-07T12:21:50.114Z","repository":{"id":39573811,"uuid":"407205510","full_name":"alryaz/hass-pik-intercom","owner":"alryaz","description":"ПИК Домофон для Home Assistant","archived":false,"fork":false,"pushed_at":"2024-03-17T13:05:15.000Z","size":325,"stargazers_count":54,"open_issues_count":15,"forks_count":14,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-03-31T09:51:14.436Z","etag":null,"topics":["custom-component","homeassistant","intercom","pik-group"],"latest_commit_sha":null,"homepage":"","language":"Python","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/alryaz.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["alryaz"],"patreon":"alryaz","open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":["https://www.tinkoff.ru/cf/3g8f1RTkf5G","https://paypal.me/alryaz","https://yoomoney.ru/to/410012369233217"]}},"created_at":"2021-09-16T14:53:14.000Z","updated_at":"2025-03-16T07:36:14.000Z","dependencies_parsed_at":"2024-03-17T14:25:18.846Z","dependency_job_id":"297b32bc-6ccd-4517-b9f1-431e4c6aa5fe","html_url":"https://github.com/alryaz/hass-pik-intercom","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alryaz%2Fhass-pik-intercom","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alryaz%2Fhass-pik-intercom/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alryaz%2Fhass-pik-intercom/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alryaz%2Fhass-pik-intercom/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alryaz","download_url":"https://codeload.github.com/alryaz/hass-pik-intercom/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252874208,"owners_count":21817780,"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":["custom-component","homeassistant","intercom","pik-group"],"created_at":"2025-01-25T02:22:52.579Z","updated_at":"2025-05-07T12:21:50.024Z","avatar_url":"https://github.com/alryaz.png","language":"Python","funding_links":["https://github.com/sponsors/alryaz","https://patreon.com/alryaz","https://www.tinkoff.ru/cf/3g8f1RTkf5G","https://paypal.me/alryaz","https://yoomoney.ru/to/410012369233217"],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://raw.githubusercontent.com/alryaz/hass-pik-intercom/master/images/header.png\" height=\"100\" alt=\"Home Assistant + ПИК Домофон\"\u003e\n\n_\u0026#xab;ПИК Домофон\u0026#xbb;_ для _Home Assistant_\n==================================================\n\n\u003e Управление домофонами в экосистеме группы ПИК. Поддержка просмотра видеопотока и открытия дверей.\n\u003e\n\u003e Intercom management within PIK Group ecosystem. Video feed and door unlocking supported.\n\u003e \n\u003e [![hacs_badge](https://img.shields.io/badge/HACS-Default-41BDF5.svg?style=for-the-badge)](https://github.com/custom-components/hacs)\n\u003e [![Лицензия](https://img.shields.io/badge/%D0%9B%D0%B8%D1%86%D0%B5%D0%BD%D0%B7%D0%B8%D1%8F-MIT-yellow.svg?style=for-the-badge)](https://opensource.org/licenses/MIT)\n\u003e [![Поддержка](https://img.shields.io/badge/%D0%9F%D0%BE%D0%B4%D0%B4%D0%B5%D1%80%D0%B6%D0%B8%D0%B2%D0%B0%D0%B5%D1%82%D1%81%D1%8F%3F-%D0%B4%D0%B0-green.svg?style=for-the-badge)](https://github.com/alryaz/hass-pandora-cas/graphs/commit-activity)\n\n\u003e 💵 **Пожертвование на развитие проекта**  \n\u003e [![Пожертвование YooMoney](https://img.shields.io/badge/YooMoney-8B3FFD.svg?style=for-the-badge)](https://yoomoney.ru/to/410012369233217)\n\u003e [![Пожертвование Тинькофф](https://img.shields.io/badge/Tinkoff-F8D81C.svg?style=for-the-badge)](https://www.tinkoff.ru/cf/3g8f1RTkf5G)\n\u003e [![Пожертвование Cбербанк](https://img.shields.io/badge/Сбербанк-green.svg?style=for-the-badge)](https://www.sberbank.com/ru/person/dl/jc?linkname=3pDgknI7FY3z7tJnN)\n\u003e [![Пожертвование DonationAlerts](https://img.shields.io/badge/DonationAlerts-fbaf2b.svg?style=for-the-badge)](https://www.donationalerts.com/r/alryaz)\n\u003e\n\u003e 💬 **Техническая поддержка**  \n\u003e [![Группа в Telegram](https://img.shields.io/endpoint?url=https%3A%2F%2Ftg.sumanjay.workers.dev%2Falryaz_ha_addons\u0026style=for-the-badge)](https://telegram.dog/alryaz_ha_addons)\n\n\u003e **Библиотека API «ПИК Домофон»: [alryaz/pik-intercom-python](https://github.com/alryaz/pik-intercom-python)**\n\n\u003e **Интеграция для личного кабинета ЖКХ «ПИК Комфорт»: [alryaz/hass-pik-comfort](https://github.com/alryaz/hass-pik-comfort)**\n\n## Скриншоты\n\n\u003cdetails\u003e\n  \u003csummary\u003eПросмотр видеопотока домофона\u003c/summary\u003e \n  \u003cimg src=\"https://raw.githubusercontent.com/alryaz/hass-pik-intercom/main/images/camera.png\" alt=\"Скриншот: Просмотр видеопотока домофона\"\u003e\n\u003c/details\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eОткрытие двери у домофона\u003c/summary\u003e \n  \u003cimg src=\"https://raw.githubusercontent.com/alryaz/hass-pik-intercom/main/images/unlockers.png\" alt=\"Скриншот: Открытие двери у домофона\"\u003e\n\u003c/details\u003e\n\n## Установка\n\n\u003e Также рекомендуется установить компонент [AlexxIT/WebRTC](https://github.com/AlexxIT/WebRTC).\n\u003e Он позволяет просматривать видеопотоки в реальном времени через окна браузера.\n\n### Home Assistant Community Store\n\n\u003e 🎉  **Рекомендованный метод установки.**\n\n1. Установите\n   HACS ([инструкция по установке на оф. сайте](https://hacs.xyz/docs/installation/installation/)).\n2. Добавьте репозиторий в список дополнительных:\n    1. Откройте главную страницу _HACS_.\n    2. Откройте раздел _Интеграции (Integrations)_.\n    3. Нажмите три точки сверху справа (допонительное меню).\n    4. Выберите _Пользовательские репозитории_.\n    5. Скопируйте `https://github.com/alryaz/hass-pik-intercom` в поле вводавыберите _Интеграция (Integration)_ в выпадающем списке -\u003e Нажмите _Добавить (Add)_.\n    6. Выберите _Интеграция (Integration)_ в выпадающем списке.\n    7. Нажмите _Добавить (Add)_.\n3. Найдите `PIK Intercom` (`ПИК Домофон`) в поиске по интеграциям.\n4. Установите последнюю версию компонента, нажав на кнопку `Установить` (`Install`).\n5. Перезапустите сервер _Home Assistant_.\n\n### Вручную\n\n\u003e ⚠️ **Внимание!** Данный вариант **\u003cins\u003eне рекомендуется\u003c/ins\u003e** в силу сложности поддержки установленной интеграции в актуальном\n\u003e состоянии.\n\n0. _(предварительно)_ Создайте (если отсутствует) папку `custom_components` внутри папки с конфигурацией Вашего _Home Assistant_.\n1. Скачайте архив с интеграцией:\n   1. Для загрузки последней стабильной версии:\n      1. Перейдите на [страницу последнего релиза](https://github.com/alryaz/hass-pik-intercom/releases/latest)\n      2. Нажмите на кнопку скачивания исходного кода (текст: _Source code (zip)_)\n   2. Для загрузки последней \"превью\"-версии (не стабильно, может не работать вовсе):\n      1. Перейдите по [ссылке скачивания исходного кода](https://github.com/alryaz/hass-pik-intercom/archive/refs/heads/main.zip)\n2. Откройте папку `hass-pik-intercom-####` внутри загруженного архива (`####` - индекс версии интеграции).\n3. Извлеките содержимое папки `custom_components` внутри архива в Вашу папку `custom_components` (из шага №0).\n4. Перезапустите сервер _Home Assistant_.\n\n## Настройка\n\n[![Открыть Ваш Home Assistant и начать настройку интеграции.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=pik_intercom)\n\nНажмите на кнопку выше, или следуйте следующим инструкциям:\n1. Откройте `Настройки` -\u003e `Интеграции`\n2. Нажмите внизу справа страницы кнопку с плюсом\n3. Введите в поле поиска `PIK`  \n   - Если интеграция не была найдена на данном этапе, перезапустите Home Assistant и очистите кеш браузера.\n4. Выберите первый результат из списка\n5. Следуйте инструкциям, описываемым на экране.\n6. После завершения настройки начнётся обновление состояний объектов.\n\n- **Вариант А:** Через _Интеграции_: [![Open your Home Assistant instance and start setting up a new integration.](https://my.home-assistant.io/badges/config_flow_start.svg)](https://my.home-assistant.io/redirect/config_flow_start/?domain=pik_intercom)\n- **Вариант Б:** YAML (см. пример ниже)\n\n### Пример конфигурации YAML\n```yaml\npik_intercom:\n  # Номер телефона.\n  # Поддерживается свободный формат ввода.\n  username: 79876543210\n\n  # Пароль для входа\n  password: super_password\n```\n\n## Использование компонента\n\n\u003e ℹ️ Каждый объект компонента обладает атрибутом `id`, указывающим\n\u003e на внутренний идентификатор объекта.\n\u003e \n\u003e От данной информации можно отталкиваться в автоматизациях.\n\n### Просмотр видео \u0026mdash; платформа `camera`\n\nНа данный момент реализовано потоковое видео и получение снимков (JPEG).\n\nДанная возможность является экспериментальной; при возникновении ошибок,\n[создайте issue](https://github.com/alryaz/hass-pik-intercom/issues/new).\n\n### Открытие дверей \u0026mdash; платформа `button`\n\nКомпонент открывает доступ к нескольким объектам на платформе `button`, соответствующим\nкнопкам открытия дверей, ассоциированных с домофоном.\n\nОдним из объектов является `button.last_call_session_unlocker`. Данный объект\nявляется вспомогательной абстракцией и позволяет выполнить открытие\nдомофонной двери, с панели которой был выполнен вызов.\n\nЧтобы открыть дверь домофона, достаточно воспользоваться службой `button.press`.\nБолее подробно почитать про действия объекта типа «кнопка» возможно в\n[официальной документации](https://www.home-assistant.io/integrations/button/).\n\n### Время звонка \u0026mdash; платформа `sensor`\n\nОбъекты с идентификаторами `sensor.last_call_session_\u003c...\u003e_at` являются\nотражением временных меток, заданных последней зарегистрированной сессии звонка:\n- `Created At` \u0026mdash; время создания записи о вызове\n- `Updated At` \u0026mdash; последние обновление данных о звонке\n- `Finished At` \u0026mdash; время завершения вызова (ответом, сбросом, или по времени)\n\n**_N.B._** Существует вероятность перехода объектов в состояние `unavailable` («недоступно»),\nесли API не выдаст информацию о звонке. Необходимо учитывать это в автоматизациях.\n\n### Статус звонка \u0026mdash; платформа `binary_sensor`\n\nОбъект с идентификатором `binary_sensor.last_call_session_active` отражает\nтекущее состояние звонка в дверь.\n\nЕсли производится звонок в дверь, объект меняет своё состояние с `off` на `on`.\nПо завершению звонка объект возвращает своё состояние с `on` на `off`.\n\n**_N.B._** Существует вероятность перехода объект в состояние `unavailable` («недоступно»),\nесли API не выдаст информацию о звонке. Необходимо учитывать это в автоматизациях.\n\n### Последний звонок в дверь \u0026mdash; платформа `sensor`\n\nОбъект обладает ID: `sensor.last_call_session`\n\nКомпонент предоставляет информацию о последнем зарегистрированном в системе звонке.\n\n### Счётчики \u0026mdash; платформа `sensor`\n\nКомпонент позволяет получить информацию о зарегистрированных счётчиках (пока что\nтолько ГВС/ХВС).\n\n**_N.B._** Если Вы обладаете счётчиками другого типа, [создайте issue](https://github.com/alryaz/hass-pik-intercom/issues/new).\nИх загрузка не гарантируется компонентом.\n\n## Отказ от ответственности\n\nДанное программное обеспечение никак не связано и не одобрено ПАО «ПИК СЗ», владельца\nторговой марки «ПИК Домофон». Используйте его на свой страх и риск. Автор ни при каких\nобстоятельствах не несёт ответственности за порчу или утрату вашего имущества и возможного\nвреда в отношении третьих лиц.\n\nВсе названия брендов и продуктов принадлежат их законным владельцам.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falryaz%2Fhass-pik-intercom","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falryaz%2Fhass-pik-intercom","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falryaz%2Fhass-pik-intercom/lists"}