{"id":13579439,"url":"https://github.com/trulyspinach/SMCAMDProcessor","last_synced_at":"2025-04-05T20:34:22.658Z","repository":{"id":43800242,"uuid":"242130561","full_name":"trulyspinach/SMCAMDProcessor","owner":"trulyspinach","description":"Power management, monitoring and VirtualSMC plugin for AMD processors","archived":false,"fork":false,"pushed_at":"2024-09-16T10:31:40.000Z","size":11316,"stargazers_count":1077,"open_issues_count":42,"forks_count":96,"subscribers_count":34,"default_branch":"master","last_synced_at":"2025-03-30T09:04:57.955Z","etag":null,"topics":["amd","amd-processor","hackintosh","systemmonitor","temperature","virtualsmc"],"latest_commit_sha":null,"homepage":"","language":"C++","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/trulyspinach.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"ko_fi":"trulyspinach"}},"created_at":"2020-02-21T12:08:12.000Z","updated_at":"2025-03-30T04:11:26.000Z","dependencies_parsed_at":"2022-08-12T10:50:20.647Z","dependency_job_id":"efe33f88-a1c3-4024-87ca-fdf69b9f0cd7","html_url":"https://github.com/trulyspinach/SMCAMDProcessor","commit_stats":null,"previous_names":[],"tags_count":20,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trulyspinach%2FSMCAMDProcessor","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trulyspinach%2FSMCAMDProcessor/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trulyspinach%2FSMCAMDProcessor/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/trulyspinach%2FSMCAMDProcessor/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/trulyspinach","download_url":"https://codeload.github.com/trulyspinach/SMCAMDProcessor/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247399889,"owners_count":20932876,"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":["amd","amd-processor","hackintosh","systemmonitor","temperature","virtualsmc"],"created_at":"2024-08-01T15:01:39.409Z","updated_at":"2025-04-05T20:34:17.646Z","avatar_url":"https://github.com/trulyspinach.png","language":"C++","readme":"SMCAMDProcessor\n========\n[![Github release](https://img.shields.io/github/downloads/trulyspinach/SMCAMDProcessor/total.svg?color=pink)](https://github.com/trulyspinach/SMCAMDProcessor/releases)\n![Github release](https://img.shields.io/github/repo-size/trulyspinach/SMCAMDProcessor.svg?color=blue)\n[![Continuous Delivery](https://github.com/trulyspinach/SMCAMDProcessor/actions/workflows/main.yml/badge.svg)](https://github.com/trulyspinach/SMCAMDProcessor/actions/workflows/main.yml)\n\nXNU kernel extension for power management and monitoring of AMD processors.\nAlso comes with a plugin for [VirtualSMC](https://github.com/acidanthera/VirtualSMC) to export readings to other applications.\n\n~~Please note that this release is at very initial stage of development, make sure you have a proper backup of your EFI folder and never run on any system that matters.~~\nThis notice has been here since the very beginning of this repository. Although I still wouldn't consider it completely finished, many users, including me, have been running these kexts daily without any major issues. If it's your first time adding these kexts to your system, please ensure you have a backup of your EFI.\n\nNow you can also access the latest(and probably unstable) builds from [Github Action](https://github.com/trulyspinach/SMCAMDProcessor/actions).\n\n## Installation\n\nSMCAMDProcessor now comes in two separate binaries(kernel extensions):\n* `AMDRyzenCPUPowerManagement.kext` for all power management features. This kext is also required if you would like to use **AMD Power Gadget**.\n* `SMCAMDProcessor.kext` to publish readings to [VirtualSMC](https://github.com/acidanthera/VirtualSMC), which enables macOS applications like iStat to display sensor data. This kext depends on `AMDRyzenCPUPowerManagement.kext` to collect sensor data, thus must be loaded after.\n\n1. Download the kext(s) and application from [Release](https://github.com/trulyspinach/SMCAMDProcessor/releases) page.\n   * Optionally, you can instead download the latest(probably unstable) build from [Github Action](https://github.com/trulyspinach/SMCAMDProcessor/actions).\n3. Add `AMDRyzenCPUPowerManagement.kext` to kext folder of your bootloader.\n4. Edit your bootloader's config file to make sure the kext is enabled.\n5. If you're using [VirtualSMC](https://github.com/acidanthera/VirtualSMC) you can also load `SMCAMDProcessor.kext` to publish sensor data.\n6. Bootloaders like `OpenCore` will link each kext in the order they present in config file, so make sure `AMDRyzenCPUPowerManagement.kext` comes before `SMCAMDProcessor.kext` as it serves as a dependency.\n\n## Features\n* CPU power management for AMD Zen processors. \n* Supports for reading of temperature, energy and frequency data on AMD Zen Processors.\n* Manual switching of processor speed.\n* PState editing.\n\n\u003cimg src=\"imgs/ani.gif\" width=\"100%\"\u003e\n\n## AMD Power Gadget\n\u003cimg src=\"imgs/all.png\" width=\"80%\"\u003e\n\n## Editing PState\n\nSince the release 0.3.1, you can now edit your CPU PState using AMD Power Tool.\n\u003cimg src=\"imgs/pe.png\" width=\"60%\"\u003e\n\nTo access PState editor:\n1. Open AMD Power Tool\n2. Go to 'Speed' tab\n3. Click 'Advanced Options'\n\n## Fan Control\n\nDue to the amount of request an experimental feature for reading and overriding fan speed is out!\n\u003cimg src=\"imgs/fans.png\" width=\"60%\"\u003e\n\nYou can access this menu from menu bar \"Open -\u003e SMC Fans\" or the button in Power Tool.\nCurrently only a limited amount of SMC controllers are supported.\n\n\n#### Safety Notes\n* Incorrect PState setting can potentially cause permanent damage to your computer hardware.\n* For safety concern, this function was limited to root user only. You can either launch AMD Power Gadget with root user or use `-amdpnopchk` to disable this check.\n\n\n\u003cimg src=\"imgs/iStats.png\" width=\"40%\"\u003e\n\n\n## Contribution\n#### If you like this project, please consider supporting it via:\n\n* Give it a star!\n* [Buy](https://ko-fi.com/trulyspinach) me a coffee.\n\n* Open an issue(English only) if you encountered any problem or have suggestions.\n* or if you're a coding person, feel free to submit a pull request. DM me on Discord if you have any code related questions.\n\n## Credits\n* [aluveitie](https://github.com/aluveitie) for various enhancements and fixes.\n* [mauricelos](https://github.com/mauricelos) for IT86XXE SMC chip driver.\n* [necross2](https://github.com/necross2) for adding support to temperature sensor offset.\n* [Shaneee](https://github.com/Shaneee) for the beautiful icon.\n* [mbarbierato](https://github.com/mbarbierato), [Lorys89](https://github.com/Lorys89) for NCT6799D SMC chip driver.\n* All contributors for various fixes and improvements.\n\n\n## Notes\n* I am still fairly new to macOS kernel development, this software project was initally a hobby project, **and it still is**, to get some reading on my newly built AMD hackintosh computer.\n\n* With that being said, please bear with some of the spaghetti and not-idiomatic codes. Any criticism is much welcomed :)\n\n[![stats](https://github-readme-stats.vercel.app/api?username=trulyspinach\u0026theme=radical)](https://github.com/anuraghazra/github-readme-stats)\n","funding_links":["https://ko-fi.com/trulyspinach"],"categories":["\u003ca name=\"cpp\"\u003e\u003c/a\u003eC++"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrulyspinach%2FSMCAMDProcessor","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftrulyspinach%2FSMCAMDProcessor","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftrulyspinach%2FSMCAMDProcessor/lists"}