{"id":23191388,"url":"https://github.com/dashio-connect/python-dashio","last_synced_at":"2025-06-18T18:38:49.888Z","repository":{"id":50449572,"uuid":"271683347","full_name":"dashio-connect/python-dashio","owner":"dashio-connect","description":"Python library to create dashboards with the Dash App","archived":false,"fork":false,"pushed_at":"2025-05-08T04:02:59.000Z","size":2338,"stargazers_count":8,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-06-09T13:53:55.345Z","etag":null,"topics":["charts","dashboards","dashio","dial","graphs","iot","iot-platform","knobs","logging","maps","mobile","mobile-app","monitoring","monitoring-tool","mqtt","notifications","python","remote-access-tool","remote-control","slider"],"latest_commit_sha":null,"homepage":"https://dashio.io","language":"Python","has_issues":true,"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/dashio-connect.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","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,"zenodo":null}},"created_at":"2020-06-12T01:43:17.000Z","updated_at":"2025-05-08T04:02:37.000Z","dependencies_parsed_at":"2023-10-15T05:44:11.186Z","dependency_job_id":"205a8848-45e5-4055-a103-ce43c4fab9e7","html_url":"https://github.com/dashio-connect/python-dashio","commit_stats":null,"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"purl":"pkg:github/dashio-connect/python-dashio","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dashio-connect%2Fpython-dashio","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dashio-connect%2Fpython-dashio/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dashio-connect%2Fpython-dashio/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dashio-connect%2Fpython-dashio/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dashio-connect","download_url":"https://codeload.github.com/dashio-connect/python-dashio/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dashio-connect%2Fpython-dashio/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":260611276,"owners_count":23036307,"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":["charts","dashboards","dashio","dial","graphs","iot","iot-platform","knobs","logging","maps","mobile","mobile-app","monitoring","monitoring-tool","mqtt","notifications","python","remote-access-tool","remote-control","slider"],"created_at":"2024-12-18T12:17:09.151Z","updated_at":"2025-06-18T18:38:44.871Z","avatar_url":"https://github.com/dashio-connect.png","language":"Python","readme":"# python-dashio\n\n[![](https://img.shields.io/discord/1313341785430429747?color=5865F2\u0026logo=Discord\u0026style=flat-square)](https://discord.gg/fqvhNV3GQB)\n![Tests](https://github.com/dashio-connect/python-dashio/actions/workflows/tests.yml/badge.svg)\n\n**[python-dashio](https://github.com/dashio-connect/python-dashio)** - Create beautiful mobile dashboards for your python project. The python-dashio library allows easy setup of controls such as Dials, Text Boxes, Charts, Graphs, and Notifications. You can define the look and layout of the controls on your phone from your python code. There are three methods to connect to your phone; Bluetooth Low Energy (BLE - on supported platforms), TCP, and MQTT via the dash.dashio.io server.\n\n## Getting Started\n\n* For the big picture on **DashIO**, take a look at our website: [dashio.io](https://dashio.io)\n\n* Create an account on [dash.dashio.io](https://dashio.io/account-create/)\n\n* Get the App:\n\nApple              | Android\n:-----------------:|:------------------:\n[\u003cimg src=https://raw.githubusercontent.com/dashio-connect/python-dashio/master/Documents/download-on-the-app-store.svg width=200\u003e](\u003chttps://apps.apple.com/us/app/dash-iot/id1574116689\u003e) | [\u003cimg src=https://raw.githubusercontent.com/dashio-connect/python-dashio/master/Documents/Google_Play_Store_badge_EN.svg width=223\u003e](\u003chttps://play.google.com/store/apps/details?id=com.dashio.dashiodashboard\u003e)\n\n## Discord Community\n\nBe a part of the DashIO community by joining our [Discord Server](https://discord.gg/fqvhNV3GQB)\n\n## Documentation\n\nFor all documentation and software guides: [dashio.io/documents](https://dashio.io/documents)\n\nFor the **DashIO** Python guide: [dashio.io/guide-python](https://dashio.io/guide-python)\n\nFor the **DashIO** Python library: [dashio.io/python-library](\"https://dashio.io/python-library/)\n\n## Examples\n\nThere are plenty of examples in the github repository under the Examples directory.\n\n## Dash IoT Application\n\nThe **Dash** app is free and available for both Apple and Android devices. Use it to create beautiful and powerful user interfaces to you IoT devices.\n\nDashio Phone               |  Dashio Tablet\n:-------------------------:|:-------------------------:\n\u003cimg src=\"https://dashio.io/wp-content/uploads/2020/11/IMG_4154.jpeg\" width=\"150\" /\u003e | \u003cimg src=\"https://dashio.io/wp-content/uploads/2020/12/IMG_4203.jpeg\" width=\"450\" /\u003e\n\n## Requirements\n\n* python3.6 and above\n* paho-mqtt\n* pyzmq\n* python-dateutil\n* zeroconf\n* shortuuid\n\n## Install\n\n`pip3 install dashio`\n\nOr\n\n```sh\ngit clone https://github.com/dashio-connect/python-dashio.git\ncd python-dashio\npip3 install .\n```\n\n## A Quick Guide\n\nThis guide covers the **DashIO** python library. For information on the [***Dash***](https://dashio.io/dashboard) phone app please visit the website.\n\n### Basics\n\nSo what is **DashIO**? It is a quick effortless way to connect your IoT device to your phone. It allows easy setup of controls such as Dials, Text Boxes, Maps, Graphs, Notifications..., from your Device. You can define the look and layout of the controls on your phone from your IoT device. There are three methods to connect to your phone tcp, mqtt, dash, and BLE. What's Dash then? Dash is a mqtt server with extra bits added in to allow you to send notifications, share your devices, and save your settings from your phone via the **Dash** app.\n\nShow me some code.\n\n```python\n# Examples/ex01.py\nimport dashio\nimport random\nimport time\n\ndevice = dashio.Device(\"aDeviceType\", \"aDeviceID\", \"aDeviceName\")\ntcp_con = dashio.TCPConnection()\ntcp_con.add_device(device)\nfirst_dial_control = dashio.Dial(\"FirstDial\")\ndevice.add_control(first_dial_control)\n\nwhile True:\n    first_dial_control.dial_value = random.random() * 100\n    time.sleep(5)\n```\n\nThis is about the fewest lines of code to get talking to the app. There is a lot happening under the hood to make this work. After the import we create a device with three attributes:\n\n* \"aDeviceType\": a common name device_type for all IoT devices using this code which is used for device discovery\n* \"aDeviceID\": a device_ID to uniquely identify this device, preferably a UUID.\n* \"aDeviceName\": The name of this device, which can be changed at any time.\n\nThese attributes describe the device to the app and allow you to distinguish one of your devices from another.\n\nThe next two lines create a TCP connection and then add the device to the connection. This device is discoverable by the Dash app. You can also discover your IoT device using a third party Bonjour/Zeroconf discovery tool. The mDNS service will be \"DashIO.tcp.\"\n\nThough this device is discoverable by the app it would be nice to have the DashIO app automatically setup a new DeviceView and place your control on the new DeviceView. To do that we need to add a few more lines of code:\n\n```python\n# Examples/ex02.py\nimport dashio\nimport random\nimport time\n\ndevice = dashio.Device(\"aDeviceType\", \"aDeviceID\", \"aDeviceName\")\ntcp_con = dashio.TCPConnection()\ntcp_con.add_device(device)\nfirst_dial_control = dashio.Dial(\"FirstDial\", control_position=dashio.ControlPosition(0.24, 0.36, 0.54, 0.26))\ndevice.add_control(first_dial_control)\n\ndv_dial = dashio.DeviceView(\"aDeviceViewID\", \"A Dial\")\ndv_dial.add_control(first_dial_control)\ndevice.add_control(dv_dial)\n\nwhile True:\n    first_dial_control.dial_value = random.random() * 100\n    time.sleep(5)\n```\n\nFirst we altered the instantiation of a Dial by including a control_position. This allows us to place the control at a set location. The added lines instantiated a DeviceView control, which we than added the dial control. Finally we added the DeviceView to the device.\n\nThe next piece of the puzzle to consider is how do we get data from the DashIO app? Lets add a Knob and connect it to the Dial:\n\n```python\n# Examples/ex03.py\nimport dashio\nimport time\n\ndevice = dashio.Device(\"aDeviceType\", \"aDeviceID\", \"aDeviceName\")\ntcp_con = dashio.TCPConnection()\ntcp_con.add_device(device)\nfirst_dial_control = dashio.Dial(\"FirstDial\", control_position=dashio.ControlPosition(0.24, 0.36, 0.54, 0.26))\ndevice.add_control(first_dial_control)\n\ndv = dashio.DeviceView(\"aDeviceViewID\", \"A Dial\")\ndv.add_control(first_dial_control)\ndevice.add_control(dv)\n\ndef knob_event_handler(msg):\n    first_dial_control.dial_value = float(msg[3])\n\naknob = dashio.Knob(\"aKNB\", control_position=dashio.ControlPosition(0.24, 0.14, 0.54, 0.26))\naknob.add_receive_message_callback += knob_event_handler\ndv.add_control(aknob)\ndevice.add_control(aknob)\n\nwhile True:\n    time.sleep(1)\n```\n\nFirst we added a function that sets the dial value. Next we added a Knob control and added our new function to be called when it receives data from the DashIO app. We also add it to the DeviceView and to the device. Now when the knob in the DashIO app is moved the dial is set to the same value.\n\n### Using the Config64\n\nThe **Dash** app can generate a CFG64 text string that defines the controls, the controls layout, and device parameters for the Device. The CFG64 string can be used in a number of ways. If we run the example above and using the **Dash** app to export a layout we can use the layout to setup the device and controls.\n\n```python\n# Examples/ex04.py\nimport dashio\nimport time\n\ncfg64 =\"jVTbjpswEP2VlZ9RlWS7qcQbhJCNwiUCN6lU9YEFb7ACdmrMJukq/94xhpCbqr4NZ8bj4zlz+ETOPELmz18GmrgzZH4iVpcO+aAp\"\\\n    \"WVGyr5A5NFDWfMdE1jtkImSg9H0TkQ/InQy0CEIbGnyilDMpeDF3oCZZBDbU5YRuchklknJkDr6MxgaSVBZkySsKGINKO8Q49FGb\"\\\n    \"AMB6WjD+BkBFWBay4hiyiBQkqSApRU0MVFI4OICCnO99yvzkgMz3pKggJUi2SooaSr+9GGiXCMKkJtS/Cb7hSTQpfJ6pC93Q88I1\"\\\n    \"YIeOVk/4q4H2NJP5GXkBZAv8JrzgAg5HJGu7dYitrgdy8tg8Jwgj3/IAON51H0KvUpEfDgYnJYDXKhF7ThtZK0cHvrXUgY1nbeRP\"\\\n    \"g+86wtMfWEee7enAWa3WWhUpztTWOZXkKS759pKhbcXziRIVKm0uMiIe128EzSBTlwy2YjQyrgW/mS+FZJCUqn/8uwYdrhR2YF7d\"\\\n    \"jdsNy/rZJelWUcvhhL6rE13VYtXA5ofb8sscFgmrGuHTY7Ml56QLdGP6BxgMxxqGzenBEdTC7p9fOLzgd9/0hoGaTcSVXZ5HSkov\"\\\n    \"nLWmeo1wJ+oER52GOGhlmlteI9NOkJRWjSUG15N1qahkOzDg90bEhXu8qYsvpFzOp+ifa9+tW2+iHadM9pK321szKivt9QcevnaZ\"\\\n    \"Wn6XFuct05b4D5+3j3psu3u7PI8fmfHuJ6DGj2fR8lVN+PQX\"\n\nconfig_dict = dashio.decode_cfg64(cfg64)\ndevice = dashio.Device(\"aDeviceType\", \"aDeviceID\", \"aDeviceName\", cfg_dict=config_dict)\ntcp_con = dashio.TCPConnection()\ntcp_con.add_device(device)\n\naknob: dashio.Knob = device.get_control(dashio.ControlName.KNOB, \"aKNB\")\nfirst_dial_control: dashio.Dial = device.get_control(dashio.ControlName.DIAL, \"FirstDial\")\n\ndef knob_event_handler(msg):\n    aknob.knob_dial_value = float(msg[3])\n    first_dial_control.dial_value = float(msg[3])\n\naknob.add_receive_message_callback(knob_event_handler)\n\nwhile True:\n    time.sleep(1)\n```\n\nWe've added the cfg64 string. Then decoded it with *dashio.decode_cfg64(cfg64)*. This function returns a dictionary that we can pass into Device so that it can to instantiate and add the controls.\n\nIncluded in the library are two commandline utilities to encode and decode cfg64 files.\n\n```sh\n$ c64_decode -h\nusage: c64_decode [-h] [-p] [-o OUT_FILE] [-i INDENT] file\n\npositional arguments:\n  file                  Input file name.\n\noptions:\n  -h, --help            show this help message and exit\n  -p, --print           Print output.\n  -o OUT_FILE, --out OUT_FILE\n                        output filename.\n  -i INDENT, --indent INDENT\n                        Indent depth (Default 4).\n```\n\nAnd\n\n```sh\n$ c64_encode -h\nusage: c64_encode [-h] [-f FORMAT] [-o OUT_FILE] [-w WIDTH] file\n\npositional arguments:\n  file                  Input file name.\n\noptions:\n  -h, --help            show this help message and exit\n  -f FORMAT, --format FORMAT\n                        Format output. Options: 'None', 'C', 'Python'.\n  -o OUT_FILE, --out OUT_FILE\n                        output filename.\n  -w WIDTH, --width WIDTH\n                        Width of formatted output (Default 80).\n```\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdashio-connect%2Fpython-dashio","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdashio-connect%2Fpython-dashio","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdashio-connect%2Fpython-dashio/lists"}