gitwtfhub

wtf is wiz-mac-control?

idlivada/wiz-mac-control — explained in plain English

Analysis updated 2026-05-18

1SwiftAudience · generalComplexity · 2/5Setup · easy

TL;DR

A macOS menu bar app that controls two Wiz smart bulbs directly over the local network, with no phone app, cloud account, or internet required.

Mindmap

mindmap
  root((wiz control))
    What it does
      Menu bar bulb control
      Color wheel and sliders
      Saved scene presets
    Tech stack
      Swift
      macOS menu bar app
      UDP networking
    Use cases
      Dim and color two bulbs instantly
      Save favorite lighting scenes
      Control lights without internet
    Audience
      Mac users
      Smart home tinkerers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Control two Wiz smart bulbs from the Mac menu bar without opening a phone app.

REASON 2

Save a favorite color and brightness combination as a one click preset.

REASON 3

Dim or change bulb color instantly even when the internet is offline.

REASON 4

Set the app to launch automatically at login so it is always available.

What's in the stack?

SwiftmacOSUDP

How it stacks up

idlivada/wiz-mac-controlaakarsh-goyal/macjuicealtuzar/sonicflow
Stars111
LanguageSwiftSwiftSwift
Setup difficultyeasyeasyeasy
Complexity2/51/52/5
Audiencegeneralgeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · easy Time to first run · 5min

The downloaded app is not notarized, so macOS quarantines it until you clear that flag manually.

No license information is given in the README.

Wtf does this do

Wiz Control is a small Mac app that lives in the menu bar at the top of the screen and lets you control two Wiz brand smart light bulbs without opening a phone app, creating an account, or relying on the internet. It talks directly to the bulbs over your home network using a simple network message format, so it works instantly even if your internet connection is down. Clicking the menu bar icon opens a small popup with a color wheel you can spin or tap to pick an exact color, a slider that moves between warm candlelight and cool daylight white, and a brightness slider, all of which change the bulbs in real time as you drag them. Small colored dots show the current state of each bulb at a glance. You can control both bulbs together, which is the default, or switch to controlling each one on its own. There are five preset slots you can click to instantly load a saved scene, and you can right-click a preset to save, rename, or clear it, with each preset remembering its own color, brightness, and on or off state per bulb. The app can also be set to launch automatically when you log in, and the network address of each bulb can be edited directly inside the popup, with that setting remembered the next time you open the app. Every time you open the popup, the app checks in with the real bulbs to make sure what it shows matches their actual current state. You can install it two ways: downloading a ready made zipped copy from the project's releases page and moving it into the Applications folder, or building it yourself from the source code using only Apple's Swift command line tools, without needing the full Xcode application. Because the downloaded app is not officially notarized by Apple, macOS will initially block it as quarantined, and the README explains the one line terminal command needed to clear that block. The first time you run it, macOS will also ask for local network permission, which needs to be approved or the bulbs will appear unresponsive.

Yoink these prompts

Prompt 1
Walk me through downloading and installing WizControl.app on my Mac, including clearing the quarantine flag.
Prompt 2
Explain how to build wiz-mac-control from source using only the Swift command line tools.
Prompt 3
Show me how to update the IP addresses for my two Wiz bulbs inside the app.
Prompt 4
Explain what local network permission this app needs on first launch and why.

Frequently asked questions

wtf is wiz-mac-control?

A macOS menu bar app that controls two Wiz smart bulbs directly over the local network, with no phone app, cloud account, or internet required.

What language is wiz-mac-control written in?

Mainly Swift. The stack also includes Swift, macOS, UDP.

What license does wiz-mac-control use?

No license information is given in the README.

How hard is wiz-mac-control to set up?

Setup difficulty is rated easy, with roughly 5min to a first successful run.

Who is wiz-mac-control for?

Mainly general.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.