DuskPlug

A free, open-source tray and menu bar app for Tuya and Smart Life smart plugs on Windows, Linux, and macOS. Turn your desk lamp on at sunset and off at sunrise — no Home Assistant required.

Windows 10/11 Linux macOS Tuya / Smart Life MIT License v1.0.27

Download

Windows

winget (recommended)

winget install DuskPlug.DuskPlug

Windows Package Manager — same MSI as the direct installer.

Scoop

scoop bucket add duskplug https://github.com/DuskPlug/scoop-bucket
scoop install duskplug

Direct download

MSI installer or portable ZIP from GitHub Releases.

Download latest release

Linux

Direct download

Download DuskPlug-Linux-x64.tar.gz from GitHub Releases, extract it, and run ./duskplug.

Download latest release

GNOME may need an AppIndicator extension for the tray icon.

macOS

Direct download

Download DuskPlug-macOS.zip from GitHub Releases, unzip DuskPlug.app, and open it.

Download latest release

Unsigned builds: right-click → Open the first time. Allow location access when Smart Mode requests it.

If DuskPlug helps you, a GitHub star helps others find it — or buy me a coffee to support development.

Star on GitHub Buy me a coffee

Why DuskPlug?

Smart Mode — plug on at sunset, off at sunrise from your location
Schedule Mode — fixed daily on/off times, including overnight windows
Manual control — toggle from the tray or menu bar
Multi-device — plugs and dimmable bulbs, each with its own mode
Your Tuya project only — credentials stay on your PC
Lock-off — optional turn-off when the computer is locked or sleeping
Screen brightness — optional automatic monitor dimming through the day

Screenshots

Windows UI shown below; Linux and macOS use the same features from the tray or menu bar.

DuskPlug tray menu with Smart Mode and screen brightness on Windows 11 — Tray menu with Smart Mode and screen brightness

DuskPlug Settings — Connection tab — Settings — Connection

DuskPlug Settings — Devices tab — Settings — Devices

DuskPlug Settings — Location tab — Settings — Location

DuskPlug Settings — Screen tab — Settings — Screen brightness

DuskPlug Settings — General tab — Settings — General

Getting started

You need a free Tuya Developer Platform project linked to the same Smart Life or Tuya phone app that controls your plug. The one-time setup takes about 10 minutes.

Setup guide Full guide on GitHub