gbvillarinho/celsius

Control your LG air conditioner from the Mac menu bar. Click the icon, pick a temperature, mode or fan speed, and that's it. No phone needed.

• Turns the air conditioner on and off
• Changes the mode (cool, fan, dry, auto)
• Sets the temperature, with a range you choose
• Sets the fan speed and the air swing
• Turns Eco mode on and off
• Sets a sleep timer that turns the unit off after a few hours
• Opens when you log in, if you want it to

• A Mac running macOS 15 or later
• An LG air conditioner that already works in the LG ThinQ phone app
• An LG account in Brazil (the app is set up for that region)

1. Go to the Releases page.
2. Download Celsius.zip.
3. Double-click it to unzip, then drag Celsius into your Applications folder.
4. Open Celsius. Its icon shows up in the menu bar.

If you have an assistant that can run commands on your Mac, such as Claude Code, copy this prompt into it. The same prompt works for updating, because it replaces any older copy.

Install or update the Celsius menu bar app on this Mac.

1. If Celsius is running, quit it (pkill -x Celsius).
2. Download Celsius.zip from the latest release at
   https://github.com/gbvillarinho/celsius/releases/latest
   (for example: gh release download --repo gbvillarinho/celsius --pattern Celsius.zip)
3. Unzip it and move Celsius.app into /Applications, replacing any older copy.
4. Remove the quarantine flag so macOS opens it without a warning:
   xattr -dr com.apple.quarantine /Applications/Celsius.app
5. Open the app.

If this is a first install, tell me to paste my LG access token in the Celsius Settings screen.
Do not ask for my token and do not run anything else.

Don't give your LG token to the assistant. Paste it into the app yourself.

The first time, macOS may say it can't verify the app. That happens with any app that isn't from the App Store. To open it anyway:

1. Right-click Celsius in Applications and choose Open.
2. Click Open in the window that appears.

If you don't see that option, go to System Settings > Privacy & Security, scroll down, and click Open Anyway next to Celsius. You only have to do this once.

Celsius needs a free access token from LG to talk to your air conditioner. It takes about a minute.

1. Open connect-pat.lgthinq.com and sign in with your LG account.
2. Create a new token (LG calls it a Personal Access Token).
3. Copy it. It starts with thinqpat_.

1. Click the Celsius icon in the menu bar. With no token yet, it opens on Settings.
2. Paste the token (the clipboard button next to the field does it for you) and click Connect.
3. Your air conditioner appears and you can control it.

The token is stored in your Mac's Keychain, on this Mac only. It is never written to a file and never sent anywhere except LG.

Celsius checks for a new version about once a day. When there is one, a blue dot appears next to "Air conditioner settings..." in the popover. Open Settings and click "Update to X.Y.Z", which takes you to the download page. Download the zip and replace the app in Applications, the same as the first time. Your token stays in the Keychain.

Or let an AI assistant do it. Paste this prompt into one that can run commands on your Mac, such as Claude Code. It's the same prompt as the install one, and it replaces the old copy.

Install or update the Celsius menu bar app on this Mac.

1. If Celsius is running, quit it (pkill -x Celsius).
2. Download Celsius.zip from the latest release at
   https://github.com/gbvillarinho/celsius/releases/latest
   (for example: gh release download --repo gbvillarinho/celsius --pattern Celsius.zip)
3. Unzip it and move Celsius.app into /Applications, replacing any older copy.
4. Remove the quarantine flag so macOS opens it without a warning:
   xattr -dr com.apple.quarantine /Applications/Celsius.app
5. Open the app.

If this is a first install, tell me to paste my LG access token in the Celsius Settings screen.
Do not ask for my token and do not run anything else.

macOS may ask for your Keychain password once after an update, so the new copy can read your token. Click Always Allow. If the app says it has no token, paste it again in Settings.

"LG rejected this token." The token is wrong or has expired. Create a new one on the LG page and paste it in Settings.

Nothing changes right after I press a button. LG's servers take a few seconds to confirm a change. Celsius shows the new value right away and checks it a moment later.

Does it work in other countries? Not yet. It's set up for Brazil.

Does it work with any LG air conditioner? It was built and tested with one model. Others should work, but some controls may be missing or behave differently.

How do I disconnect or switch accounts? Open Settings in the app, click Sign out, then paste a new token.

Celsius is a Swift Package (no Xcode project). You only need the Command Line Tools (xcode-select --install) and Swift 6.2 or later.

Build and install from source:

git clone https://github.com/gbvillarinho/celsius.git
cd celsius
scripts/build-app.sh --install    # build, ad-hoc sign, copy to /Applications and launch

Use scripts/build-app.sh without --install to only build build/Celsius.app. To install with the token already in the Keychain: CELSIUS_PAT=thinqpat_your_token scripts/build-app.sh --install.

Build and test:

swift build                           # debug build
scripts/test.sh                       # all tests
scripts/test.sh --filter StoreTests   # one suite

Always run tests through scripts/test.sh. With only Command Line Tools installed, Swift Testing lives outside the default search paths, and the script adds the flags it needs.

Environment variables for running from the terminal:

To check UI changes without running the app, render the popover in fixed states (no network):

$(swift build --show-bin-path)/Celsius --snapshot <dir>

Layout:

• Sources/CelsiusCore: API client, models, settings/Keychain and the observable store (tested)
• Sources/Celsius: the AppKit + SwiftUI app (status item, popover and views)
• Tests/CelsiusCoreTests: Swift Testing suites; fixtures are real responses from the unit, with the device ID replaced

The app uses LG's official ThinQ Connect API with a Personal Access Token. The region is fixed to Brazil (x-country: BR, host api-aic.lgthinq.com); for another country, adjust ThinQClient. See CLAUDE.md for architecture details and conventions.

MIT. Celsius is not affiliated with or endorsed by LG Electronics.