{"id":14985277,"url":"https://github.com/home-assistant-ecosystem/python-dingz","last_synced_at":"2025-04-10T23:50:38.907Z","repository":{"id":45610768,"uuid":"230010732","full_name":"home-assistant-ecosystem/python-dingz","owner":"home-assistant-ecosystem","description":"Python API for interacting with Dingz devices","archived":false,"fork":false,"pushed_at":"2023-02-16T21:59:33.000Z","size":73,"stargazers_count":2,"open_issues_count":0,"forks_count":3,"subscribers_count":2,"default_branch":"dev","last_synced_at":"2024-05-21T19:27:21.950Z","etag":null,"topics":["dingz","home-assistant","iot","python3","smart-home"],"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/home-assistant-ecosystem.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.rst","contributing":null,"funding":null,"license":"LICENSE","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":"2019-12-24T22:44:48.000Z","updated_at":"2021-12-15T22:25:16.000Z","dependencies_parsed_at":"2024-02-09T08:47:13.700Z","dependency_job_id":null,"html_url":"https://github.com/home-assistant-ecosystem/python-dingz","commit_stats":{"total_commits":88,"total_committers":5,"mean_commits":17.6,"dds":"0.18181818181818177","last_synced_commit":"226ccc23b42f0202b7a9380751701943af40b337"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/home-assistant-ecosystem%2Fpython-dingz","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/home-assistant-ecosystem%2Fpython-dingz/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/home-assistant-ecosystem%2Fpython-dingz/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/home-assistant-ecosystem%2Fpython-dingz/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/home-assistant-ecosystem","download_url":"https://codeload.github.com/home-assistant-ecosystem/python-dingz/tar.gz/refs/heads/dev","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248317707,"owners_count":21083528,"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":["dingz","home-assistant","iot","python3","smart-home"],"created_at":"2024-09-24T14:10:38.521Z","updated_at":"2025-04-10T23:50:38.891Z","avatar_url":"https://github.com/home-assistant-ecosystem.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"python-dingz\n============\n\nPython API for interacting with `Dingz \u003chttps://dingz.ch\u003e`_ devices.\n\nThis module is not official, developed, supported or endorsed by iolo AG or\nmyStrom AG. For questions and other inquiries, use the issue tracker in this\nrepository please.\n\nWithout the support of iolo AG and myStrom AG it would have taken much longer\nto create this module which is the base for the integration into\n`Home Assistant \u003chttps://home-assistant.io\u003e`_. Both companies have provided\nand are still providing hardware, valuable feedback and advice. Their\ncontinuous support make further development of this module possible.\n\nSee `api.dingz.ch \u003chttps://api.dingz.ch/\u003e`_ for the API details.\n\nLimitations\n-----------\n\nThis module is at the moment limited to consuming sensor data, device details,\ndevice configurations and states.\nThe front LED can be controlled but buttons requires you to programm them by\nyourself.\n\nNo support for setting timers and schedules.\n\nRequirements\n------------\n\nYou need to have `Python 3 \u003chttps://www.python.org\u003e`_ installed.\n\n- `dingz \u003chttps://dingz.ch\u003e`_ device\n- Network connection\n- Devices connected to your network\n\nYou need to know the IP address of the devices. Please consult your router\ndocumentation to get this information or use the `dingz` CLI tool.\n\nInstallation\n------------\n\nThe package is available in the `Python Package Index \u003chttps://pypi.python.org/\u003e`_ .\n\n.. code:: bash\n\n    $ pip install dingz\n\nOn a Fedora-based system or on a CentOS/RHEL machine which has EPEL enabled.\n\n.. code:: bash\n\n    $ sudo dnf -y install python3-dingz\n\nFor Nix or NixOS users is a package available. Keep in mind that the lastest releases might only\nbe present in the ``unstable`` channel.\n\n.. code:: bash\n\n    $ nix-env -iA nixos.python3Packages.dingz\n\nModule usage\n------------\n\nEvery unit has its own web interface: `http://IP_ADDRESS \u003chttp://IP_ADDRESS\u003e`_ .\n\nSee `example.py` for detail about module.\n\n\nHow to operate shades / dimmers\n-------------------------------\n\n.. code:: python\n\n    d = Dingz(\"ip_address_or_host\")\n    # Fetch config, this has to be done once to fetch all details about the shades/dimmers\n    await d.get_devices_config()\n\n    # Fetch the current state of the lights/vers\n    await d.get_state()\n\n    # Get details about shade\n    shade_0 = d.shades.get(0)\n    print(\"Blinds: %s Lamella: %s\" % (shade_0.current_blind_level(), shade_0.current_lamella_level()))\n\n    # Operate shade\n    shade_0.shade_down()\n\n    # Turn on light\n    d.dimmers.get(2).turn_on(brightness_pct=70)\n\n\nCLI usage\n---------\n\nThe package contains a command-line tool which support some basic tasks.\n\n.. code:: bash\n\n   $ dingz discover\n\n\nLicense\n-------\n\n``python-dingz`` is licensed under ASL 2.0, for more details check LICENSE.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhome-assistant-ecosystem%2Fpython-dingz","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fhome-assistant-ecosystem%2Fpython-dingz","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fhome-assistant-ecosystem%2Fpython-dingz/lists"}