Troubleshooting

[All OS] System monitor does not start: smart screen stay blank

Try to get error logs from the program:

• if you run the program from a command-line, errors from the Python interpreter will be printed in the same window
• if you run the program automatically at boot (e.g. from the Task Scheduler) you can find logs in the log.log file from the project main folder

When you have located your error from the logs, search it on this page or in the existing issues

[Linux] Cannot open serial port: permission error

• Symptoms: When running the program the following error appears:
  [Errno 13] Permission denied: '/dev/ttyACM0'
• Cause: your user does not have permanent access to TTY devices created by your system
• Fix: adding your user to the group dialout, on Ubuntu & Debian the command is sudo usermod -a -G dialout $USER
  On ArchLinux the group is uucp, the command is sudo usermod -a -G uucp $USER

[Windows] Cannot load LibreHardwareMonitor.dll: loadFromRemoteSources

• Symptoms: When running program on Windows, the following error appears at launch:

System.NotSupportedException: An attempt was made to load an assembly from a network location 
which would have caused the assembly to be sandboxed in previous versions of the .NET Framework.
This release of the .NET Framework does not enable CAS policy by default, so this load may be
dangerous. If this load is not intended to sandbox the assembly, please enable the
loadFromRemoteSources switch.

• Cause: Since .Net Framework 4.0, the ability to run code in assemblies loaded from a remote source is disabled by default. See https://learn.microsoft.com/en-us/dotnet/framework/configure-apps/file-schema/runtime/loadfromremotesources-element#remarks
• Fix: go to the external/LibreHardwareMonitor folder of this project, then for each of the two .dll files do a right-click > Properties > click (or check) Unblock
  If you do not have the Unblock option you can also do it using Powershell: open a Powershell command-line into the external/LibreHardwareMonitor folder and run:

dir *.dll | Unblock-File

If this does not solve the issue, find the path of your python.exe / pythonw.exe program using the command where python.exe / where pythonw.exe and create in the same folder python.exe.config and pythonw.exe.config text files with both the following content:

<configuration>  
   <runtime>  
      <loadFromRemoteSources enabled="true"/>  
   </runtime>  
</configuration>  

[Windows] Running python.exe opens the Microsoft Store

• Symptoms: Running python.exe from a command line opens the Microsoft Store instead of actually running a Python shell.
• Cause: Python has been installed from official website, not from Microsoft Store
• Fix: Use py.exe instead, or disable python.exe & python3.exe App Execution Aliases : Windows 10 or Windows 11

[Linux / MacOS] "No supported GPU found" with an AMD GPU and Python > 3.11

• Symptoms: System monitor displays "No supported GPU found" with an AMD GPU, and no GPU stats are displayed on the screen
• Cause: For Python > 3.11, the pyamdgpuinfo library isn't available as pre-built Wheel package in Pip repositories.
• Fix: Install some packages manually from your OS package manager: you need python3-dev/python3-devel and libdrm-dev/libdrm-devel, then install pyamdgpuinfo manually with Pip:

python3 -m pip install pyamdgpuinfo

[All OS] Tkinter dependency not installed

• Symptoms: Error message [ERROR] Tkinter dependency not installed. displayed when running configure.py or Theme Editor
• Cause: Python Tkinter module is not installed on your system. The Tkinter module is used to display graphical elements like windows, buttons...
• Fix: Because Tkinter has OS-specific code, it cannot be installed from Pip. It must be installed from your OS:
  • For Windows: During Python3 installation you must have tcl/tk option checked:
    
  • For macOS: if you installed Python from Homebrew: brew install python-tk
  • For Linux Debian: sudo apt install python3-tk
  • For Linux Fedora: sudo dnf install python3-tkinter
  • For Arch Linux / Manjaro: install tk package with pacman
  • For other OS: search the web for install python3 tkinter for (your OS)