Hue-topia - home lighting controller for Mac OSX

Hue-ser guide

1. Tasks

1.1 How do I get everything set up?

1.2 How do I schedule a lamp to switch on / off / change brightness?

1.3 How do I make the computer listen for sound and respond by switching on lights?

1.4 Can I switch lamps on or off by a keystroke?

1.5 I've bought new bulbs, how do I get the bridge to recognise them?

1.6 Getting started tutorial

1.7 Scripting

2. Troubleshooting

2.1 I'm trying to run Hue-topia for the first time and it can't find my bridge

2.2 False dusk doesn't seem to work properly

2.3 My bridge just won't find my bulbs, even after using Lights > Discover New Bulbs

2.4 Controls don't always work, Hue-topia hangs

2.5 F-key assignment doesn't work

 


1. Tasks

1.1 How do I get everything set up?

1. If you've not already done so, make sure your Bridge and some bulbs are switched on. Then start Hue-topia.

2. The only thing you should need to do is to press the button on your bridge the first time that you run Hue-topia. If you have any problems at this stage, see troubleshooting.

1.2 How do I schedule a lamp to switch on / off / change brightness?

1. Press the Schedules button or 'Show schedules' from the View menu (command-2 also shows this window).

2. Press the [+] button at the bottom-left of the Schedules window.

3. Fill in this box, it should all be self-explanatory. Click somewhere outside of the box to save and close those settings.

4. When setting light(s) to switch 'On & Off', the days of the week apply to the 'on' time. If the 'off' time goes past midnight, then the lamp will obviously be turned off the following day.

1.3 How do I make the computer listen for sound and respond by switching on lights?

1. Make a preset with the lights set how you'd like them to be when the computer hears a noise. (see 'How do I make a preset') Perhaps all lights on brightly.

2. Click the Settings button in the toolbar or 'Hue-topia > Preferences from the menu bar (command - comma is the standard keyboard shortcut for Preferences)

3. If you make a noise, you should see flashing lights in the level indicator. This uses your sound input source set in System Preferences > Sound > Input, so check there if you can't see a sound level being indicated.

4. Adjust the slider so that you see red lights if you walk around the room or open a door. Red lights mean that an action will be triggered.

5. The next box chooses which preset is selected when a sound is detected. Select the preset that you made in step 1.

6. If you wish to set a delay so that the lights aren't switched on immediately there's a sound (to hide the fact that it's an automatic response) then set a delay of a few seconds.

7. The next box sets the number of minutes that the lights remain bright before returning to their previous state.

8. Note that if you manually select a preset after the lights have been triggered, then the lights won't automatically return to their previous state.

9. Close the Preferences window.

10. To manually start the computer listening, return to the manual control window and click 'Listen' in the main toolbar. You'll see that there's a delay of 60 seconds which you can use if you are leaving the room or the house.

11. To start the computer listening on schedule (for example, to only listen at night while you are away from home) create a schedule as described in 'How do I schedule a lamp to switch on / off / change brightness' but set the action to 'Start listening'.

1.4 Can I switch lamps on or off by a keystroke?

Choose 'Assign hotkeys' From the Presets drop-down in the toolbar or go to Preferences > Hotkeys. Simply select which preset you'd like to assign to F keys. If this interferes with other software you use, you can set a modifier too. (ie if you're unable to use F1 because another app uses that key, set cmd-F1 or ctrl-F1)

1.5 I've bought new bulbs, how do I get the bridge to recognise them?

File > Discover new bulbs

2. Troubleshooting

2.1 I'm trying to run Hue-topia for the first time and it can't find my bridge

Note that there has been a bug in versions up to 1.2.1 which has caused problems for some users. Please download the current version and that may solve the problem.

Failing that, if your internet connection is OK, then the problem may be a problem with the meethue portal. Problems here are usually temporary and are only likely on the first run (after that, if Hue-topia can't find the bridge it will try the last IP that it successfully used), Either OK the message in Hue-topia and it will try again in 15 seconds, or quit the app and re-start it after a few minutes.

2.2 False dusk doesn't seem to work properly

There is a bug with false dusk which seems to be a problem with certain older bulbs - those bulbs sometimes (not always) switch off quickly regardless of the transition time. False dawn seems to work fine. Suggest switching your bulbs around if you have any of the newer ones so that the newer ones are in the place(s) where you'll use the false dusk. (you can check and compare software versions (swversion) using the new Bridge Explorer in Hue-topia)

2.3 My bridge just won't find my bulbs, even after using Lights > Discover New Bulbs

New bulbs supplied individually should begin life in a network discovery mode and you should be able to pair them with your bridge using Lights > Discover New Bulbs. The bulbs supplied with a starter pack are paired with the bridge that they came with. If your bulbs are not part of your original starter set, have been connected to a different bridge or for any other reason won't pair with your bridge, Touchlink may work.

Move the bulb (lit) and bridge close together, within 30cm, and select Lights > Touchlink. If this works, the lamp will flash a couple of times to confirm. You may then need to select Lights > Discover New Bulbs and wait a minute to add the bulb to Hue-topia. Repeat for each bulb concerned.

Now you can screw each bulb back into its proper location.

This is an alternative to Philips' LampStealer app.

2.4 Controls don't always work / Hue-topia hangs

1. Check the lights on your bridge; are they all on steady, are any off or flashing occasionally or always?

2. If any of the lights on the bridge are not lit steadily, remove the power cord, count to 10 and then plug back in. If all the lights still don't light steadily, then the problem is with the bridge, your network or internet connection. Check which lamp is not lit / flashing. Step 3 below may also help you to identify the problem.

3. Use HueTopia with the bridge warnings window showing (View > Bridge warnings or cmd-4). If anything is reported, email the contents of the window to support@peacockmedia.software

(For number 3, you need to have at least v1.6.3 of HueTopia)

2.5 F-key assignment doesn't work

If you're using a laptop or a newer apple keyboard, you may have an fn key in the bottom-left or in the middle. Your Function keys may have certain OSX functions assigned to them - dimming the screen / keyboard etc. (They may have icons for those functions printed on them more prominently than the 'F' number). You will need to press the fn key along with the actual F-key in order to make it work as an F-key (also with a modifier if you've set one in Hue-topia preferences).

You can change this behaviour in System Preferences > Keyboard > 'Use all F keys as standard F keys'. In that case you will then need to press the fn key to access the special feature of each key.