Support

Stuck? Most answers are below. Otherwise email support@sensorly.app and a human will reply.

Getting started

Open Sensorly. A thermometer appears in the menu bar.
Click it, choose Open Settings…, then Add Source.
Pick your service and enter the credentials from the table below.
Your sensors appear within a few seconds. Pin one to show its temperature in the menu bar.

Where to find your credentials

Source	You need	Where to get it
YoLink	UAID + Secret Key	YoLink app → ☰ → Settings → Account → Advanced Settings → User Access Credentials
Govee	API key	Govee Home app → Profile → Settings → Apply for API Key (arrives by email)
Ambient Weather	API key + Application key	ambientweather.net → Account → API Keys
Ecowitt	Application key + API key	ecowitt.net → Profile → Developer Application
Tempest	Personal access token	tempestwx.com → Settings → Data Authorizations → Create Token
SensorPush	Account email + password	Requires a G1 Gateway, with API access enabled at dashboard.sensorpush.com
Home Assistant	Server URL + long-lived token	Home Assistant → your profile → Security → Long-Lived Access Tokens

Common questions

A source says “Missing …” in Settings.: One of its credential fields is empty. Click Edit, fill it in, and save.
macOS asked whether Sensorly can use my keychain.: That's where your credentials live. Choose Always Allow so it doesn't ask again. If you chose Deny, quit and reopen Sensorly to be asked again.
Why is there no history from before I installed the app?: Most sensor services don't offer past readings through their API, so Sensorly records history itself, from the moment it first runs. It only records while the app is open, so turn on Launch at login for gap-free charts.
Which Home Assistant sensors show up?: Every sensor.* entity with device class temperature or humidity. Entities named like office_temperature and office_humidity are paired into one row. Use the optional filter to limit which entity IDs are shown.
How often does it update?: Every 5 minutes by default; choose 1 to 30 minutes in Settings. It also refreshes when you open the menu if the data is more than a minute old. Some services rate-limit their APIs, so very short intervals with many sensors may produce errors.
How do I remove everything?: Delete each source in Settings (this removes its credentials from the Keychain), use Clear History…, then move Sensorly to the Trash.

Contact

Email support@sensorly.app. It helps to include your macOS version, which source is affected, and the exact message shown under the source in Settings.