Skip to main content

A wrapper to use PowerTOP easily in Python.

Also provides a command to get the results as JSON.

Install

  • install PowerTOP (e.g. sudo aptitude install powertop on Debian-based distributions)

  • sudo python3 -m pip install powertop

Short example

Run as root, in a Python 3 shell:

import powertop
import json

measures = powertop.Powertop().get_measures(time=1)

print(json.dumps(measures['Device Power Report'], indent=4))

Or, as a shell command:

sudo python3 -m powertop

Outputs:

[
    {
        "Usage": "66.4%",
        "Device Name": "CPU core"
    },
    {
        "Usage": "66.4%",
        "Device Name": "DRAM"
    },
    {
        "Usage": "66.4%",
        "Device Name": "CPU misc"
    },
    {
        "Usage": "18.8 ops/s",
        "Device Name": "GPU misc"
    },
    {
        "Usage": "18.8 ops/s",
        "Device Name": "GPU core"
    },
 ...

How to use

First, call PowerTOP:

import powertop

measures = powertop.Powertop().get_measures(time=1, iterations=1)

Sections

You can then access sections. They may vary across systems and PowerTOP versions.

On my computer, they are:

  • Top 10 Power Consumers

  • Processor Idle State Report

  • Processor Frequency Report

  • Overview of Software Power Consumers

  • Device Power Report

  • Process Device Activity

  • Software Settings in Need of Tuning

  • Untunable Software Issues

  • Optimal Tuned Software Settings

You can find yours with this command:

sudo python3 -c "import powertop; measures = powertop.Powertop().get_measures(time=1); print(measures.keys())"

Reading sections

Each section is a list JSON-like data (strings, lists and dicts).

Run sudo python3 -m powertop to get a taste of what it looks like.

Metadata

Release files for powertop 0.2.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for powertop 0.2.2
File Size Uploaded
powertop-0.2.2.tar.gz 3.2 kB Details

Release files / powertop-0.2.2.tar.gz

Download URL powertop-0.2.2.tar.gz
Size 3.2 kB
Tags Source
SHA-256 checksum
How to use checksums
40ecca06976d114fdb1ea9316a3c3fe14262e09a7a706fd7fe63175d3680117d
BLAKE2b-256 checksum
How to use checksums
883e6df31a184daf7cca429f2563fe6903ea2fbeafb363aef3d5a25a32a6bd91
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No

Release history Release notifications | RSS feed

This release

0.2.2 This release

1 release file

0.2.1

1 release file

0.2

1 release file

0.1.1

1 release file

0.1

1 release file

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page