{"id":15140407,"url":"https://github.com/0skillallluck/homebridge-argo","last_synced_at":"2026-03-06T12:03:22.847Z","repository":{"id":246532457,"uuid":"821421803","full_name":"0SkillAllLuck/homebridge-argo","owner":"0SkillAllLuck","description":"Homebridge plugin for Argo air conditioners","archived":false,"fork":false,"pushed_at":"2025-10-31T04:13:15.000Z","size":539,"stargazers_count":0,"open_issues_count":11,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-11-03T17:33:35.255Z","etag":null,"topics":["air-conditioner","homebridge","homebridge-plugin"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","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/0SkillAllLuck.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":"0SkillAllLuck"}},"created_at":"2024-06-28T13:57:17.000Z","updated_at":"2025-09-16T10:20:25.000Z","dependencies_parsed_at":"2024-06-28T14:41:41.387Z","dependency_job_id":"19c7dc49-6d95-4a22-ab56-f0feb350ae06","html_url":"https://github.com/0SkillAllLuck/homebridge-argo","commit_stats":{"total_commits":80,"total_committers":2,"mean_commits":40.0,"dds":"0.30000000000000004","last_synced_commit":"5b8a7beac1cc881de4f3b651ae93e0c7632ea611"},"previous_names":["0skillallluck/homebridge-argo"],"tags_count":20,"template":false,"template_full_name":null,"purl":"pkg:github/0SkillAllLuck/homebridge-argo","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0SkillAllLuck%2Fhomebridge-argo","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0SkillAllLuck%2Fhomebridge-argo/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0SkillAllLuck%2Fhomebridge-argo/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0SkillAllLuck%2Fhomebridge-argo/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/0SkillAllLuck","download_url":"https://codeload.github.com/0SkillAllLuck/homebridge-argo/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/0SkillAllLuck%2Fhomebridge-argo/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":30175911,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-03-06T11:48:51.886Z","status":"ssl_error","status_checked_at":"2026-03-06T11:48:51.460Z","response_time":250,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["air-conditioner","homebridge","homebridge-plugin"],"created_at":"2024-09-26T08:20:26.562Z","updated_at":"2026-03-06T12:03:22.821Z","avatar_url":"https://github.com/0SkillAllLuck.png","language":"TypeScript","funding_links":["https://github.com/sponsors/0SkillAllLuck"],"categories":[],"sub_categories":[],"readme":"# Homebridge Argo\n\n[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n[![Downloads](https://img.shields.io/npm/dt/homebridge-argo.svg)](https://www.npmjs.com/package/homebridge-argo)\n[![Version](https://img.shields.io/npm/v/homebridge-argo.svg)](https://www.npmjs.com/package/homebridge-argo)\n[![GitHub issues](https://img.shields.io/github/issues/0skillallluck/homebridge-argo)](https://github.com/0skillallluck/homebridge-argo/issues)\n[![GitHub pull requests](https://img.shields.io/github/issues-pr/0skillallluck/homebridge-argo)](https://github.com/0skillallluck/homebridge-argo/pulls)\n\n\u003c/span\u003e\n\n## Homebridge plugin for Argo air conditioners\n\nThis [Homebridge](https://github.com/homebridge/homebridge) plugin exposes [Argo](https://www.argoclima.com/en/) air conditioners,\ncapable of WiFi, to Apple's [HomeKit](https://www.apple.com/ios/home/).\n\n*Currently only the **Ulisse 13 DCI Eco WiFi** is confirmed to work*\n\n### Configuration\n\nTo configure the plugin simply install it and use the config UI to configure.\n\nAlternatively you can configure it using the `config.json` file of Homebridge. Simply add the **Argo** platform to the platforms and configure your devices.\n \n```json\n  \"platforms\": [\n    {\n      \"platform\": \"Argo\",\n      \"devices\": [\n        {\n          \"name\": \"Example Display Name\",\n          \"ip\": \"192.168.5.30\"\n        }\n      ]\n    }\n  ]\n```\n\n### Advanced device settings\n\nIn some cases Argo devices don't accurately report the temperate. In those cases you can set a offset in the device configuration to\nhelp compensate for the inaccuracy.\n\n```json\n  \"platforms\": [\n    {\n      \"platform\": \"Argo\",\n      \"devices\": [\n        {\n          \"name\": \"Example Display Name\",\n          \"ip\": \"192.168.5.30\",\n          \"offset\": 2.5,\n        }\n      ]\n    }\n  ]\n```\n\nIn the above example the temperature would be adjusted by 2.5 degrees. Meaning that the read temperature will be 2.5 degrees higher\nand all settings will be 2.5 degrees lower to compensate. *this also affects min/max setpoints*\n\n### Advanced settings\n\nArgo devices have a lot of issues with their connectivity as they seem to require a connection to their home server.\nTo help with this we can let the device push updates to Homebridge instead of polling the device constantly.\nAs the device is configured to only communicate with its home serverwe need to redirect traffic to that server to our Homebridge instance instead.\n\nTo achieve this first we need to start the listener build into this plugin, you can do so by setting the `usePush` flag to true and defining a `port` to use.\nAfter changing the config restart homebridge.\n\n```json\n  \"platforms\": [\n    {\n      \"platform\": \"Argo\",\n      \"devices\": [\n        {\n          \"name\": \"Example Display Name\",\n          \"ip\": \"192.168.5.30\"\n        }\n      ],\n      \"usePush\": true,\n      \"port\": 42420\n    }\n  ]\n```\n\nAfterwards you need to tell your router to redirect traffic to your Homebridge instance. You can do so by running:\n\n```bash\niptables -t nat -I PREROUTING -s 0.0.0.0/0 -d 31.14.128.210 -p tcp -j DNAT --to-destination \u003cyour-homebridge-ip\u003e:\u003cyour-port\u003e\n```\n\nAfter this the Plugin will no longer poll but will listen for updates from the device instead.\n\n\nTo remove the traffic redirect in the future just run:\n```bash\niptables -t nat -D PREROUTING -s 0.0.0.0/0 -d 31.14.128.210 -p tcp -j DNAT --to-destination \u003cyour-homebridge-ip\u003e:\u003cyour-port\u003e\n```\n\n#### Alternative setup\n\nYou can alternatively configure the homebridge server with the IP `31.14.128.210` and tell your router to statically route `31.14.128.210`\nto your homebridge instance.\n\nIf you decide to do so please configure the listener to listen on port 80 and 31.14.128.210\n\n```json\n  \"platforms\": [\n    {\n      \"platform\": \"Argo\",\n      \"devices\": [\n        {\n          \"name\": \"Example Display Name\",\n          \"ip\": \"192.168.5.30\"\n        }\n      ],\n      \"usePush\": true,\n      \"port\": 80,\n      \"host\": \"31.14.128.210\",\n    }\n  ]\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0skillallluck%2Fhomebridge-argo","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F0skillallluck%2Fhomebridge-argo","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F0skillallluck%2Fhomebridge-argo/lists"}