手引Support

Kūki is made for the IKEA ALPSTUGA air-quality sensor. It also works with any other sensor in Apple Home that reports CO₂, PM2.5 or air quality; temperature and humidity are read too when the sensor has them.

If you have more than one, choose which one Kūki follows in Settings › Sensor.

• The sensor added to the Home app. Kūki reads it through Apple Home; no IKEA hub, app or cloud is needed.
• A Home hub with Thread, such as a HomePod mini, a HomePod (2nd generation) or a Thread-capable Apple TV 4K. The ALPSTUGA speaks Matter over Thread, so it needs one to join your Home.
• iPhone or iPad with iOS 18 or later, or a Mac with macOS 15 or later.

The first time you open Kūki it asks for access to your Home. If you said no, allow it under Privacy & Security in Settings (HomeKit on iPhone and iPad, Home in System Settings on the Mac).

Yes. Turn on Settings › Demo sensor. Kūki then shows a simulated sensor, and you can add three days of demo history to explore History and Export. Delete the demo data from the same section when you’re done.

Apple Home only gives sensor values to an app that’s active. When Kūki is in the background on iPhone or iPad, Apple Home stops answering it, so nothing can be recorded. History therefore shows the times Kūki was open, and gaps are drawn as no data rather than guessed.

For continuous data:

• Let a Mac record around the clock (see below) and turn on iCloud Sync, so your iPhone shows the same history.
• Or leave a spare iPhone or iPad on a charger in Station Mode: a dim, always-awake screen that keeps Kūki in front.

On the Mac, Kūki runs from the menu bar, which keeps it active, so it records around the clock, even with its window closed.

• Keep Settings › Show in Dock off. With a Dock icon, Kūki becomes a normal app and pauses in the background.
• Turn on Open at Login so recording resumes after a restart.
• Your Mac must be awake. Recording pauses while it sleeps.

Paused means Kūki can’t hear the sensor right now, usually because the app isn’t in front, and it tells you why instead of pretending the sensor vanished.

Reaching your sensor… appears when you come back to Kūki while Apple Home reconnects. It usually takes 5–15 seconds. Kūki never records or alerts on an old value.

Tap the room name at the top of Now and choose where the sensor is. History is kept for each room, so you can compare them.

Right after a move, the CO₂ cell needs a few minutes to adapt. Those minutes count as settling and are left out of comparisons; set how long in Settings › Recording.

In Settings › Alert, set your limit (1000 ppm by default, the usual “open a window” line) and turn the wind-chime sound and the notification on or off. The fūrin rings once per stuffy spell, then stays quiet until the air has clearly recovered.

Use Settings › iCloud Sync on each device. When it’s on, the history each device records, your rooms and which room the sensor is in sync between your devices through your private iCloud, and the latest reading reaches your other devices’ widgets, Lock Screen and alerts.

Sync needs the same Apple Account with iCloud turned on on each device. Turning it off stops syncing; what is already in iCloud stays there until you remove it in Settings › Apple Account › iCloud › Manage Storage.

iPhone and iPad: open the Export tab, choose a period (24 hours, 7 days, 30 days or all), then:

• For Claude or ChatGPT: a Markdown brief with context, a summary per room and the data averaged to fit a chat. Share the file, or copy the text and paste it into the conversation.
• Spreadsheet (CSV): every sample at full resolution, for Numbers, Excel or Google Sheets.

Mac: choose File › Export CSV… (⇧⌘E) or File › Export for AI… (⌥⇧⌘E). Both export the period History is showing.

In Settings › Data. Readings live only on your devices (and in your private iCloud if sync is on). The developer never receives any of it. See the privacy policy.