Homebridge plugin for LG ThinQ-enabled portable air conditioners.
WARNING: This has only been tested with the LP1419IVSM model. This may not work with other models.
-
Mobile app setup
- Set up the air conditioner using the "LG ThinQ" app (iOS | Google Play)
- Ensure the air conditioner shows up in the app and responds to controls
-
Install the homebridge plugin
sudo npm -g i homebridge-lg-thinq-ac
-
Add platform to config.json
- I highly recommend using homebridge-config-ui-x to make these changes
- Add the appropriate country & language code for your account
- Add the following to your config (or merge with the
platforms
array if it exists):
{ "platforms": [ { "platform": "LgThinqAirConditioner", "country_code": "US", "language_code": "en-US" } ] }
-
Restart Homebridge
-
Log into your LG account
- Wait for Homebridge to start back up.
- In the Homebridge Config UI, click the "Plugins" tab.
- In the list of plugins, click "Settings" under "LG ThinQ Air Conditioner"
- In the modal that pops up, find "Login URL". Copy & paste this URL into another browser tab.
- Log into your LG account. You should be redirected to a blank page.
- On the blank page, copy the URL address of that page and close the tab
-
Paste back the returned URL
- Keeping the URL you copied at the end of Step 5, open the Homebridge Config UI
- In the plugin settings, paste the URL into "Redirected URL"
- Click "Save" and restart Homebridge
-
Try it out!
- Wait for Homebridge to start back up
- Open HomeKit on your device! You should now see your air conditioner pop up.
- If you have issues, review the Homebridge logs (found on the "status" page of the Homebridge Config UI).
- If you see
400
errors or otherwise suspect auth/login issues, clear all config values for the plugin, restart Homebridge, and follow the installation guide again.
To develop Homebridge plugins you must have Node.js 12 or later installed, and a modern code editor such as VS Code. This plugin template uses TypeScript to make development easier and comes with pre-configured settings for VS Code and ESLint. If you are using VS Code install these extensions:
Using a terminal, navigate to the project folder and run this command to install the development dependencies:
npm install
TypeScript needs to be compiled into JavaScript before it can run. The following command will compile the contents of your src
directory and put the resulting code into the dist
folder.
npm run build
Run this command so your global install of Homebridge can discover the plugin in your development environment:
npm link
You can now start Homebridge, use the -D
flag so you can see debug log messages in your plugin:
homebridge -D
If you want to have your code compile automatically as you make changes, and restart Homebridge automatically between changes you can run:
npm run watch
This will launch an instance of Homebridge in debug mode which will restart every time you make a change to the source code. It will the config stored in the default location under ~/.homebridge
. You may need to stop other running instances of Homebridge while using this command to prevent conflicts. You can adjust the Homebridge startup command in the nodemon.json
file.
Release notes are automatically generated by semantic-release. Please follow the Angular commit guidelines for formatting commit messages.
New versions are automatically built, versioned, and published by semantic-release. Every push to the master
branch will trigger a release, with a version bump that respects the types of new commit(s) included.
Given a version number MAJOR
.MINOR
.PATCH
, such as 1.4.3
, increment the:
- MAJOR version when you make breaking changes to your plugin,
- MINOR version when you add functionality in a backwards compatible manner, and
- PATCH version when you make backwards compatible bug fixes.