You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
* Updated README to improve some instructions and add FAQs
* Updated GitHub Actions yml file to store the compiled binary in a 'latest-build' compressed archive
Copy file name to clipboardExpand all lines: README.md
+69-30Lines changed: 69 additions & 30 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -3,8 +3,7 @@
3
3
**undervolt-go** is a Go port of the original [undervolt](https://github.com/georgewhewell/undervolt) utility, designed to allow users to undervolt Intel CPUs on Linux systems. Undervolting can help reduce CPU temperatures, decrease power consumption, and potentially increase system stability and longevity. **undervolt-go** gives the advantage of running the application without the need for any dependencies.
4
4
5
5
_**Note:**_
6
-
-*Please use this software with caution. It can damage you computer.*
7
-
-*We may use AI when developing this project.*
6
+
-*Please use this software with extreme caution. It has the potential to damage your computer if used incorrectly.*
8
7
9
8
## Table of Contents
10
9
@@ -17,6 +16,7 @@ _**Note:**_
17
16
-[Configuration](#configuration)
18
17
-[Examples](#examples)
19
18
-[Troubleshooting](#troubleshooting)
19
+
-[FAQ](#faq)
20
20
-[Contributors](#contributors)
21
21
-[License](#license)
22
22
@@ -63,9 +63,9 @@ To build **undervolt-go**, follow these steps:
63
63
To install **undervolt-go** on your system, follow these steps:
64
64
1. Download latest release from [offical nightly builds](https://softorage.github.io/undervolt-go/)
65
65
2. Extract the archive. You should now have the following files:
66
-
1. undervolt-go
67
-
2. install-undervolt.sh
68
-
3. update-undervolt.sh
66
+
1. undervolt-go
67
+
2. install-undervolt.sh
68
+
3. update-undervolt.sh
69
69
3. Simply make install-undervolt.sh executable (or update-undervolt.sh if you already have it):
70
70
-`chmod +x install-undervolt.sh`
71
71
- or you can right click install-undervolt.sh, go to Properties, and in the Permissions tab, tick 'Make executable'
@@ -80,45 +80,46 @@ To install **undervolt-go** on your system, follow these steps:
80
80
1. To apply a voltage offset, use the following syntax:
This command applies a -100 mV offset to the CPU core, -50 mV to the CPU cache, and a -50 mV offset to the GPU.
87
87
88
88
2. This command applies a 40W power limit to PL1 and a 32s time window. PL1 is the long term power limit, that can be safe for longer periods.
89
89
90
90
```bash
91
-
sudo ./undervolt-go --p1=40,32
91
+
sudo undervolt-go --p1=40,32
92
92
```
93
93
94
94
3. This command applies a 60W power limit to PL2 and a 32s time window. PL2 is the short term power limit, that can be safe for shorter periods and is useful for short bursts of performance.
--p1 strings P1 Power Limit (W) and Time Window (s), e.g., --p1=35,10
115
+
--p2 strings P2 Power Limit (W) and Time Window (s), e.g., --p2=45,5
116
+
--read read existing values
117
+
--temp int set temperature target on AC (°C) (default -1)
118
+
--temp-bat int set temperature target on battery (°C) (default -1)
119
+
--turbo int set Intel Turbo (1 disabled, 0 enabled) (default -1)
120
+
--uncore float uncore offset (mV) (default NaN)
121
+
--verbose print debug info
122
+
-v, --version version for undervolt-go
122
123
```
123
124
124
125
## Features
@@ -149,23 +150,23 @@ To install **undervolt-go** on your system, follow these steps:
149
150
- **Read Current Voltage Offsets:**
150
151
151
152
```bash
152
-
sudo ./undervolt-go --read
153
+
sudo undervolt-go --read
153
154
```
154
155
155
156
This command displays the current voltage offsets applied to the CPU components.
156
157
157
158
- **Set Temperature Target to 85°C:**
158
159
159
160
```bash
160
-
sudo ./undervolt-go --temp=85
161
+
sudo undervolt-go --temp=85
161
162
```
162
163
163
164
This sets the CPU throttling temperature target to 85 degrees Celsius.
164
165
165
166
- **Disable Intel Turbo Boost:**
166
167
167
168
```bash
168
-
sudo ./undervolt-go --turbo=1
169
+
sudo undervolt-go --turbo=1
169
170
```
170
171
171
172
This command disables Intel Turbo Boost, potentially reducing heat and power consumption.
@@ -176,6 +177,44 @@ To install **undervolt-go** on your system, follow these steps:
176
177
- **Settings Reset After Reboot:** Voltage offsets are not persistent across reboots by default. Create a startup script to apply your preferred settings automatically.
177
178
- **Permission Denied Errors:** Ensure you are running the commands with `sudo` to have the necessary privileges.
178
179
180
+
## FAQ
181
+
182
+
1. Is undervolting safe?
183
+
184
+
Undervolting can be safe if done correctly, but it carries inherent risks. Applying incorrect voltage settings can lead to system instability, crashes, or hardware damage. Start with small negative voltage offsets, and choose the offset just before the system starts crashing. You may have to manually cut the power when the system crashes due to undervolt.
185
+
186
+
2. Do I need to install any dependencies to use undervolt-go?
187
+
188
+
No, undervolt-go is built using Go and does not require any external dependencies. However, to interact with CPU settings, the application needs to run with elevated privileges.
189
+
190
+
3. How do I use undervolt-go to undervolt my CPU?
191
+
192
+
To use undervolt-go:
193
+
194
+
Mehtod 1: Without installation:
195
+
196
+
- Open Terminal: Launch your terminal application.
197
+
- Navigate to the Executable Location: Ensure you're in the directory containing the undervolt-go executable (`cd` into the directory where 'undervolt-go' is located) or provide the full path to it.
198
+
- Run the Executable: Execute the program with appropriate permissions:
199
+
`sudo ./undervolt-go`
200
+
201
+
Mehtod 2: With installation:
202
+
203
+
- Open Terminal: Launch your terminal application.
204
+
- Navigate to the undervolt-go directory: Change to the directory containing the undervolt-go executable, along with the install-undervolt.sh and update-undervolt.sh scripts. Make sure that all the files are in the same directory.
205
+
- Install undervolt-go: Run the install-undervolt.sh script:
206
+
`sudo ./install-undervolt.sh`
207
+
- Run undervolt-go: You can now use 'undervolt-go' from any directory.Run the undervolt-go executable with root privileges:
208
+
`sudo undervolt-go`
209
+
210
+
4. Do you use AI to develop this project?
211
+
212
+
We may use AI when developing this project. If you find any issues, please report them to us. We will try to fix them as soon as possible.
213
+
214
+
5. Which Intel CPUs are supported by undervolt-go?
215
+
216
+
undervolt-go supports a range of Intel CPUs, particularly those from the Haswell generation and newer. However, compatibility can vary based on your specific system configuration.
217
+
179
218
## Contributors
180
219
181
220
We welcome contributions from the community. If you'd like to contribute to **undervolt-go**, please fork the repository and submit a pull request with your changes.
0 commit comments