[APP][PRO] Lightkeeper

Hi all

This is the topic for Lightkeeper. Questions, bug reports and feature requests are all welcome here :slight_smile:

Lightkeeper makes the lights and remotes you already have, a bit smarter, without you building any Flows.

:point_right: App Store: Lightkeeper | Homey
:test_tube: Test version: Lightkeeper | Homey
:computer: Source (MIT): GitHub - thomassidor/lightkeeper · GitHub
:beetle: Issues: Issues · thomassidor/lightkeeper · GitHub

:warning: Still taking shape. This is a 0.x app. An update can change or break a device you have already set up, which may mean running Repair on it or adding it again. Please read the changelog before updating.

What it does

Add it via Devices → Add → Lightkeeper and choose one of five types:

  • :control_knobs: Light Remote: turn a remote, switch or dial you already own into a controller for any lights. Lightkeeper writes and maintains the Flows for you.
  • :alarm_clock: Light schedule: lights on and off at set times on chosen weekdays, with a colour and brightness if you want.
  • :sunrise: Circadian light: warmth through morning, midday and evening, following your own sunrise and sunset.
  • :art: Colour Curve Light: draw the day yourself as points, each with a warmth or a colour.
  • :sun_behind_small_cloud: Room-sensing Light: brightness from a lux sensor you already own, or from the sun’s height.

Each device exposes what it wants the lights to be as Flow tags, and there are two cards: Set lights the Lightkeeper way and It is dark enough.

Requirements

  • Homey Pro (2023) or newer, firmware 12.9.0+
  • A Personal API Key with Flow permissions, but only for Light Remotes and schedules, because Homey doesn’t let apps write Flows on their own. The key stays on your Homey.

Nothing leaves your Homey: no cloud, no telemetry.

Reporting a problem

Please say which device type it is, which lamp or remote you use, and what the app’s settings page (Settings → Apps → Lightkeeper) shows. That page lists recent presses and light changes, and why each was acted on or ignored. There’s more in the FAQ.

Built with AI, directed and verified on real hardware by me.

Update: 0.6.5 currently in review.

Changelog:

  • Choose how a device controls your lights — change them after they turn on (the default), set them before they turn on so they come on already right, or leave them alone and only work out the values. A device that set colours before lights came on stops doing so until you run the new light test once from Repair.
  • A remote button can turn lights on the way the rest of the house knows they should look, taking colour from one Lightkeeper device and brightness from another at the moment you press.
  • Lightkeeper’s values in your own Flows — as tags, a card that sets a room from two devices in one change, and an It is dark enough condition.
  • Redrawn setup screens with a new colour picker, colours for schedule blocks, and a shorter Room-sensing Light setup; plus fixes for lights left alone for hours when nobody had touched them, a Light Remote with a colour button arriving unavailable, and a dozen more.

:white_check_mark: Version 0.6.5 is live!

:magnifying_glass_tilted_left: Version 0.6.6 submitted for review:

What’s new:

  • Transition: Gradual, Balanced or Quick. Choose how your lights move from one point to the next: evenly the whole way, mostly in the middle (the default), or nearly all at once. It’s on Circadian, Colour Curve and Room-sensing Lights.
  • Settings on the device itself. Tap the gear icon on a device to change how Lightkeeper controls its lights and its Transition. You no longer need to go through Repair.
  • Smoother circadian lights. Each part of the day now blends into the next, and the time you set is the halfway point of the change. Existing circadian lights are set to Quick, which is the closest to how they behaved before.
  • Icons on every value a device shows.

Fixed:

  • A paused device no longer marks your lights as “changed by hand” when you adjust them from another app.

Now in every language Homey supports

  • GB, NL, DE, FR, IT, SE, NO, ES, DK, RU, PL, KR, AR
  • Each language uses its own plurals and number formats, and Arabic reads right to left. If a translation reads oddly, please tell me here and I’ll fix it.

Good to know

  • Your existing devices update automatically, so there’s nothing to set up again.
  • If a device is set to “Set lights before they turn on” but its lights haven’t been tested, its page now says so. Run the light test from Repair to turn pre-staging on.

Lightkeeper is still early access, so feedback is very welcome :heart: