{"id":28469083,"url":"https://github.com/razman786/i8kgui","last_synced_at":"2025-07-01T14:31:11.834Z","repository":{"id":38008274,"uuid":"457398705","full_name":"razman786/i8kgui","owner":"razman786","description":"A Dell thermal management GUI to control fan speeds and monitor temperatures","archived":false,"fork":false,"pushed_at":"2023-08-08T21:28:29.000Z","size":461,"stargazers_count":18,"open_issues_count":1,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-06-07T08:09:11.285Z","etag":null,"topics":["dell","fan","fan-control","fan-speed","hwmon","i8k","linux","monitoring-application","pyside6","python","smbios","systray-application","ubuntu","xps"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/razman786.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2022-02-09T14:43:48.000Z","updated_at":"2025-05-16T18:52:07.000Z","dependencies_parsed_at":"2023-01-21T18:46:58.626Z","dependency_job_id":null,"html_url":"https://github.com/razman786/i8kgui","commit_stats":null,"previous_names":[],"tags_count":14,"template":false,"template_full_name":null,"purl":"pkg:github/razman786/i8kgui","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razman786%2Fi8kgui","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razman786%2Fi8kgui/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razman786%2Fi8kgui/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razman786%2Fi8kgui/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/razman786","download_url":"https://codeload.github.com/razman786/i8kgui/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/razman786%2Fi8kgui/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":262980942,"owners_count":23394436,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dell","fan","fan-control","fan-speed","hwmon","i8k","linux","monitoring-application","pyside6","python","smbios","systray-application","ubuntu","xps"],"created_at":"2025-06-07T08:09:15.991Z","updated_at":"2025-07-01T14:31:11.816Z","avatar_url":"https://github.com/razman786.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# I8KGUI\n\n![GitHub Workflow Status](https://img.shields.io/github/actions/workflow/status/razman786/i8kgui/installation.yml?branch=master)  ![GitHub release (latest by date)](https://img.shields.io/github/v/release/razman786/i8kgui)\n\n## Introduction\n\nA Dell thermal management GUI to control fan speeds and monitor temperatures.\nInformation is taken from\n[dell-smm-hwmon](https://www.kernel.org/doc/html/latest/hwmon/dell-smm-hwmon.html),\n[i8kutils](https://github.com/vitorafsr/i8kutils), Sysfs and\n[(SM)BIOS](https://github.com/dell/libsmbios) - created as a quick hack for my\nown needs (screenshots may be of an older version).\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/7116312/230130936-98105ddc-edcb-4499-b1a0-7c0b9337c1f4.png\" alt=\"i8k\" width=\"150\" /\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/7116312/230131129-eb4dbe21-31f9-45b0-8e72-9fa2e2d2ba03.png\" alt=\"bios\"width=\"150\" /\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/7116312/230131272-964d33ef-0058-4e74-ba82-f09b60d41fdb.png\" alt=\"cores\"width=\"150\" /\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/7116312/230131580-7ae857d1-8754-45c9-92d4-e070c9e6c9f0.png\" alt=\"turbo\"width=\"150\" /\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/7116312/154058677-ee7d8858-6cfa-48a8-8dff-f813439bec64.png\" alt=\"settings\" width=\"250\" /\u003e\n  \u003cimg src=\"https://user-images.githubusercontent.com/7116312/202192004-1bc59976-edd5-4d81-a46c-b9450d677ca8.png\" alt=\"info\" width=\"250\" /\u003e\n\u003c/p\u003e\n\ni8kgui uses `dell-smm-hwmon`, `i8kutils` and Sysfs to gather information such as\nCPU temperature and fan speeds. It also supports thermal management using\n(SM)BIOS modes.\n\n### Features\n\n* Displays CPU temperature, fan speed(s) and fan mode(s)\n* Displays the current CPU frequency\n* Displays CPU load\n* Displays individual CPU core frequencies and temperatures\n* Displays CPU Turbo information\n* Gathers metrics from the `dell_smm_hwmon` kernel module via Sysfs, instead of\n  using `/proc/i8k`\n* Shows the currently active i8kutils configuration being used\n* Supports (SM)BIOS thermal management modes via libsmbios\n* Loads [cpupower-gui](https://github.com/vagnum08/cpupower-gui) (if installed)\n  when `CPU Governor` is clicked\n* Option to display CPU frequency as either the highest (default) or the average\n  value for all CPU cores\n* Adds polkit action configurations to allow users to change fan modes without a\n  password\n\n## Installation\n\n### Automated Installation (Recommended)\n\nThis version has only been tested on Ubuntu 20.04/23.04 (it should also work on 22.04)\nand with a Dell laptop (XPS 7590). The installation script undertakes a\nsystem-wide installation with all optional components (i.e. `cpupower-gui` and\n`undervolt`). i8kgui itself is installed within a users `$HOME` directory. Please see below for other install options.\n\n```\ngit clone https://github.com/razman786/i8kgui\ncd i8kgui\n./install_i8kgui_ubuntu.sh\n```\n\n#### Automated Installation Options\n\nInstall option | i8kutils | Dell BIOS fan control | libsmbios | cpupower-gui | undervolt\n:---:|:---:|:---:|:---:|:---:|:---:|\n`-all` | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | \n`-norm` | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | |\n`-min` | :heavy_check_mark: |\n`-fix` | :heavy_check_mark: | :heavy_check_mark: |\n`-smbios` | :heavy_check_mark: | | :heavy_check_mark: |\n`-power` | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | :heavy_check_mark: | \n\nSee `./install_i8kgui_ubuntu.sh -h` for usage information.\n\n### Manual Installation\n\n#### Prerequisites\n\nThis guide has only been tested on Ubuntu 20.04/23.04 and with a Dell XPS laptop.\n\nThe [dell-smm-hwmon](https://www.kernel.org/doc/html/latest/hwmon/dell-smm-hwmon.html)\nkernel module is required for basic functionality.\n\n##### i8kutils\n\nPlease install and configure i8kutils from\nhttps://github.com/vitorafsr/i8kutils. On Ubuntu the following can be run:\n\n```\nsudo apt install i8kutils\n```\n\n##### Dell BIOS Fan Control (optional)\n\nSome systems require this step, while others do not. For example, a Dell XPS\n7590 needs the BIOS fan control installed, but a Dell Inspiron 5575 does not.\n\nPlease install Dell BIOS Fan Control from\nhttps://github.com/TomFreudenberg/dell-bios-fan-control and install it into\n`/usr/bin/`.\n\nIf you are not sure that you have GCC installed, please run this first `sudo apt\ninstall build-essentials`, then:\n\n```\ngit clone https://github.com/TomFreudenberg/dell-bios-fan-control.git\ncd dell-bios-fan-control\nmake\nsudo cp dell-bios-fan-control /usr/bin\n```\n\nPlease install this service file\nfrom https://github.com/gilbsgilbs/dell-bios-fan-control-git/blob/master/dell-bios-fan-control.service\ninto `/etc/systemd/system/`\n\n```\ncurl -O https://raw.githubusercontent.com/gilbsgilbs/dell-bios-fan-control-git/master/dell-bios-fan-control.service\nsudo cp dell-bios-fan-control.service /etc/systemd/system/\nsudo systemctl enable dell-bios-fan-control.service\n```\n\n##### libsmbios (optional)\n\nIf supported by your system, libsmbios will allow BIOS thermal modes to be changed, amongst other\nfeatures. On Ubuntu, please install the following package to interface with (SM)BIOS\ninformation:\n\n```\nsudo apt install python3-libsmbios\n```\n\n##### cpupower-gui (optional)\n\nOn Ubuntu, install the following optional package to change the CPU\nGovernor:\n\n```\nsudo apt install cpupower-gui\n```\n\n##### polkit actions (optional)\n\nThe polkit action files will allow thermal controls to be changed without\nrequiring a user password. If your installation of `i8kgui` is frequently asking\nfor a password, please do the following:\n\nUsing a text editor, change the `I8KGUI_THERMAL_PATH` placeholder in the \n`i8kgui/polkit_actions/ubuntu/com.ubuntu.pkexec.i8kgui_thermal_control.policy` file to the correct location, i.e. `/home/someuser`\n\nTo manually install the polkit action files, do the following:\n```\nsudo cp i8kgui/polkit_actions/ubuntu/* /usr/share/polkit-1/actions\n```\n\nPlease note that, the installation script by default will use the polkit action files for\nUbuntu. Polkit action files for Manjaro Linux (tested with version 22.1.3) are\nlocated in `i8kgui/polkit_actions/manjaro`. \n\n#### i8kgui Installation\n\n###### Using PyPI\n\nOn Ubuntu 20.04 and 22.04 use the following:\n```\npip3 install i8kgui --user\n```\n\nFor Ubuntu 23.04 the command needs to be altered:\n```\npip3 install i8kgui --user --break-system-packages\n```\n\n###### Using Git\n\n```\ngit clone https://github.com/razman786/i8kgui\n```\nOn Ubuntu 20.04 and 22.04 use the following:\n```\npip3 install . --user\n```\n\nFor Ubuntu 23.04 the command is as follows:\n```\npip3 install . --user --break-system-packages\n```\n\n##### Development version\n\n```\ngit clone https://github.com/razman786/i8kgui\ngit checkout development \u0026\u0026 git pull\npip3 install . --user\n```\n\n#### Uninstall i8kgui\n\nFor Ubuntu 20.04 and 22.04 use the following:\n```\npip3 uninstall i8kgui\n```\n\nFor Ubuntu 23.04 use the following:\n```\npip3 uninstall i8kgui --break-system-packages\n```\n\n## Usage\n\nPlease ensure that you have configured i8kutils *before* starting!\n\nOnce i8kutils is correctly configured using the `/etc/i8kmon.conf` file, please\nrun the following to enable the services if they are not already running.\n\n```\nsudo systemctl enable dell-bios-fan-control.service; sudo systemctl enable i8kmon.service\n```\n\ni8kgui can be loaded by searching in Ubuntu's `Show Applications` icon in the\napplication dock. Optionally, i8kgui can be loaded from a terminal by executing\n`i8kgui`.\n\nBy default, i8kgui displays i8kutils information, however it does facilitate\nthermal management using the (SM)BIOS. If you enable this feature typically four\nfan modes will be available. Please note that, using 'Quiet', or 'Cool Bottom'\nmodes will reduce performance due to CPU power capping. Changing (SM)BIOS\nthermal modes may require entering a user password, if polkit actions have not\nbeen configured.\n\nDisabling (SM)BIOS thermal management in the settings will re-enable i8kutils's\nmanagement and configuration.\n\n## Personal configuration\n\nThe `i8kmon_sample_conf` directory contains my personal `i8kmon.conf`\nconfiguration file, used on a Dell XPS 7590 (Intel i7, BIOS version 1.14.1).\n\n[Undervolt](https://github.com/georgewhewell/undervolt) is installed using the\nfollowing settings to avoid thermal throttling:\n```\nundervolt -v --gpu -0 --core -121 --cache -121 --uncore -121 --analogio 0 --temp 100\n```\n\n## Known Working Systems\n\nSystems that have been reported to be working:\n\n* Dell XPS 7590, Intel i7\n* Dell Inspiron 5575, AMD Ryzen 5 - thank you [@yochananmarqos](https://github.com/yochananmarqos)\n\n## Disclaimer\n\nPlease note the author takes *no responsibility for any damage* that occurs from\nusing this software and/or configurations.\n\n## Issues and requests\n\nPlease open an issue [here](https://github.com/razman786/i8kgui/issues).\n\n## Credits\n\n[Delapouite](https://delapouite.com/) for the Computer Fan\nIcon ([CC BY 3.0](http://creativecommons.org/licenses/by/3.0/))\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frazman786%2Fi8kgui","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frazman786%2Fi8kgui","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frazman786%2Fi8kgui/lists"}