Skip to content
This repository has been archived by the owner on Jul 21, 2020. It is now read-only.


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
November 2, 2018 20:01
November 7, 2018 13:08
November 13, 2018 14:58


This is a Python3 program which uses a simple GTK gui to view, monitor and in the future overclock a Radeon GPU on Linux. Main screen

What can it do?

  • View memory and GPU P-states including voltages.
  • Ability to monitor signals from GPU sensors by means of plotting
  • Write a bash file with overclock settings
  • Multi GPU support in top dropdown list

What can't it do?

  • Directly apply values from GUI (this will be a future addition)
  • Fan control (this will be a future addition)
  • Monitor multiple GPU's

Hardware Requirements

  • A Radeon card which uses the AMDGPU kernel driver

OS Requirements

  • Linux kernel 4.8+ (Ubuntu 16.10 or newer)
  • The overdrive kernel parameter must be set.
  • Python3 (3.6+)

Virtual Environment Requirements

Production Environment

sudo apt install --yes \

Development Environment

python3.7 -m venv venv
source venv/bin/activate
python -m pip install --upgrade \
    matplotlib \
    setuptools \

Usage/ installation

Clone the repository and open a terminal in this folder and install the required packages. For installation run

Production Installation

    sudo python3 install

Development Installation

    python -m pip install -e .

After installation, the wattmanGTK command is available from any terminal. Alternatively, the tool can also be launched from the command line by running


in a terminal where you cloned the repository. When you want to apply the settings given in the GUI click apply, and instructions will be given on how to apply the overclock. This is at your own risk!

Contributing & Donations

Contributions can be made in terms of:

  • Hardware debugging, please let me know if your configuration runs or not (mine is run with 4.19 and an RX480)
  • Feature additions, some TODO's are given in the files
  • Packaging of the software
  • Feedback on the code
  • Donations can be made on
  • Other contributions are also possible, please let me know


How do I know my card has the overdrive bit enabled

Just try to run WattmanGTK. It will tell you if your card does not support overdrive. Even if this is not the case you can set a kernel parameter to force overdrive to be enabled (may not work on all cards). For more information on how to set the parameter check the Arch Wiki

For GRUB based systems (like ubuntu): edit the /etc/default/grub file and edit the line:


And change it to:

    GRUB_CMDLINE_LINUX_DEFAULT="quiet splash amdgpu.ppfeaturemask=<the suggested value by WattmanGTK>"

Then grub needs to be updated, for ubuntu this is done by running

    sudo update-grub

For distro agnostic updating this can be done by running

on BIOS systems: # grub2-mkconfig -o /etc/grub2.cfg

on UEFI systems: # grub2-mkconfig -o /etc/grub2-efi.cfg

Then reboot the machine. Once rebooted you can check the current featuremask by

   printf "0x%08x\n" $(cat /sys/module/amdgpu/parameters/ppfeaturemask)

Setting the kernel parameter causes artifacts and glitching

It could be that setting the kernelparameter can enable features that should not be enabled which could be the cause.

The program does not work for me

Please open an issue here. Furthermore, refer to this thread on reddit for additional help: link

The program can not find a certain senor path and fails

Please refer to: #1


No releases published


No packages published