{"id":25797074,"url":"https://github.com/klassm/walkingpad_macos_client","last_synced_at":"2025-02-27T14:57:09.294Z","repository":{"id":40317963,"uuid":"492195421","full_name":"klassm/walkingpad_macos_client","owner":"klassm","description":"MacOS Client for Kingsmith WalkingPads","archived":false,"fork":false,"pushed_at":"2023-07-15T15:22:24.000Z","size":1075,"stargazers_count":5,"open_issues_count":1,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2023-07-15T16:28:29.144Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Swift","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/klassm.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-05-14T11:24:18.000Z","updated_at":"2023-07-12T03:15:17.000Z","dependencies_parsed_at":"2023-02-12T10:00:59.849Z","dependency_job_id":null,"html_url":"https://github.com/klassm/walkingpad_macos_client","commit_stats":null,"previous_names":[],"tags_count":6,"template":null,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klassm%2Fwalkingpad_macos_client","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klassm%2Fwalkingpad_macos_client/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klassm%2Fwalkingpad_macos_client/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/klassm%2Fwalkingpad_macos_client/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/klassm","download_url":"https://codeload.github.com/klassm/walkingpad_macos_client/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":241026947,"owners_count":19896718,"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":[],"created_at":"2025-02-27T14:57:08.721Z","updated_at":"2025-02-27T14:57:09.285Z","avatar_url":"https://github.com/klassm.png","language":"Swift","funding_links":[],"categories":[],"sub_categories":[],"readme":"#  WalkingPad MacOS Client\n\nA native MacOS Client (as status bar app) to watch your steps.\n\n\n### Features\n\n* Connect to your treadmill via Bluetooth\n* Watch your steps, the app will accumulate the steps\n* You can change the speed directly in the app\n* GoogleFit support - connect the app to your Google Fit account. Whenever you pause or stop the treadmill, the steps will be uploaded to Google Fit.\n* Statistics - the app will remember the times you walked before and give you some statistics on how much you have walked in the past\n* [Alfred](https://www.alfredapp.com/) Workflow to control your treadmill by keystroke. You can download the workflow [here](https://github.com/klassm/walkingpad_alfred/releases)\n* Publish the WalkingPad state as MQTT message (\u003e= 0.0.3)\n\n### Installation\n\nDownload the latest release from the [releases section](https://github.com/klassm/walkingpad_macos_client/releases).\n\nPlease make sure to grant the app Bluetooth permissions, to ensure the app can communicate with the WalkingPad device.\n\n![Bluetooth Permission](docs/bluetooth_connection.png)\n\n#### MQTT Configuration\n\nYou can publish the current WalkingPad state as MQTT message. An example use case is to use the current state\nfor automations in your favorite home automation tool like Home Assistant.\n\nTo configure the app to use MQTT, you need to provide a config file containing the connection data. Please\nplace this file in `~/Library/Containers/klassm.walkingpad-client/Data/Library/Autosave Information/.walkingpad-client-mqtt.json`\n(this is quite a complex path, however it does not require any additional permissions to read it).\n\n```json\n{\n  \"username\": \"myusername\",\n  \"password\": \"mypassword\",\n  \"host\": \"192.168.0.73\",\n  \"port\": 1883,\n  \"topic\": \"homeassistant/sensor/walkingpad\"\n}\n```\n\nThe app will automatically read the config data and start to publish messages.\n\nAn example message looks like the following:\n```\n{\n    \"speedKmh\":1.5,\n    \"stepsTotal\":19202,\n    \"distanceTotal\":4690,\n    \"stepsWalkingpad\":510\n}\n```\n\nHome Assistant can afterwards be configured to read the data.\n\n```yaml\nmqtt:\n  sensor:\n    - name: \"WalkingPad Speed\"\n      object_id: \"walkingpad_speed\"\n      state_topic: \"homeassistant/sensor/walkingpad\"\n      value_template: \"{{ value_json.speedKmh }}\"\n      unit_of_measurement: \"km/h\"\n    - name: \"WalkingPad Steps\"\n      object_id: \"walkingpad_steps\"\n      state_topic: \"homeassistant/sensor/walkingpad\"\n      value_template: \"{{ value_json.stepsTotal }}\"\n      unit_of_measurement: \"Steps\"\n```\n\n### Screenshots\n\n![Tray App](docs/tray_app.png)\n![Stats](docs/stats.png)\n\n\n### Credits\n\nThe implementation is heavily inspired by [ph4r05/ph4-walkingpad](https://github.com/ph4r05/ph4-walkingpad).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklassm%2Fwalkingpad_macos_client","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fklassm%2Fwalkingpad_macos_client","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fklassm%2Fwalkingpad_macos_client/lists"}