PollWatt User Guide

Before You Start

To use PollWatt, you'll need:

• A Mac running macOS 13 or later, or an iPhone/iPad running iOS/iPadOS 16 or later
• A CyberPower UPS with an RMCard 205 (or compatible) network management card installed
• SNMP enabled on the RMCard — you can check this in the RMCard's web interface under Network → SNMP
• Your device and the RMCard on the same local network

Adding Your First Device

Tap the + button (or press Cmd+N on macOS) to open the Add Device screen.

Step 1: Enter the device address

Type the IP address or hostname of your RMCard. PollWatt verifies DNS resolution as you type. Leave the port at 161 unless you've changed it on the RMCard.

Step 2: Choose your SNMP version and credentials

Select v1, v2c, or v3 from the dropdown. For v1/v2c, enter the community string (usually public). For v3, enter your username and authentication details. See Choosing an SNMP Version for guidance.

Step 3: Set the poll interval

Choose how often PollWatt checks the UPS. The default is 10 seconds. You can go as low as 5 seconds, though faster intervals generate more network traffic.

Step 4: Test the connection

Tap Test Connection before saving. A successful test shows the UPS model name. If it fails, double-check the IP, SNMP version, and credentials.

Step 5: Save

Tap Save and polling begins immediately. If you left the name blank, PollWatt automatically names the device from the RMCard's hostname after the first successful poll.

Choosing an SNMP Version

v2c (recommended)

The simplest option. Uses a community string for access (default is public). Supports all metrics. Choose this unless your network requires v3 authentication.

v1

Works the same as v2c but with older protocol limitations. Use v2c instead when possible.

v3 (authenticated)

Use v3 when your RMCard requires username/password authentication. PollWatt supports MD5 and SHA-1 authentication. Set the username and password to match what's configured in the RMCard web UI under SNMP → SNMPv3.

Your v3 passwords are stored securely in the Keychain and sync via iCloud Keychain when iCloud Sync is enabled.

PollWatt currently supports authNoPriv (authentication without encryption).

Reading the Dashboard

The Overview screen gives you a snapshot of all your UPS devices at once.

The header

At the top you'll see Total Watts, Total Amps, and Avg Load across all connected devices. Long-press (or right-click on macOS) to copy these values to the clipboard.

Status badges

Below the header, colored badges appear when something needs attention:

• Red badge — number of devices with errors (unreachable, timed out)
• Orange badge — number of devices running on battery power

Device cards

Each device shows its name, location, IP address, and current metrics (watts, amps, load %, battery). A colored dot indicates status: green = online, red = error, gray = inactive.

Sorting

Use the sort controls at the bottom of the sidebar to reorder devices by watts, amps, or load. You can also drag to reorder manually, or swipe to delete.

Viewing Device Details

Tap any device in the sidebar to see its full detail page.

What you'll see

• Output — watts, amps, load %, voltage, frequency, apparent power, and online/battery status
• Battery — charge percentage, estimated runtime, battery status, voltage, and health
• Input — input voltage, frequency, and power quality status
• Environment — temperature and humidity with alarm thresholds (only when a sensor is connected)
• Info — serial number, location, uptime, model, ratings, and firmware. Right-click to copy all values.
• Notes — add a one-line note (rack location, maintenance date, etc.) that syncs via iCloud

When a device is offline

If PollWatt can't reach a device, you'll see a red banner saying "Unable to reach device" with the time since the last successful response. If the device has never connected, a large "No Data" message appears in place of metric cards.

When a UPS is on battery

An orange banner appears at the top of the detail page showing estimated runtime remaining.

Understanding the colors

Tap the info button (ⓘ) in the toolbar to see a guide explaining what each color means on the output, battery, input, and environment cards.

Using Charts

Each device detail page includes two charts that update as data comes in:

• Watts + Amps — a dual-axis chart with power draw on the left and current on the right
• Battery Charge % — battery level over time

Interacting with charts

On macOS, hover over the chart to see exact values at any point. On iOS, touch and drag across the chart. A tooltip appears showing the timestamp and values.

Showing and hiding series

Tap the Watts or Amps chip above the chart to toggle each series on or off. These preferences sync across your devices via iCloud.

Overview chart

The dashboard includes a rollup chart showing total watts and amps across all your devices over the last 30 minutes.

Environment Sensor

If you have a CyberPower ENVIROSENSOR connected to your RMCard, PollWatt automatically detects it and shows an Environment card on the device detail page.

What's displayed

• Temperature in Fahrenheit, with high and low alarm thresholds
• Humidity as a percentage, with high and low thresholds
• Alarm status — green for normal, colored indicators for low/high alarms

How to tell which devices have a sensor

A teal thermometer icon appears next to the device name in the sidebar. If you don't see it, the sensor isn't detected — check that it's physically connected to the RMCard.

