Skip to content
Philips Hue SDK
Swift Other
  1. Swift 98.8%
  2. Other 1.2%
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
Sources fix lightlevel sensor Nov 8, 2019
SwiftyHue Example Watch Extension Updates for swift 3 Oct 26, 2016
SwiftyHue Example Watch Changed projekt structure May 26, 2016
SwiftyHue Example tvOS updates for swift5 Oct 25, 2019
SwiftyHue Example
SwiftyHue iOSTests
SwiftyHue macOSTests
SwiftyHue.playground Refactored Sensor Models Jul 1, 2016
.gitignore Changed projekt structure May 26, 2016
Cartfile updates for swift5 Oct 25, 2019
Cartfile.private Bumps Nocilla to 0.11.0 Aug 4, 2016
Info-macOS.plist Adds plist for macOS Aug 4, 2016
SwiftyHue.podspec prepare new release Nov 8, 2019

Carthage compatible CocoaPods compatible Platform


Philips Hue SDK written in swift

Work in progress...



Carthage is a decentralized dependency manager that automates the process of adding frameworks to your Cocoa application.

To integrate SwiftyHue into your Xcode project using Carthage, specify it in your Cartfile:

github "Spriter/SwiftyHue"


CocoaPods is a dependency manager for Cocoa projects. You can install it with the following command:

$ gem install cocoapods

To integrate SwiftyHue into your Xcode project using CocoaPods, specify it in your Podfile:

source ''

pod 'SwiftyHue', '0.4.1'

Then, run the following command:

$ pod install

Example with submodules

SwiftyHue/Base: The core functionality of SwiftyHue.

SwiftyHue/BridgeServices: Provides classes to find bridges in a network and authenticate with them.

target 'MyApp' do

  pod ’SwiftyHue’, '0.3.3'


target 'MyApp tvOS' do
    pod ’SwiftyHue’, '0.3.3'

target 'MyApp watchOS Extension' do
    pod ’SwiftyHue/Base’, '0.3.3'

Note: You can use SwiftyHue/Base submodule to use SwiftyHue also on watchOS.


Find Bridge

The first step is to find a bridge in the network.

let bridgeFinder = BridgeFinder()
bridgeFinder.delegate = self;

Implement the BridgeFinderDelegate protocol to get the search results.

extension BridgeSelectionTableViewController: BridgeFinderDelegate {
    func bridgeFinder(finder: BridgeFinder, didFinishWithResult bridges: [HueBridge]) {
        let bridges = bridges;

Bridge Authenticator

Before you can connect to a bridge you need to create user.

var bridgeAuthenticator: BridgeAuthenticator! = BridgeAuthenticator(bridge: bridge, uniqueIdentifier: "swiftyhue#\(UIDevice.currentDevice().name)")

Implement the BridgeAuthenticatorDelegate protocol to get the authentication events.

extension BridgePushLinkViewController: BridgeAuthenticatorDelegate {
    func bridgeAuthenticator(authenticator: BridgeAuthenticator, didFinishAuthentication username: String) {
    func bridgeAuthenticator(authenticator: BridgeAuthenticator, didFailWithError error: NSError) {
    // you should now ask the user to press the link button
    func bridgeAuthenticatorRequiresLinkButtonPress(authenticator: BridgeAuthenticator) {

    // user did not press the link button in time, you restart the process and try again
    func bridgeAuthenticatorDidTimeout(authenticator: BridgeAuthenticator) {


Setup Heartbeat for resource updates.

let bridgeAccessConfig= BridgeAccessConfig(bridgeId: "YOUR_BRIDGE_ID", ipAddress: "YOUR_BRIDGE_IP", username: "YOUR_BRIDGE_USERNAME")
let swiftyHue: SwiftyHue = SwiftyHue();

swiftyHue.setLocalHeartbeatInterval(10, forResourceType: .Lights)
swiftyHue.setLocalHeartbeatInterval(10, forResourceType: .Groups)
swiftyHue.setLocalHeartbeatInterval(10, forResourceType: .Rules)
swiftyHue.setLocalHeartbeatInterval(10, forResourceType: .Scenes)
swiftyHue.setLocalHeartbeatInterval(10, forResourceType: .Schedules)
swiftyHue.setLocalHeartbeatInterval(10, forResourceType: .Sensors)
swiftyHue.setLocalHeartbeatInterval(10, forResourceType: .Config)


Register for Update Events.

NSNotificationCenter.defaultCenter().addObserver(self, selector: #selector(ViewController.lightChanged), name: ResourceCacheUpdateNotification.LightsUpdated.rawValue, object: nil)

Use the resource cache.

if let cache = swiftyHue.resourceCache {
    // Dict of lights [String: Light]. Keys are the light identifiers.
    let lights = cache.lights

Send API

You can use the SendAPI to send requests to the bridge. For example recall a Scene or create a group.

let sendAPI = swiftyHue.brideSendAPI

More coming soon...

Resource API

You can use the resourceAPI to request resources from the bridge. For example all groups.

let resourceAPI = swiftyHue.resourceAPI

resourceAPI.fetchGroups { (result) in

    guard let groups = result.value else {

Generate documentation

Install jazzy:

$ [sudo] gem install jazzy

Run generate script:

$ ./


We use 'Log' for Logging. Log` is a powerful logging framework that provides built-in themes and formatters, and a nice API to define your owns.

Get the most out of Log by installing XcodeColors and KZLinkedConsole


We'd love to see your ideas for improving this repo! The best way to contribute is by submitting a pull request. We'll do our best to respond to your patch as soon as possible. You can also submit a issue if you find bugs. :octocat:

Please make sure to follow our general coding style and add test coverage for new features!


You need Carthage to work on the SwiftyHue Project. If you have Carthage installed just run

$ carthage bootstrap

in the root directory of the project. Remember to build the SwiftyHue framework targets to run the example application targets.

Made with SwiftyHue

You can’t perform that action at this time.