{"id":15046069,"url":"https://github.com/koutnada/unipi-control","last_synced_at":"2025-03-16T10:21:37.262Z","repository":{"id":38095186,"uuid":"396287182","full_name":"koutnada/unipi-control","owner":"koutnada","description":"Control Unipi I/O directly with MQTT commands.","archived":false,"fork":false,"pushed_at":"2025-02-10T19:28:14.000Z","size":1389,"stargazers_count":8,"open_issues_count":7,"forks_count":5,"subscribers_count":3,"default_branch":"main","last_synced_at":"2025-02-10T21:36:28.914Z","etag":null,"topics":["home-assistant","home-automation","homeassistant","internet-of-things","iot","modbus","mqtt","python","smarthome","unipi"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/koutnada.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":"docs/supported-hardware.md","governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-08-15T08:59:36.000Z","updated_at":"2025-01-19T04:12:47.000Z","dependencies_parsed_at":"2024-06-13T03:23:26.285Z","dependency_job_id":"c4db1390-c813-4a73-8f34-39d99cb86ed9","html_url":"https://github.com/koutnada/unipi-control","commit_stats":null,"previous_names":["koutnada/unipi-control","superbox-dev/unipi-control"],"tags_count":33,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koutnada%2Funipi-control","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koutnada%2Funipi-control/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koutnada%2Funipi-control/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/koutnada%2Funipi-control/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/koutnada","download_url":"https://codeload.github.com/koutnada/unipi-control/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243853660,"owners_count":20358454,"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":["home-assistant","home-automation","homeassistant","internet-of-things","iot","modbus","mqtt","python","smarthome","unipi"],"created_at":"2024-09-24T20:52:40.074Z","updated_at":"2025-03-16T10:21:37.221Z","avatar_url":"https://github.com/koutnada.png","language":"Python","funding_links":["https://ko-fi.com/F2F0KXO6D"],"categories":[],"sub_categories":[],"readme":"![coverage-badge](https://raw.githubusercontent.com/superbox-dev/unipi-control/main/coverage.svg)\n[![CI](https://github.com/superbox-dev/unipi-control/actions/workflows/ci.yml/badge.svg?branch=main)](https://github.com/superbox-dev/unipi-control/actions/workflows/ci.yml)\n[![Version](https://img.shields.io/pypi/pyversions/unipi-control.svg)](https://pypi.python.org/pypi/unipi-control)\n\n[![license-url](https://img.shields.io/pypi/l/unipi-control.svg)](https://github.com/superbox-dev/unipi-control/blob/main/LICENSE)\n![PyPi downloads](https://img.shields.io/pypi/dm/unipi-control)\n![Typing: strict](https://img.shields.io/badge/typing-strict-green.svg)\n![Code style: black](https://img.shields.io/badge/code%20style-black-black)\n![Code style: Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/charliermarsh/ruff/main/assets/badge/v1.json)\n\n\u003c!-- pitch start --\u003e\n# Unipi Control\n\nUnipi Control use Modbus for fast access to the I/O and provide MQTT topics for reading and writing the circuits. Optionally you can enable the Home Assistant MQTT discovery for binary sensors, sensors, switches and covers.\n\u003c!-- pitch end --\u003e\n\n---\n\nFor more information please read the documentation at:\n[docs.superbox.one](https://docs.superbox.one)\n\n---\n\n\u003c!-- quickstart start --\u003e\n## Getting started\n\n### Recommended installation (only for Unipi Neuron)\n\nWe have a ready to use SD card image called [Unipi Control OS](https://github.com/superbox-dev/unipi-control-os).\n\n### Alternative installation with pip (Debian based systems)\n\n**Requirements:**\n\n* Unipi Neuron Kernel Module and Unipi tools (Use the officially APT mirror (https://repo.unipi.technology/debian/) from Unipi Technology)\n* Python \u003e= 3.8\n\nCreate a virtual environment:\n\n```bash\npython3 -m venv PATH_TO_VENV\n```\n\nActivate the virtual environment:\n\n```bash\nsource PATH_TO_VENV/bin/activate\n```\n\nInstall `unipi-control` with pip:\n\n```bash\npip install unipi-control\n```\n\nCopy the [config files](https://github.com/superbox-dev/unipi-control/data/opkg/data/local/etc/unipi) to `/etc/unipi` and configurate the `/etc/unipi/control.yaml`.\n\nCreate the systemd service `/etc/systemd/system/unipi-control.service` with following content:\n\n```ini\n[Unit]\nDescription=Unipi Control\nAfter=multi-user.target\n\n[Service]\nType=simple\nExecStart=PATH_TO_VENV/bin/unipi-control --log systemd\nEnvironment=PYTHONUNBUFFERED=1\n\n[Install]\nWantedBy=multi-user.target\n```\n\nEnable and start the systemd service:\n\n```bash\nsystemctl --system daemon-reload\nsystemctl enable unipi-control.service\nsystemctl start unipi-control.service\n```\n\u003c!-- quickstart end --\u003e\n\n## Changelog\n\nThe changelog lives in the [CHANGELOG.md](CHANGELOG.md) document. The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/).\n\n## Contributing\n\nWe're happy about your contributions to the project!\n\nYou can get started by reading the [CONTRIBUTING.md](CONTRIBUTING.md).\n\n\u003c!-- donation start --\u003e\n## Donation\n\nWe put a lot of time into this project. If you like it, you can support us with a donation.\n\n[![ko-fi](https://ko-fi.com/img/githubbutton_sm.svg)](https://ko-fi.com/F2F0KXO6D)\n\u003c!-- donation end --\u003e\n\n## Extras\n\nWe have a Home Assistant blueprint automation to control covers with binary sensors. Take a look in the [extras](data/extras) directory.\n\n\u003c!-- additional_info start --\u003e\n## Additional information\n\nThis is a third-party software for [Unipi Neuron](https://www.unipi.technology). This software **is NOT** from [Unipi Technology s.r.o.](https://www.unipi.technology). \n\u003c!-- additional_info end --\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoutnada%2Funipi-control","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkoutnada%2Funipi-control","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkoutnada%2Funipi-control/lists"}