{"_id":"@bvksound/homebridge-lg-thinq","name":"@bvksound/homebridge-lg-thinq","dist-tags":{"latest":"2.1.0"},"versions":{"2.1.0":{"displayName":"Homebridge LG ThinQ (bvksound fix)","name":"@bvksound/homebridge-lg-thinq","version":"2.1.0","description":"A Homebridge plugin for controlling/monitoring LG ThinQ devices via LG ThinQ platform. Fork of homebridge-lg-thinq with the LG preLogin 403 (axios User-Agent) fix applied — see nVuln/homebridge-lg-thinq#400 / #402.","license":"Apache-2.0","type":"module","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/bvksound/homebridge-lg-thinq.git"},"bugs":{"url":"https://github.com/bvksound/homebridge-lg-thinq/issues"},"engines":{"homebridge":"^1.11.2 || ^2.0.0","node":"^22.13.0 || ^24.0.0"},"main":"dist/index.js","bin":{"thinq":"dist/cli.js"},"scripts":{"build":"rimraf ./dist && tsc","lint":"eslint . --max-warnings=0","check":"npm run lint && npm run build && npm run test:coverage","prepublishOnly":"npm run lint && npm run build","watch":"npm run build && npm link && nodemon","test":"jest --runInBand","test:watch":"jest --watch","test:coverage":"rimraf ./coverage && jest --coverage --runInBand"},"keywords":["homebridge-plugin","homekit","lg","lg-thinq"],"devDependencies":{"@eslint/js":"^10.0.1","@jest/globals":"^30.3.0","@types/aws-iot-device-sdk":"^2.2.9","@types/luxon":"^3.7.1","@types/node":"^25.6.0","@types/node-forge":"^1.3.14","@types/node-persist":"^3.1.8","@types/qs":"^6.15.0","eslint":"^10.3.0","homebridge":"^2.0.0","jest":"^30.3.0","nodemon":"^3.1.14","rimraf":"^6.1.3","ts-jest":"^29.4.9","ts-node":"^10.9.2","typescript":"^6.0.3","typescript-eslint":"^8.59.2"},"homepage":"https://github.com/bvksound/homebridge-lg-thinq#readme","author":{"name":"nVuln"},"contributors":[{"name":"bvksound","url":"preLogin 403 fix fork"}],"dependencies":{"@homebridge/plugin-ui-utils":"^2.2.3","aws-iot-device-sdk":"^2.2.16","axios":"^1.16.0","axios-retry":"^4.5.0","commander":"^14.0.3","luxon":"^3.7.2","node-forge":"^1.4.0","node-persist":"^4.0.4","qs":"^6.15.1"},"overrides":{"glob":"^13.0.6","help-me":{"glob":"^13.0.6"},"node-persist":"^4.0.4"},"gitHead":"e9d5752b4788b82a63aeb69482529fe8588bb386","types":"./dist/index.d.ts","_id":"@bvksound/homebridge-lg-thinq@2.1.0","_nodeVersion":"24.15.0","_npmVersion":"11.12.1","dist":{"integrity":"sha512-unlD2M7K2hYp/1OCnk1+wPmlsdwbnhqM5Un88A2s54fODegPvU9xXT7pF1ap/SwGfLuSTqZIdoGixuqVxnIhVQ==","shasum":"6ab6c5a2b3407faec1f09af52784f09619621364","tarball":"https://registry.npmjs.org/@bvksound/homebridge-lg-thinq/-/homebridge-lg-thinq-2.1.0.tgz","fileCount":207,"unpackedSize":1399370,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIAtS15DpvLcStpE1Jb2IMzd8LArtRN8ohq0K8eZMYhqWAiBhf5a3uqDQfUqUQnhSaXzTO77gRCn0FM5ul5n5wF1uoA=="}]},"_npmUser":{"name":"bvksound","email":"bartvandekeere@gmail.com"},"directories":{},"maintainers":[{"name":"bvksound","email":"bartvandekeere@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/homebridge-lg-thinq_2.1.0_1788982029243_0.27725381779984803"},"_hasShrinkwrap":false}},"time":{"created":"2026-09-09T19:27:08.845Z","2.1.0":"2026-09-09T19:27:09.382Z","modified":"2026-09-09T19:27:09.893Z"},"maintainers":[{"name":"bvksound","email":"bartvandekeere@gmail.com"}],"description":"A Homebridge plugin for controlling/monitoring LG ThinQ devices via LG ThinQ platform. Fork of homebridge-lg-thinq with the LG preLogin 403 (axios User-Agent) fix applied — see nVuln/homebridge-lg-thinq#400 / #402.","homepage":"https://github.com/bvksound/homebridge-lg-thinq#readme","keywords":["homebridge-plugin","homekit","lg","lg-thinq"],"repository":{"type":"git","url":"git+https://github.com/bvksound/homebridge-lg-thinq.git"},"contributors":[{"name":"bvksound","url":"preLogin 403 fix fork"}],"author":{"name":"nVuln"},"bugs":{"url":"https://github.com/bvksound/homebridge-lg-thinq/issues"},"license":"Apache-2.0","readme":"

\n\n

\n\n# Homebridge LG ThinQ\n\n[![verified-by-homebridge](https://badgen.net/badge/homebridge/verified/purple)](https://github.com/homebridge/homebridge/wiki/Verified-Plugins)\n[![npm](https://img.shields.io/npm/v/homebridge-lg-thinq/latest?label=latest)](https://www.npmjs.com/package/homebridge-lg-thinq)\n[![npm](https://img.shields.io/npm/dt/homebridge-lg-thinq)](https://www.npmjs.com/package/homebridge-lg-thinq)\n[![join-discord](https://badgen.net/badge/icon/discord?icon=discord&label=homebridge-lg-thinq)](https://discord.gg/wEfQpCDtS7)\n\n## Overview\n\nHomebridge LG ThinQ is a Homebridge platform plugin for controlling and monitoring LG ThinQ appliances.\n\nThis plugin is not an official LG API client. It works with LG ThinQ account data and supports most current ThinQ2 devices, with optional support for some legacy ThinQ1 devices.\n\n## Requirements\n\n* Homebridge `^1.11.2` or Homebridge `^2.0.0`\n* Node.js `^22.13.0` or `^24.0.0`\n\n## Installation\n\nInstall the plugin from the Homebridge UI, or install it manually:\n\n```sh\nnpm install -g homebridge-lg-thinq\n```\n\n## Configuration\n\nThe Homebridge UI plugin settings are recommended.\n\n1. Open Homebridge UI.\n2. Go to the Plugins page.\n3. Open the settings for Homebridge LG ThinQ.\n4. Select the country and language for your LG account.\n5. Sign in with your LG account to get a refresh token.\n6. Click the Homebridge UI Save button.\n7. Restart Homebridge or the plugin child bridge.\n8. Reopen the plugin settings to review discovered devices and device options.\n\nIf no devices are listed in the plugin config, all supported devices in the LG account are enabled. Add device entries only when you want to rename devices, configure device options, or enable only specific devices.\n\n## Manual Configuration\n\nManual editing is supported, but the Homebridge UI is recommended.\n\n```json\n{\n \"platform\": \"LGThinQ\",\n \"auth_mode\": \"token\",\n \"refresh_token\": \"refresh-token-from-lg-login\",\n \"country\": \"US\",\n \"language\": \"en-US\",\n \"devices\": []\n}\n```\n\nTo enable or configure only specific devices, list them by device id:\n\n```json\n{\n \"platform\": \"LGThinQ\",\n \"auth_mode\": \"token\",\n \"refresh_token\": \"refresh-token-from-lg-login\",\n \"country\": \"US\",\n \"language\": \"en-US\",\n \"devices\": [\n {\n \"id\": \"device-id\",\n \"name\": \"Laundry Room Washer\"\n }\n ]\n}\n```\n\n| Option | Required | Description |\n| --- | --- | --- |\n| `platform` | Yes | Must be `LGThinQ`. |\n| `auth_mode` | Yes | Use `token` for refresh-token auth. `account` is also accepted for username/password config. |\n| `refresh_token` | Yes, for token auth | Refresh token returned by the LG login flow. |\n| `username` | Yes, for account auth | LG ThinQ account username. |\n| `password` | Yes, for account auth | LG ThinQ account password. |\n| `country` | Yes | LG account country alpha-2 code, for example `US`. |\n| `language` | Yes | LG account language code, for example `en-US`. |\n| `devices` | No | Empty or omitted enables all supported discovered devices. |\n| `thinq1` | No | Advanced legacy option. Set to `true` manually to enable ThinQ1 devices. |\n\nDevice type is detected from LG discovery data. Device-specific settings appear in the Homebridge UI after devices have been discovered.\n\n## Supported Devices\n\nSupport depends on the model data returned by LG. If a device appears in the LG ThinQ app but not in Homebridge, open an issue with the device type, model, country, and debug logs.\n\n| Device | Status | Control | ThinQ2 | ThinQ1 |\n| --- | --- | --- | --- | --- |\n| Refrigerator | Supported | Supported | Yes | Yes |\n| Air Purifier | Supported | Supported | Yes | Yes |\n| AeroTower | Supported | Supported | Yes | No |\n| Washer / Dryer / WashTower | Supported | Limited | Yes | Yes |\n| Dishwasher | Supported | No | Yes | No |\n| Dehumidifier | Supported | Partial | Yes | No |\n| Air Conditioner | Supported | Supported | Yes | Yes |\n| Styler | Supported | Limited | Yes | No |\n| Range Hood | Supported | Supported | Yes | Yes |\n| Oven | Supported | Partial | Yes | No |\n| Microwave | Supported | Partial | Yes | No |\n\n## Troubleshooting\n\nEnable Homebridge debug logging when troubleshooting setup or device behavior. Include startup logs, device type/model information, country, language, and the error message when opening an issue.\n\n## CLI Usage\n\n```sh\n$ thinq\nUsage: thinq [options] [command]\n\nOptions:\n -c, --country Country code for account (default: \"US\")\n -l, --language Language code for account (default: \"en-US\")\n -h, --help display help for command\n\nCommands:\n login Obtain refresh_token from LG account\n auth Obtain refresh_token from account logged by Google Account, Apple ID\n help [command] display help for command\n```\n\n## Support\n\nIf you have a question, start a [discussion](https://github.com/nVuln/homebridge-lg-thinq/discussions/new) or leave a message in the [Discord channel](https://discord.gg/wEfQpCDtS7).\n\nIf you would like to report a bug, open an [issue](https://github.com/nVuln/homebridge-lg-thinq/issues/new/choose).\n\n## Contributors\n\nSpecial thanks to [carlosgamezvillegas](https://github.com/carlosgamezvillegas) for implementing Oven and Microwave device support. More detail in [#87](https://github.com/nVuln/homebridge-lg-thinq/issues/87).\n","readmeFilename":"README.md","_rev":"1-0f49eef16c2091e573891ea28880b5a8"}