{"id":13604947,"url":"https://github.com/danielperna84/pyhomematic","last_synced_at":"2025-04-12T02:32:25.610Z","repository":{"id":45086702,"uuid":"50591651","full_name":"danielperna84/pyhomematic","owner":"danielperna84","description":"Python 3 Interface to interact with Homematic devices","archived":true,"fork":false,"pushed_at":"2024-02-04T17:04:59.000Z","size":785,"stargazers_count":90,"open_issues_count":0,"forks_count":109,"subscribers_count":21,"default_branch":"master","last_synced_at":"2024-05-01T13:44:55.050Z","etag":null,"topics":["eq3","hass","home-automation","homematic","python3"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":false,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/danielperna84.png","metadata":{"files":{"readme":"README.rst","changelog":"changelog.txt","contributing":".github/CONTRIBUTING.md","funding":null,"license":"LICENSE.txt","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,"publiccode":null,"codemeta":null}},"created_at":"2016-01-28T15:18:57.000Z","updated_at":"2024-06-11T01:55:59.133Z","dependencies_parsed_at":"2024-06-11T01:55:58.455Z","dependency_job_id":"c9474a37-4d94-4ea8-a64a-65d8b4b3d1c9","html_url":"https://github.com/danielperna84/pyhomematic","commit_stats":{"total_commits":713,"total_committers":59,"mean_commits":"12.084745762711865","dds":"0.29593267882187935","last_synced_commit":"74121b288bc8f80be5f12505bb64286ab81a93ad"},"previous_names":[],"tags_count":86,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielperna84%2Fpyhomematic","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielperna84%2Fpyhomematic/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielperna84%2Fpyhomematic/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/danielperna84%2Fpyhomematic/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/danielperna84","download_url":"https://codeload.github.com/danielperna84/pyhomematic/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":223489709,"owners_count":17153809,"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":["eq3","hass","home-automation","homematic","python3"],"created_at":"2024-08-01T19:00:52.988Z","updated_at":"2024-11-07T09:31:19.824Z","avatar_url":"https://github.com/danielperna84.png","language":"Python","funding_links":[],"categories":["Software Modules"],"sub_categories":[],"readme":"Deprecation warning\n===================\n\nThis project is being deprecated in favour of the new integration (https://github.com/danielperna84/custom_homematic) based on hahomematic (https://github.com/danielperna84/hahomematic).  \n\nIf you are a user of the RaspberryMatic add-on, please follow these very detailed instructions to install the new integration as a custom component: https://github.com/jens-maus/RaspberryMatic/wiki/HomeAssistant-Integration  \n\nLess detailed instructions also suitable for other installation types: https://github.com/danielperna84/custom_homematic/wiki/Installation  \n\nEssentially the process is the same. When using a real CCU or RaspberryMatic Home Assistants auto-discovery may already detect your hub-device and you only have to provide credentials.\n\nIf you encounter problems with the new integration, please report them in the hahomematic repository.  \n\nIf you add a new device to your CCU and don't see the name you have set reflected in Home Assistant, please follow these instructions: https://github.com/danielperna84/hahomematic/wiki/Howto's\n\nOther interesting information can be found here: https://github.com/danielperna84/hahomematic/tree/devel/docs\n\npyhomematic\n===========\n.. image:: https://travis-ci.org/danielperna84/pyhomematic.svg?branch=master\n    :target: https://travis-ci.org/danielperna84/pyhomematic\n\nPython 3 Interface to interact with Homematic devices.\n\nImportant: This project will be deprecated in favor of https://github.com/danielperna84/hahomematic at some point in the future. A custom component to work with hahomematic can be found here: https://github.com/danielperna84/custom_homematic. Feel free to contribute!\n\nThis library provides easy (bi-directional) control of Homematic devices hooked up to a regular CCU or Homegear. The focus is to be able to receive events. If you are only interested in actively controlling devices, you can use the Python-built-in xmlrpc.client.ServerProxy (Python 3). See pyhomematic._server.ServerThread.connect on how to connect to a CCU / Homegear as a client.\n\nIncluded is a XML-RPC server to receive events emitted by devices. Multiple callback functions can be set for devices to handle events. You can choose to bequeath callbacks from devices to their channels or not. Channels can not bequeath to their parent devices. You can also pass a callback funtion when creating the server, which then will (additionally) receive all events emitted by any paired device.\n\nYou may specify a devicefile (JSON) to store known devices. This might speed up startup a bit. If you don't, paired devices will always be propagated upon startup. If devices get paired while the server is running, they should be automatically detected and usable. To get notified about such events, it is possible to pass a systemcallback(source, *args)-function while creating the server.\n\nCompatibility currently is only given for Python 3, since this library is primarily intended to add Homematic to https://home-assistant.io/, wich is written in Python 3.\n\nAs of now, usage is as follows (you could leave away the listening and remote addresses when everything is running on one machine):\n    \u003e\u003e\u003e def syscb(src, *args):\n    \u003e\u003e\u003e     print(src)\n    \u003e\u003e\u003e     for arg in args:\n    \u003e\u003e\u003e         print(arg)\n    \u003e\u003e\u003e def cb1(address, interface_id, key, value):\n    \u003e\u003e\u003e     print(\"CALLBACK WITH CHANNELS: %s, %s, %s, %s\" % (address, interface_id, key, value))\n    \u003e\u003e\u003e def cb2(address, interface_id, key, value):\n    \u003e\u003e\u003e     print(\"CALLBACK WITHOUT CHANNELS: %s, %s, %s, %s\" % (address, interface_id, key, value))\n    \u003e\u003e\u003e from pyhomematic import HMConnection\n    \u003e\u003e\u003e pyhomematic = HMConnection(local=\"192.168.1.12\", localport=7080, remote=\"192.168.1.23\", remoteport=2001, systemcallback=syscb) # Create server thread\n    \u003e\u003e\u003e pyhomematic.start() # Start server thread, connect to homegear, initialize to receive events\n    \u003e\u003e\u003e pyhomematic.devices['address_of_rollershutter_device'].move_down() # Move rollershutter down\n    \u003e\u003e\u003e pyhomematic.devices_all['address_of_doorcontact:1'].getValue(\"STATE\") # True or False, depending on state\n    \u003e\u003e\u003e pyhomematic.devices['address_of_doorcontact'].setEventCallback(cb1) # Add first callback\n    \u003e\u003e\u003e pyhomematic.devices['address_of_doorcontact'].setEventCallback(cb2, bequeath=False) # Add second callback\n    \u003e\u003e\u003e pyhomematic.stop() # Shutdown to finish the server thread and quit\n\nThis example connects to the Homegear-server running on the same machine, closes the window shutter using the rollershutter device, queries the state of a door contact, adds callbacks for the door contact, then stops the server thread because a sample doesn't need to do more. The server has to be stopped because otherwise Python might hang.\nAn example.py can be found at https://github.com/danielperna84/pyhomematic\n\nTheoretically all Homematic devices will be automatically detected and directly provide the getValue and setValue methods needed to perform any action.\nAdditionally, implemented devices provide convenience-properties and methods to perform certain tasks.\n\nFor more information visit the Wiki: https://github.com/danielperna84/pyhomematic/wiki\n\nIf pyhomematic doesn't seem to be what you need to interact with your CCU, then https://github.com/LarsMichelsen/pmatic might be (if Homegear support is not required).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielperna84%2Fpyhomematic","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdanielperna84%2Fpyhomematic","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdanielperna84%2Fpyhomematic/lists"}