PowerSpyCli is a multi-platform software to connect and collect power metrics from a PowerSpy 2 powermeter.
PowerSpyCli supports Windows, Linux, and macOS (13 or later) with Python 3. The command line and GUI use the same PowerSpy protocol and produce the same measurements on every platform.
Just download the powerspycli.py file and run it.
PowerSpy 2 uses Bluetooth Classic Serial Port Profile (SPP). Python on macOS needs the PyObjC bridge to access Apple's native RFCOMM API:
python3 -m pip install pyobjc-framework-IOBluetooth
When using a repository checkout, python3 -m pip install -r requirements-macos.txt installs the same declared dependency.
Before running PowerSpyCli for the first time:
- Turn on the PowerSpy 2 and pair it in System Settings > Bluetooth.
- Run PowerSpyCli from Terminal and allow Bluetooth access when macOS asks.
- If access was previously denied, open System Settings > Privacy & Security > Bluetooth and enable access for Terminal or the Python application used to launch PowerSpyCli.
Pairing is a one-time macOS setup step. PowerSpyCli continues to identify the device using its Bluetooth MAC address and does not perform pairing itself.
To run PowerSpyCli and start collecting power metrics, just run the software while providing the PowerSpy2 MAC address with the -m argument:
python powerspycli.py -m 00:11:22:33:44:55
To run PowerSpyCli GUI version, just run the software with the -g argument:
python powerspycli.py -g
The GUI version uses ttkbootstrap for theming, and hence this modules needs to be installed first. For instance with pip: pip install ttkbootstrap.
The -m argument is followed by the PowerSpy2 MAC address.
PowerSpyCli, by default, will display the power consumption of the PowerSpy2 every second.
To show all the collected metrics (i.e., voltage, ampere, etc.), run it with the -a argument.
The -v argument will display all the logs and connection info (verbose mode).
To save the power data along with the timestamp to a CSV file, use the -f argument:
python powerspycli.py -m 00:11:22:33:44:55 -f file.csv.
If you don't specify a filename, a default file will be created named powerspy-$timestamp.csv (with $timestamp being the current timestamp date).
The -g argument will run the GUI interface instead of the command line one.
- PyObjC is missing: run
python3 -m pip install pyobjc-framework-IOBluetoothusing the same Python interpreter that launches PowerSpyCli. - The device is not paired: pair the PowerSpy 2 in System Settings > Bluetooth, then retry.
- Bluetooth access is denied: enable Terminal or Python in System Settings > Privacy & Security > Bluetooth.
- Bluetooth is off or the RFCOMM channel cannot be opened: turn Bluetooth on, make sure the PowerSpy is powered and nearby, disconnect other applications using it, and retry. PowerSpyCli discovers the device's SPP channel and falls back to the PowerSpy default channel 1.
- A connection cannot be reopened after an interrupted run: wait for PowerSpyCli's clean shutdown to finish, then retry. If another program owns the serial connection, close that program first.
Verbose mode (-v) includes SDP, RFCOMM channel, retry, and protocol diagnostics that are useful when reporting a connection problem.
PowerSpyCli is forked from: powerspy.py with support for Python 3, replacing pyBluez with Python sockets, and many additional new features and updates.
It is licensed under the GNU Lesser General Public License v3.0 or later (LGPL-3.0-or-later).
Copyright (c) 2021-2026, Adel Noureddine. All rights reserved. This program and the accompanying materials are made available under the terms of the GNU Lesser General Public License v3.0 or later (LGPL-3.0-or-later) which accompanies this distribution, and is available at: https://www.gnu.org/licenses/lgpl-3.0.en.html