HomePulse

HomePulse is a macOS app that watches a list of smart home devices and makes connection problems obvious at a glance.

Each device appears as a square tile:

• Gray: the device has not been pinged yet in this session.
• Green: every ping in this session has succeeded.
• Yellow: at least one ping has failed in this session, but the device is not in an active outage.
• Red: the device has failed three pings in a row and is likely in an ongoing outage.

What It Does

• Monitors a list of device names and IP addresses on a repeating interval.
• Uses a default ping cadence of every 5 seconds.
• Lets you change that cadence from the in-app monitoring settings.
• Imports devices from CSV.
• Lets you add, edit, delete, and clear devices.
• Opens a lightweight diagnostics pop-up for each device with session history and network details when available.

CSV Format

HomePulse accepts either:

• a header row with Name and IP Address
• a simple two-column Name,IP Address file with no header row

Example:

Name,IP Address
Living Room TV,192.168.1.45
Kitchen Speaker,192.168.1.63
Garage Hub,192.168.1.91

Header matching is case-insensitive.

Build

Run the main build script from the project root:

./build.sh

The script will:

• build the release app
• create ./Artifacts/HomePulse.app
• create ./Artifacts/HomePulse.dmg
• print file:// links for each artifact

For a local debug build-and-run loop inside Codex or a terminal, use:

./script/build_and_run.sh

Notes

• HomePulse uses the system ping command for monitoring.
• Device history colors reset when you relaunch the app.
• The device list and monitoring interval are restored between launches.
• MAC address and reverse-DNS details are best-effort and depend on what your Mac can discover on the local network.