Using the Menu Bar (macOS)

The menu bar gives you a quick view of your UPS status without opening the full app.

How to enable it

Go to Settings → Menu Bar and turn on Show in Menu Bar. Total watts and amps appear in your menu bar, updating with each poll.

Using the popover

Click the menu bar item to open a popover showing all your devices with current metrics — the same dashboard you see in the main window.

Right-click menu

Right-click (or Control-click) the menu bar item for quick access to Open, Settings, Add Device, and Quit.

Customization

• Monochrome Glyphs — switches the colored ⚡ and ∿ symbols to white for a cleaner look
• Hide Dock Icon — removes PollWatt from the Dock and Cmd+Tab, making the menu bar the only interface. Requires a relaunch.
• Popover Sort Order — choose how devices are sorted in the popover

Syncing with iCloud

Turn on iCloud Sync to keep your device list, notes, and preferences the same on all your Apple devices.

How to enable

Go to Settings → Sync and toggle iCloud Sync on. You'll also be offered this during first launch.

What syncs across devices

• Your device list (host, port, SNMP version, credentials, poll interval)
• Device notes
• Sort order and chart preferences
• Privacy settings (Hide Serial Number, Hide Location)
• SNMPv3 passwords (via iCloud Keychain)

What stays local

• Poll history and connection logs — these are in-memory and reset on restart
• Menu bar and dock icon settings — macOS-only, local to each Mac

Resolving conflicts

If your local devices don't match what's in iCloud (e.g. you added a device on one Mac while another was offline), PollWatt shows a dialog asking you to choose: Keep Local or Use iCloud.

Removing synced data

To delete everything from iCloud, go to Settings → Sync → Remove All iCloud Data. This only removes the iCloud copy — your local devices aren't affected.

Managing Devices

Editing a device

On macOS, right-click a device in the sidebar and choose Edit Device, or tap Edit in the device detail toolbar. On iOS, tap Edit in the toolbar. You can change the name, host, credentials, poll interval, or disable polling.

Deleting a device

On macOS, right-click and choose Delete Device, or use the trash icon in the toolbar. On iOS, swipe left on a device in the sidebar, or use the ellipsis menu (…) in the device detail toolbar. Deletion is permanent and removes stored credentials.

Reordering devices

With sort set to Manual, drag devices in the sidebar to reorder them. This order syncs via iCloud.

Adding a note

On any device's detail page, tap the pencil icon to add a one-line note — rack location, last maintenance date, anything useful. Press Return or tap away to save. Notes sync via iCloud.

Customizing Settings

macOS

Open Settings from the menu bar (PollWatt → Settings or Cmd+,). There are five tabs:

iOS / iPadOS

Tap the gear icon to open Settings as a scrollable sheet with the same Sync, Privacy, and About sections.

Your Privacy

PollWatt collects zero data. No telemetry, no analytics, no crash reports, no accounts.

• All SNMP communication stays on your local network — nothing is sent to any server
• iCloud Sync is optional and only stores your device config via Apple's iCloud Key-Value Store
• SNMPv3 passwords are stored in your Keychain, not in plain text

Where your data lives

Hiding sensitive info

Taking a screenshot or sharing your screen? Turn on Hide Serial Number and Hide Location in Settings → Privacy. These settings sync via iCloud so they apply everywhere.

Read the full Privacy Policy and End User License Agreement.

Troubleshooting

A device shows "No response"

• Make sure the RMCard is reachable: ping 192.168.1.100
• Confirm SNMP is enabled in the RMCard web UI under Network → SNMP
• Double-check the community string or v3 username/password
• Make sure your firewall isn't blocking UDP port 161

I don't see environment sensor data

• Check that the ENVIROSENSOR is physically plugged into the RMCard
• Verify the sensor shows readings in the RMCard web UI
• Test it from Terminal: snmpget -v2c -c public <IP> 1.3.6.1.4.1.3808.1.1.4.2.1.0

Some metrics show 0 or are missing

This is expected with CyberPower RMCard firmware. Standard SNMP OIDs often return 0, and PollWatt automatically uses CyberPower-specific OIDs as a fallback. If a metric is still missing, the RMCard may not support that particular reading.

I see a conflict dialog when opening the app

This means your local device list differs from what's in iCloud. Choose Keep Local to keep what's on this device, or Use iCloud to pull down the iCloud version. This typically happens when you add or remove a device on one Mac while another was closed.

The menu bar isn't showing anything

The menu bar label stays hidden until the first poll returns valid data. Wait for one poll cycle after enabling it. If it still doesn't appear, check that at least one device is online and returning data.

What RMCard models are supported?

PollWatt has been tested with the RMCard 205, firmware v1.6.0. Other CyberPower RMCard models may work, but aren't officially tested.