{"id":15046067,"url":"https://github.com/fquinto/pywibeee","last_synced_at":"2025-10-25T18:30:23.354Z","repository":{"id":50611603,"uuid":"207860185","full_name":"fquinto/pywibeee","owner":"fquinto","description":"Command line interface (CLI) for WiBeee (old Mirubee) meter.","archived":false,"fork":false,"pushed_at":"2024-04-18T15:55:01.000Z","size":785,"stargazers_count":14,"open_issues_count":2,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-01-31T10:04:12.344Z","etag":null,"topics":["circutor","consumption","current-meter","electricity","energy-monitor","home-automation","homeassistant","meter","mirubee","power-meter","power-monitor","python","voltage-monitor","wibeee"],"latest_commit_sha":null,"homepage":"https://github.com/fquinto/pywibeee","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fquinto.png","metadata":{"files":{"readme":"README.rst","changelog":"CHANGELOG.md","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,"publiccode":null,"codemeta":null}},"created_at":"2019-09-11T16:41:41.000Z","updated_at":"2024-03-05T12:27:27.000Z","dependencies_parsed_at":"2022-08-28T14:53:03.220Z","dependency_job_id":"8c1c23b0-a2ce-4c5b-a237-e079962639c2","html_url":"https://github.com/fquinto/pywibeee","commit_stats":{"total_commits":22,"total_committers":3,"mean_commits":7.333333333333333,"dds":"0.13636363636363635","last_synced_commit":"86710b6df145f66283bda1e8083d4058e6faf56d"},"previous_names":[],"tags_count":4,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fquinto%2Fpywibeee","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fquinto%2Fpywibeee/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fquinto%2Fpywibeee/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fquinto%2Fpywibeee/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fquinto","download_url":"https://codeload.github.com/fquinto/pywibeee/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":238191638,"owners_count":19431461,"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":["circutor","consumption","current-meter","electricity","energy-monitor","home-automation","homeassistant","meter","mirubee","power-meter","power-monitor","python","voltage-monitor","wibeee"],"created_at":"2024-09-24T20:52:39.803Z","updated_at":"2025-10-25T18:30:17.686Z","avatar_url":"https://github.com/fquinto.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"\npywibeee\n========\n\nCommand line interface (CLI) for WiBeee (old Mirubee) meter.\n\nFeatures\n--------\n\n\n* Autodiscover the host (IP) of the meter in a network\n* Get version of the meter\n* Get model of the meter\n* Get info of the meter: (version + model + host)\n* Get status meter data\n* Get sensors of the meter\n* Action: reset energy counter\n* Action: reboot of the meter (via web or via special command)\n* Several outputs when recieve data: xml, json, file, plain text\n* 3 methods to get data: async_httpx, async_aiohttp, request\n\nRequirements\n------------\n\n``pip install xmltodict requests aiohttp httpx``\n\nInstallation\n------------\n\nInstall Python CLI package `pywibeee \u003chttps://pypi.org/project/pywibeee/\u003e`_\n\n``pip install pywibeee --upgrade``\n\nUsage\n-----\n\n.. code-block:: sh\n\n     pywibeee -h\n\n     usage: pywibeee [-h] [-version] (--host HOST | --auto) [-t SETTIMEOUT]\n                     [-o {xml,json,plain,file}]\n                     [-p {80}]\n                     [-m {async_httpx,async_aiohttp,request}]\n                     (-a {reboot,rebootweb,resetenergy} | -g {model,version,status,info,sensors})\n\n     CLI for WiBeee (old Mirubee) meter\n\n     optional arguments:\n       -h, --help            show this help message and exit\n       -version, --version   show program's version number and exit\n       --host HOST           The host (or the IP) of the meter.\n       --auto                Autodiscover host function, look IP on net.\n       -t SETTIMEOUT, --settimeout SETTIMEOUT\n                             set timeout in seconds (default 10)\n       -o {xml,json,plain,file}, --output {xml,json,plain,file}\n                             xml|json|plain|file\n       -a {reboot,rebootweb,resetenergy}, --action {reboot,rebootweb,resetenergy}\n                             reboot|rebootweb|resetenergy\n       -g {model,version,status,info,sensors}, --get {model,version,status,info,sensors}\n                             model|version|status|info|sensors\n       -p {portnumber}, --port {portnumber}\n                             port number of the meter (default 80)\n       -m {async_httpx, async_aiohttp, request}, --method {async_httpx, async_aiohttp, request}\n                             async_httpx|async_aiohttp|request\n                             (default async_httpx)\n\n     Enjoy! :)\n\nUse examples\n^^^^^^^^^^^^\n\nGet version\n~~~~~~~~~~~\n\n.. code-block:: sh\n\n   $ pywibeee --host 192.168.1.150 --get version\n   {\"response\": {\"webversion\": \"3.4.614\"}}\n\nGet model\n~~~~~~~~~\n\n.. code-block:: sh\n\n   $ pywibeee --host 192.168.1.150 --get model\n   {\"response\": {\"model\": \"WBB\", \"model_description\": \"Wibeee BOX\"}}\n\nGet info\n~~~~~~~~\n\n.. code-block:: sh\n\n   $ pywibeee --host 192.168.1.150 -g info\n   {\"response\": {\"model\": \"WBB\", \"model_description\": \"Wibeee BOX\", \"webversion\": \"3.4.614\", \"host\": \"192.168.1.150\"}}\n\nGet sensors with autodiscover\n~~~~~~~~~~~~~~~~~~~~~~~~~~~~~\n\n.. code-block:: sh\n\n   $ pywibeee --auto -g sensors\n   {\"vrms\": [\"Vrms\", \"V\", \"mdi:power-plug\"], \"irms\": [\"Irms\", \"A\", \"mdi:flash-auto\"], \"p_aparent\": [\"Apparent Power\", \"VA\", \"mdi:flash-circle\"], \"p_activa\": [\"Active Power\", \"W\", \"mdi:flash\"], \"p_reactiva_ind\": [\"Inductive Reactive Power\", \"VArL\", \"mdi:flash-outline\"], \"p_reactiva_cap\": [\"Capacitive Reactive Power\", \"VArC\", \"mdi:flash-outline\"], \"frecuencia\": [\"Frequency\", \"Hz\", \"mdi:current-ac\"], \"factor_potencia\": [\"Power Factor\", \" \", \"mdi:math-cos\"], \"energia_activa\": [\"Active Energy\", \"Wh\", \"mdi:pulse\"], \"energia_reactiva_ind\": [\"Inductive Reactive Energy\", \"VArLh\", \"mdi:alpha-e-circle-outline\"], \"energia_reactiva_cap\": [\"Capacitive Reactive Energy\", \"VArCh\", \"mdi:alpha-e-circle-outline\"], \"angle\": [\"Angle\", \"\\u00b0\", \"mdi:angle-acute\"], \"thd_total\": [\"THD Current\", \"%\", \"mdi:chart-bubble\"], \"thd_fund\": [\"THD Current (fundamental)\", \"A\", \"mdi:vector-point\"], \"thd_ar3\": [\"THD Current Harmonic 3\", \"A\", \"mdi:numeric-3\"], \"thd_ar5\": [\"THD Current Harmonic 5\", \"A\", \"mdi:numeric-5\"], \"thd_ar7\": [\"THD Current Harmonic 7\", \"A\", \"mdi:numeric-7\"], \"thd_ar9\": [\"THD Current Harmonic 9\", \"A\", \"mdi:numeric-9\"], \"thd_tot_V\": [\"THD Voltage\", \"%\", \"mdi:chart-bubble\"], \"thd_fun_V\": [\"THD Voltage (fundamental)\", \"V\", \"mdi:vector-point\"], \"thd_ar3_V\": [\"THD Voltage Harmonic 3\", \"V\", \"mdi:numeric-3\"], \"thd_ar5_V\": [\"THD Voltage Harmonic 5\", \"V\", \"mdi:numeric-5\"], \"thd_ar7_V\": [\"THD Voltage Harmonic 7\", \"V\", \"mdi:numeric-7\"], \"thd_ar9_V\": [\"THD Voltage Harmonic 9\", \"V\", \"mdi:numeric-9\"]}\n\nGet status\n~~~~~~~~~~\n\n.. code-block:: sh\n\n   $ pywibeee --host 192.168.1.150 --get status\n   {\"response\": {\"model\": \"WBB\", \"webversion\": \"3.4.614\", \"time\": \"1570484447\", \"fase1_vrms\": \"228.70\", \"fase1_irms\": \"1.59\", \"fase1_p_aparent\": \"362.65\", \"fase1_p_activa\": \"264.34\", \"fase1_p_reactiva_ind\": \"0.00\", \"fase1_p_reactiva_cap\": \"248.27\", \"fase1_frecuencia\": \"50.08\", \"fase1_factor_potencia\": \"-0.729\", \"fase1_energia_activa\": \"222157\", \"fase1_energia_reactiva_ind\": \"4631\", \"fase1_energia_reactiva_cap\": \"188269\", \"fase1_angle\": \"0.00\", \"fase1_thd_total\": \"64.60\", \"fase1_thd_fund\": \"1.40\", \"fase1_thd_ar3\": \"0.60\", \"fase1_thd_ar5\": \"0.50\", \"fase1_thd_ar7\": \"0.40\", \"fase1_thd_ar9\": \"0.40\", \"fase1_thd_tot_V\": \"0.00\", \"fase1_thd_fun_V\": \"228.50\", \"fase1_thd_ar3_V\": \"0.00\", \"fase1_thd_ar5_V\": \"0.00\", \"fase1_thd_ar7_V\": \"0.00\", \"fase1_thd_ar9_V\": \"0.00\", \"fase2_vrms\": \"228.70\", \"fase2_irms\": \"0.34\", \"fase2_p_aparent\": \"76.77\", \"fase2_p_activa\": \"50.99\", \"fase2_p_reactiva_ind\": \"0.00\", \"fase2_p_reactiva_cap\": \"0.00\", \"fase2_frecuencia\": \"50.08\", \"fase2_factor_potencia\": \"-0.664\", \"fase2_energia_activa\": \"47714\", \"fase2_energia_reactiva_ind\": \"5021\", \"fase2_energia_reactiva_cap\": \"641\", \"fase2_angle\": \"0.00\", \"fase2_thd_total\": \"0.00\", \"fase2_thd_fund\": \"0.00\", \"fase2_thd_ar3\": \"0.00\", \"fase2_thd_ar5\": \"0.00\", \"fase2_thd_ar7\": \"0.00\", \"fase2_thd_ar9\": \"0.00\", \"fase2_thd_tot_V\": \"0.00\", \"fase2_thd_fun_V\": \"228.50\", \"fase2_thd_ar3_V\": \"0.00\", \"fase2_thd_ar5_V\": \"0.00\", \"fase2_thd_ar7_V\": \"0.00\", \"fase2_thd_ar9_V\": \"0.00\", \"fase3_vrms\": \"228.70\", \"fase3_irms\": \"1.53\", \"fase3_p_aparent\": \"349.48\", \"fase3_p_activa\": \"265.40\", \"fase3_p_reactiva_ind\": \"0.00\", \"fase3_p_reactiva_cap\": \"227.37\", \"fase3_frecuencia\": \"50.08\", \"fase3_factor_potencia\": \"0.759\", \"fase3_energia_activa\": \"187069\", \"fase3_energia_reactiva_ind\": \"196\", \"fase3_energia_reactiva_cap\": \"159927\", \"fase3_angle\": \"0.00\", \"fase3_thd_total\": \"66.10\", \"fase3_thd_fund\": \"1.30\", \"fase3_thd_ar3\": \"0.60\", \"fase3_thd_ar5\": \"0.50\", \"fase3_thd_ar7\": \"0.40\", \"fase3_thd_ar9\": \"0.00\", \"fase3_thd_tot_V\": \"0.00\", \"fase3_thd_fun_V\": \"228.50\", \"fase3_thd_ar3_V\": \"0.00\", \"fase3_thd_ar5_V\": \"0.00\", \"fase3_thd_ar7_V\": \"0.00\", \"fase3_thd_ar9_V\": \"0.00\", \"fase4_vrms\": \"228.70\", \"fase4_irms\": \"3.45\", \"fase4_p_aparent\": \"788.90\", \"fase4_p_activa\": \"49.93\", \"fase4_p_reactiva_ind\": \"0.00\", \"fase4_p_reactiva_cap\": \"20.90\", \"fase4_frecuencia\": \"50.08\", \"fase4_factor_potencia\": \"-0.063\", \"fase4_energia_activa\": \"456941\", \"fase4_energia_reactiva_ind\": \"9849\", \"fase4_energia_reactiva_cap\": \"348839\", \"scale\": \"100\", \"coilStatus\": null, \"ground\": \"0.00\", \"model_description\": \"Wibeee BOX\"}}\n\nNotes\n-----\n\n\n* Default IP for WiBeee (old Mirubee): 192.168.1.150\n* Default usernames / passwords:\n\n  * Basic: ``user / user``\n  * Admin: ``admin / Sm1l1cs?``\n  * Admin another: ``admin / Wib333?``\n\n* MAC Address: 00:1E:C0 (Microchip Technology)\n\nOTA comands\n^^^^^^^^^^^\n\n\n* 21001A 576246696E697368426F6F746C6F6164657250726F6363657373 0D0A (hex) = ``WbStartBootloaderProccess`` = CHANGE_PORT_COMMAND_INIT\n* 200119 576246696e697368426f6f746c6f6164657250726f6363657373 0D0A (hex) = ``WbFinishBootloaderProccess`` = CHANGE_PORT_COMMAND_FINAL\n* 0D (hex) = Enter key = get version\n* 0F (hex) = read Backup Position\n* 01 (hex) = reset\n\nLast firmware\n^^^^^^^^^^^^^\n\n\n* We have a folder with firmware on it: `firmware \u003cfirmware/\u003e`_ and a `firmware finder downloader \u003cfirmware/download_check.py\u003e`_\n\nTools for firmware and App investigation\n^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^\n\n\n* Emulator of WiBeee product: `emulator \u003cemulator/\u003e`_\n* Cloud server for WiBeee called webserver: `webserver \u003cwebserver/\u003e`_\n\nWith this tools you can \"play\" with the firmware and the app.\n\nOpen ports\n^^^^^^^^^^\n\n.. code-block::\n\n   80/tcp  open http      Microchip Libraries of Applications TCP/IP Stack httpd\n   502/tcp open modbus    Modbus TCP\n   550/tcp open new-rwho?\n\nModels description WiBeee\n-------------------------\n\n\n* WBM = Wibeee 1Ph\n* WBT = Wibeee 3Ph\n* WMX = Wibeee MAX\n* WTD = Wibeee 3Ph RN\n* WX2 = Wibeee MAX 2S\n* WX3 = Wibeee MAX 3S\n* WXX = Wibeee MAX MS\n* WBB = Wibeee BOX\n* WB3 = Wibeee BOX S3P\n* W3P = Wibeee 3Ph 3W\n* WGD = Wibeee GND\n* WBP = Wibeee SMART PLUG\n\nInstallation alternatives (getting latest source code)\n------------------------------------------------------\n\n  If you want to install latest source code:\n\n  ``pip install git+http://github.com/fquinto/pywibeee``\n\n  or\n\n.. code-block:: sh\n\n   git clone git://github.com/fquinto/pywibeee\n   cd pywibeee\n   python setup.py install\n\nChangelog\n---------\n\n\n* See file CHANGELOG.md: `CHANGELOG.md \u003cCHANGELOG.md\u003e`_\n\nFuture development\n------------------\n\n\n* Improve another models.\n\nLicense\n-------\n\nGNU General Public License version 2\n\n\n* https://www.gnu.org/licenses/old-licenses/gpl-2.0.html\n* https://choosealicense.com/licenses/gpl-2.0/\n* https://opensource.org/licenses/GPL-2.0\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffquinto%2Fpywibeee","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffquinto%2Fpywibeee","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffquinto%2Fpywibeee/lists"}