{ "name": "hue", "kind": "registry", "title": "Hue", "description": "Your Philips Hue lights, rooms and scenes under the keys, kept live as they change. Set colour, brightness and warmth, check sensors, and see the home at a glance from the menu bar.", "version": "0.1.0", "icon": { "tile": { "svg": "M20.672 9.6c-2.043 0-3.505 1.386-3.682 3.416h-.664c-.247 0-.395.144-.395.384 0 .24.148.384.395.384h.661c.152 2.09 1.652 3.423 3.915 3.423.944 0 1.685-.144 2.332-.453.158-.075.337-.217.292-.471a.334.334 0 0 0-.15-.242c-.104-.065-.25-.072-.422-.02a7.93 7.93 0 0 0-.352.12c-.414.146-.771.273-1.599.273-1.75 0-2.908-1.023-2.952-2.605v-.025h5.444c.313 0 .492-.164.505-.463v-.058C23.994 9.865 21.452 9.6 20.672 9.6zm2.376 3.416h-5l.004-.035c.121-1.58 1.161-2.601 2.649-2.601 1.134 0 2.347.685 2.347 2.606zM9.542 10.221c0-.335-.195-.534-.52-.534s-.52.2-.52.534v2.795h1.04zm4.29 3.817c0 1.324-.948 2.361-2.16 2.361-1.433 0-2.13-.763-2.13-2.333v-.282h-1.04v.34c0 2.046.965 3.083 2.868 3.083 1.12 0 1.943-.486 2.443-1.445l.02-.036v.861c0 .334.193.534.519.534.325 0 .52-.2.52-.534v-2.803h-1.04zm.52-4.351c-.326 0-.52.2-.52.534v2.795h1.04v-2.795c0-.335-.195-.534-.52-.534zM3.645 9.6c-1.66 0-2.31 1.072-2.471 1.4l-.135.278V7.355c0-.347-.199-.562-.52-.562-.32 0-.519.215-.519.562v5.661h1.039v-.015c0-1.249.72-2.592 2.304-2.592 1.29 0 2.001.828 2.001 2.332v.275h1.04v-.246c0-2.044-.973-3.17-2.739-3.17zM0 16.558c0 .347.199.563.52.563.32 0 .519-.216.519-.563v-2.774H0zm5.344 0c0 .347.2.563.52.563s.52-.216.52-.563v-2.774h-1.04z", "box": 24, "bg": "#0065D3" } }, "author": "pal", "spec": "github:zcag/pal/extensions/hue@v0.9.1", "source": "https://github.com/zcag/pal/tree/HEAD/extensions/hue", "commit": "63287e180ce349dac3aa87c68ce4c80bc42ad409", "manifest": { "name": "hue", "title": "Hue", "description": "Your Philips Hue lights, rooms and scenes under the keys, kept live as they change. Set colour, brightness and warmth, check sensors, and see the home at a glance from the menu bar.", "keywords": [ "lights" ], "version": "0.1.0", "icon": { "tile": { "svg": "M20.672 9.6c-2.043 0-3.505 1.386-3.682 3.416h-.664c-.247 0-.395.144-.395.384 0 .24.148.384.395.384h.661c.152 2.09 1.652 3.423 3.915 3.423.944 0 1.685-.144 2.332-.453.158-.075.337-.217.292-.471a.334.334 0 0 0-.15-.242c-.104-.065-.25-.072-.422-.02a7.93 7.93 0 0 0-.352.12c-.414.146-.771.273-1.599.273-1.75 0-2.908-1.023-2.952-2.605v-.025h5.444c.313 0 .492-.164.505-.463v-.058C23.994 9.865 21.452 9.6 20.672 9.6zm2.376 3.416h-5l.004-.035c.121-1.58 1.161-2.601 2.649-2.601 1.134 0 2.347.685 2.347 2.606zM9.542 10.221c0-.335-.195-.534-.52-.534s-.52.2-.52.534v2.795h1.04zm4.29 3.817c0 1.324-.948 2.361-2.16 2.361-1.433 0-2.13-.763-2.13-2.333v-.282h-1.04v.34c0 2.046.965 3.083 2.868 3.083 1.12 0 1.943-.486 2.443-1.445l.02-.036v.861c0 .334.193.534.519.534.325 0 .52-.2.52-.534v-2.803h-1.04zm.52-4.351c-.326 0-.52.2-.52.534v2.795h1.04v-2.795c0-.335-.195-.534-.52-.534zM3.645 9.6c-1.66 0-2.31 1.072-2.471 1.4l-.135.278V7.355c0-.347-.199-.562-.52-.562-.32 0-.519.215-.519.562v5.661h1.039v-.015c0-1.249.72-2.592 2.304-2.592 1.29 0 2.001.828 2.001 2.332v.275h1.04v-.246c0-2.044-.973-3.17-2.739-3.17zM0 16.558c0 .347.199.563.52.563.32 0 .519-.216.519-.563v-2.774H0zm5.344 0c0 .347.2.563.52.563s.52-.216.52-.563v-2.774h-1.04z", "box": 24, "bg": "#0065D3" } }, "author": "pal", "repo": "bundled", "license": "MIT", "settings": [ { "kind": "text", "id": "bridge", "label": "Bridge", "placeholder": "192.168.1.25", "description": "The bridge's address, for a key kept in the keychain (below). Pairing from Set up Hue needs neither: it finds the bridge and keeps the key in pal's storage.", "default": "" }, { "kind": "secret", "id": "application_key", "label": "Application key", "placeholder": "keychain:pal/hue-application_key", "description": "The hue-application-key for the bridge above, as a keychain: or env: reference. Set up Hue shows the key it made (c copies it); pasting it here moves it into the keychain.", "default": "" }, { "kind": "boolean", "id": "insecure", "label": "Certificate", "text": "Skip the bridge's certificate check", "description": "Off, every request is verified against Signify's root CA plus the certificate pinned at pairing. On for a bridge behind a proxy or a very old firmware whose certificate fails that.", "default": false }, { "kind": "number", "id": "transition", "label": "Transition", "description": "How long a change from a row or a link takes on the lights; the view has its own, cycled with d.", "min": 0, "max": 10000, "step": 100, "unit": "ms", "default": 400 }, { "kind": "number", "id": "timeout", "label": "Timeout", "description": "How long one request to the bridge may take before the row says it did not answer.", "min": 1, "max": 30, "step": 1, "unit": "s", "default": 5 } ], "store": { "tagline": "Every Hue light, room and scene, live, under the keys", "category": "integration", "features": [ "Rooms and scenes at the root: type `living room` to toggle it, `relax` to play the scene", "A light or room in full: brightness on the arrows, warmth, colour, presets, scenes and effects", "Live: changes made in the Hue app or on a switch show up at once", "Sensors with their last reading and battery; automations and entertainment areas on or off", "A bar item with the lights that are on; its popover toggles rooms and plays scenes", "Guided setup finds the bridge and waits for its button; several bridges act as one home" ], "permissions": [ "network" ], "platforms": [ "macos", "linux" ], "screenshots": [ { "file": "1-rooms.png", "caption": "Rooms and zones with their colour, how many lights are on and the brightness; Enter toggles, cmd+Enter opens the room" }, { "file": "2-light.png", "caption": "A light under the keys: the tile in its colour, brightness, the temperature strip, the colour plane, presets, scenes and effects" }, { "file": "3-room.png", "caption": "A room under the keys, its scenes row focused: the arrows choose, Enter plays" }, { "file": "4-scenes.png", "caption": "Scenes by room as five-swatch strips, the active and dynamic ones tagged" }, { "file": "5-sensors.png", "caption": "Sensors and switches by device: motion, temperature, light level, the last button press, batteries" }, { "file": "6-setup.png", "caption": "Set up Hue waiting for the button, with the countdown" }, { "file": "bar-menubar.png", "caption": "On the menu bar: the bulb and how many lights are on", "kind": "bar" }, { "file": "bar-popover.png", "caption": "A click opens the popover: the rooms as tiles in their colour (the switch toggles, the chevron opens), the motion and temperature, the main room's scenes, the keys", "kind": "bar", "box": [ 420, 64, 840, 792 ] }, { "file": "bar-popover-room.png", "caption": "The living room opened: its lights inline, each with a brightness slider and a switch; the arrows walk them", "kind": "bar", "box": [ 420, 64, 840, 960 ] }, { "file": "bar-sketchybar.png", "caption": "On sketchybar: the bulb and the count on the label", "kind": "bar" } ], "actions": [ { "title": "Toggle", "description": "A room, zone or light.", "keys": "enter" }, { "title": "Open room / Open light", "description": "The view under the keys.", "keys": "cmd+enter" }, { "title": "Turn on / Turn off" }, { "title": "Set brightness or temperature", "description": "The bar's fields on a room or light row: a brightness in % (0 is off) and, where the light tunes white, a colour temperature in K; one PUT with the transition.", "keys": "cmd+shift+b" }, { "title": "Scenes of the room", "keys": "cmd+s" }, { "title": "Lights in the room", "keys": "cmd+l" }, { "title": "Blink to find it", "description": "A light breathes once.", "keys": "cmd+b" }, { "title": "Copy colour", "description": "The light's colour as hex.", "keys": "cmd+c" }, { "title": "Copy id", "description": "For item_hotkeys and links.", "keys": "cmd+shift+c" }, { "title": "Activate", "description": "A scene.", "keys": "enter" }, { "title": "Play dynamically", "description": "A scene with a palette.", "keys": "cmd+enter" }, { "title": "Copy value", "description": "A sensor's reading.", "keys": "enter" }, { "title": "Enable or disable", "description": "A sensor or an automation.", "keys": "cmd+e" }, { "title": "Start streaming / Stop streaming", "description": "An entertainment area.", "keys": "enter" }, { "title": "Set up Hue", "description": "Find a bridge, press its button, pair." } ] }, "palettes": { "rooms": { "title": "Hue Rooms", "kind": "live", "lazy": true, "tier": "primary", "description": "Every room and zone with its colour as a tile, how many of its lights are on and the brightness. Enter toggles it, cmd+Enter opens it under the keys.", "keys": [ { "keys": "enter", "title": "Toggle the room" }, { "keys": "cmd+enter", "title": "Open the room under the keys" }, { "keys": "cmd+shift+b", "title": "Set the brightness (%) and colour temperature (K) typed in the bar" }, { "keys": "cmd+s", "title": "The room's scenes" }, { "keys": "cmd+l", "title": "The room's lights" }, { "keys": "cmd+shift+c", "title": "Copy the id" } ] }, "lights": { "title": "Hue Lights", "kind": "live", "lazy": true, "description": "Every light by room with its colour as a swatch, its brightness and temperature, and whether the bridge can reach it. Enter toggles, cmd+Enter opens it under the keys.", "keys": [ { "keys": "enter", "title": "Toggle the light" }, { "keys": "cmd+enter", "title": "Open the light under the keys" }, { "keys": "cmd+shift+b", "title": "Set the brightness (%) and colour temperature (K) typed in the bar" }, { "keys": "cmd+b", "title": "Blink it" }, { "keys": "cmd+c", "title": "Copy its colour" }, { "keys": "cmd+shift+c", "title": "Copy the id" } ] }, "scenes": { "title": "Hue Scenes", "kind": "live", "lazy": true, "tier": "primary", "description": "Every scene by room as a five-swatch strip of its palette, the active one tagged; smart scenes too. Enter plays it, cmd+Enter plays it dynamically.", "keys": [ { "keys": "enter", "title": "Play the scene" }, { "keys": "cmd+enter", "title": "Play it dynamically" }, { "keys": "cmd+o", "title": "Open the room under the keys" }, { "keys": "cmd+shift+c", "title": "Copy the id" } ] }, "light": { "title": "Hue Light", "kind": "view", "description": "A light or a room under the keys: the tile in its colour, brightness on the arrows and digits, colour temperature and colour on strips, presets, the room's scenes, effects, the scope and the transition.", "keys": [ { "keys": "left, right", "title": "Brightness (shift: big steps); hue on the colour row; choose on the other rows" }, { "keys": "up, down", "title": "Cooler or warmer; saturation on the colour row; the row above or below elsewhere" }, { "keys": "1-9, 0", "title": "10% to 90%, off" }, { "keys": "tab, shift+tab", "title": "Light, colour, presets, scenes, effects" }, { "keys": "enter", "title": "Toggle, or apply the chosen preset, scene or effect" }, { "keys": "t, space", "title": "Toggle" }, { "keys": "a", "title": "Apply to this light or the whole room" }, { "keys": "d", "title": "Transition: instant, 400 ms, 1 s, 4 s" }, { "keys": "s", "title": "The room's scenes as a list" }, { "keys": "o", "title": "Open the room" }, { "keys": "i", "title": "Blink the light" }, { "keys": "c", "title": "Copy the colour" }, { "keys": "r", "title": "Read the bridge again" } ] }, "setup": { "title": "Set up Hue", "kind": "view", "description": "Pairing: the bridges found on the network, press-link with a countdown, the key kept and the certificate pinned.", "keys": [ { "keys": "1-9, enter", "title": "Pair with a bridge" }, { "keys": "i", "title": "Type an address" }, { "keys": "r", "title": "Scan again" }, { "keys": "x", "title": "Forget a bridge, or stop a pairing" }, { "keys": "b", "title": "Back to the bridges" }, { "keys": "c", "title": "Copy the key once paired" } ] }, "sensors": { "title": "Hue Sensors", "kind": "live", "lazy": true, "description": "Motion, temperature, light level, buttons and dials with their last event, contact sensors, and each device's battery. Enter copies the reading, cmd+e enables or disables the sensor.", "keys": [ { "keys": "enter", "title": "Copy the reading" }, { "keys": "cmd+e", "title": "Enable or disable" }, { "keys": "cmd+shift+c", "title": "Copy the id" } ] }, "automations": { "title": "Hue Automations", "kind": "live", "lazy": true, "description": "The bridge's automations (wake up, go to sleep, timers, motion) with their status. Enter enables or disables one.", "keys": [ { "keys": "enter", "title": "Enable or disable" }, { "keys": "cmd+shift+c", "title": "Copy the id" } ] }, "entertainment": { "title": "Hue Entertainment", "kind": "live", "lazy": true, "description": "Entertainment areas with their type and lights; Enter starts streaming, cmd+Enter stops it.", "keys": [ { "keys": "enter", "title": "Start streaming" }, { "keys": "cmd+enter", "title": "Stop streaming" }, { "keys": "cmd+shift+c", "title": "Copy the id" } ] } }, "bar": { "home": { "title": "Home", "description": "How many lights are on, the main room's colour as a dot; the popover: the rooms as colour tiles that toggle on a tap, a room's lights inline with sliders, the scenes, the sensors, everything on or off. Hidden until a bridge is paired.", "refresh": { "every": 60, "on": [ "show", "wake", "network" ] }, "settings": [ { "kind": "text", "id": "main_room", "label": "Main room", "placeholder": "Living room", "description": "The room the item's tooltip names and whose scenes its popover lists. Empty: the room with most lights on.", "default": "" }, { "kind": "list", "id": "scenes", "label": "Scenes", "placeholder": "Relax", "description": "Scene names (or ids like scene:living-room/relax) listed in the popover, in this order. Empty: the main room's scenes.", "default": [] } ], "mocks": { "on": { "title": "Lights on, the main room's colour as a dot", "item": { "icon": "󰌵", "title": "5 on", "tooltip": "5 of 12 lights on · Living room 72%" } }, "off": { "title": "All lights off", "item": { "icon": "󰌶", "color": "muted", "tooltip": "All lights off" } }, "away": { "title": "Bridge not answering, last state kept", "item": { "icon": "󰌶", "color": "muted", "stale": true, "tooltip": "All lights off" } }, "unpaired": { "title": "Bridge not paired", "item": { "icon": "󰌶", "color": "muted", "stale": true, "tooltip": "Hue: the bridge did not answer" } }, "none": { "title": "No bridge configured", "item": { "hidden": true } } }, "keys": [ { "keys": "up", "title": "Move over the rooms; walk an opened room's lights" }, { "keys": "enter", "title": "Open the room under the cursor; toggle the light under it" }, { "keys": "space", "title": "Toggle the room (or the light) under the cursor" }, { "keys": "right", "title": "Brighter by 5 (shift: 20); left dims" }, { "keys": "backspace", "title": "Close the opened room" }, { "keys": "1", "title": "Play the scene with that digit (1 to 9)" }, { "keys": "e", "title": "Everything on" }, { "keys": "x", "title": "All off" }, { "keys": "p", "title": "Open Rooms in pal" }, { "keys": "r", "title": "Read the bridge again" } ] } }, "links": { "toggle": { "description": "Toggle a room, or set it", "params": { "room": { "description": "The room's name, slug or id (living-room, room:living-room)", "required": true }, "on": { "description": "Set rather than toggle", "type": "boolean" } } }, "scene": { "description": "Play a scene", "params": { "name": { "description": "The scene's name or id (relax, scene:living-room/relax)", "required": true }, "room": { "description": "The room, when the name is in several" }, "dynamic": { "description": "Play its palette dynamically", "type": "boolean" } } }, "off": { "description": "Every light off" } } }, "playable": false, "updated_at": "2026-09-30T01:45:08Z", "url": "https://pal.cagdas.io/extensions/hue", "tagline": "Every Hue light, room and scene, live, under the keys", "category": "integration", "screenshots": [ "https://pal.cagdas.io/extensions/hue/screenshots/1-rooms-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/1-rooms.png", "https://pal.cagdas.io/extensions/hue/screenshots/2-light-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/2-light.png", "https://pal.cagdas.io/extensions/hue/screenshots/3-room-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/3-room.png", "https://pal.cagdas.io/extensions/hue/screenshots/4-scenes-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/4-scenes.png", "https://pal.cagdas.io/extensions/hue/screenshots/5-sensors-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/5-sensors.png", "https://pal.cagdas.io/extensions/hue/screenshots/6-setup-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/6-setup.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-menubar-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-menubar.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-popover-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-popover-room-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-popover-room.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-popover.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-sketchybar-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-sketchybar.png" ], "panel_screenshots": [ "https://pal.cagdas.io/extensions/hue/screenshots/1-rooms.png", "https://pal.cagdas.io/extensions/hue/screenshots/2-light.png", "https://pal.cagdas.io/extensions/hue/screenshots/3-room.png", "https://pal.cagdas.io/extensions/hue/screenshots/4-scenes.png", "https://pal.cagdas.io/extensions/hue/screenshots/5-sensors.png", "https://pal.cagdas.io/extensions/hue/screenshots/6-setup.png" ], "bar_screenshots": [ "https://pal.cagdas.io/extensions/hue/screenshots/bar-menubar.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-popover-room.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-popover.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-sketchybar.png" ], "panel_screenshots_dark": [ "https://pal.cagdas.io/extensions/hue/screenshots/1-rooms-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/2-light-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/3-room-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/4-scenes-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/5-sensors-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/6-setup-dark.png" ], "bar_screenshots_dark": [ "https://pal.cagdas.io/extensions/hue/screenshots/bar-menubar-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-popover-room-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-popover-dark.png", "https://pal.cagdas.io/extensions/hue/screenshots/bar-sketchybar-dark.png" ], "has_bar": true, "bar_items": [ { "id": "home", "title": "Home", "description": "How many lights are on, the main room's colour as a dot; the popover: the rooms as colour tiles that toggle on a tap, a room's lights inline with sliders, the scenes, the sensors, everything on or off. Hidden until a bridge is paired.", "refresh": { "every": 60, "on": [ "show", "wake", "network" ] }, "refresh_words": "every 1 min, when the panel shows, on wake, when the network is back" } ], "has_links": true, "links": [ { "route": "toggle", "url": "pal://hue/toggle?room=\u003croom\u003e", "cli": "pal call hue/toggle room=\u003croom\u003e", "description": "Toggle a room, or set it", "params": [ { "name": "room", "description": "The room's name, slug or id (living-room, room:living-room)", "required": true }, { "name": "on", "description": "Set rather than toggle", "type": "boolean" } ] }, { "route": "scene", "url": "pal://hue/scene?name=\u003cname\u003e", "cli": "pal call hue/scene name=\u003cname\u003e", "description": "Play a scene", "params": [ { "name": "name", "description": "The scene's name or id (relax, scene:living-room/relax)", "required": true }, { "name": "room", "description": "The room, when the name is in several" }, { "name": "dynamic", "description": "Play its palette dynamically", "type": "boolean" } ] }, { "route": "off", "url": "pal://hue/off", "cli": "pal call hue/off", "description": "Every light off", "params": [] } ], "multi": false, "has_readme": true }