Skip to content

Commit 4e120cc

Browse files
committed
Updated README
Improved documentation and instructions
1 parent 318cc44 commit 4e120cc

File tree

1 file changed

+28
-7
lines changed

1 file changed

+28
-7
lines changed

README.md

Lines changed: 28 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,8 @@
22

33
**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.
44

5+
Get it [here](https://softorage.github.io/undervolt-go/).
6+
57
_**Note:**_
68
- *Please use this software with extreme caution. It has the potential to damage your computer if used incorrectly.*
79

@@ -91,15 +93,21 @@ To install **undervolt-go** on your system, follow these steps:
9193
sudo undervolt-go --p1=40,32
9294
```
9395

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.
96+
3. This command applies a 60W power limit to PL2 and a 10s time window. PL2 is the short term power limit, that can be safe for shorter periods and is useful for short bursts of performance.
9597

9698
```bash
97-
sudo undervolt-go --p2=60,32
99+
sudo undervolt-go --p2=60,10
98100
```
99101

100-
4. All commands can be found in the help menu:
101-
102+
4. You can use multiple flags in a single command.
103+
102104
```bash
105+
sudo undervolt-go --core=-70 --cache=-50 --p1=40,32 --p2=60,10 --turbo=0 --temp=78 --temp-bat=66
106+
```
107+
108+
5. All commands can be found in the help menu:
109+
110+
```
103111
Usage:
104112
undervolt-go [flags]
105113
@@ -109,7 +117,7 @@ To install **undervolt-go** on your system, follow these steps:
109117
--core float core offset (mV) (default NaN)
110118
--force allow setting positive offsets
111119
--gpu float gpu offset (mV) (default NaN)
112-
-h, --help help for undervolt-go
120+
-h, --help help for undervolt-go
113121
--lock-power-limit lock the power limit
114122
--p1 strings P1 Power Limit (W) and Time Window (s), e.g., --p1=35,10
115123
--p2 strings P2 Power Limit (W) and Time Window (s), e.g., --p2=45,5
@@ -119,7 +127,7 @@ To install **undervolt-go** on your system, follow these steps:
119127
--turbo int set Intel Turbo (1 disabled, 0 enabled) (default -1)
120128
--uncore float uncore offset (mV) (default NaN)
121129
--verbose print debug info
122-
-v, --version version for undervolt-go
130+
-v, --version version for undervolt-go
123131
```
124132

125133
## Features
@@ -143,7 +151,15 @@ To install **undervolt-go** on your system, follow these steps:
143151
144152
## Configuration
145153
146-
**undervolt-go** does not use a configuration file. All settings are applied via command-line arguments. To maintain settings across reboots, consider creating a startup script that runs your preferred `undervolt-go` command.
154+
**undervolt-go** does not use a configuration file. All settings are applied via command-line arguments. To maintain settings across reboots, you can either consider creating a startup script that runs your preferred `undervolt-go` command, or add the preferred `undervolt-go` command in `.profile` file. You may need to edit the `sudoers` file to allow running `undervolt-go` as sudo without requiring password.
155+
156+
To edit `sudoers` file,
157+
1. Type in terminal `sudo visudo`.
158+
2. Add the below line at last of the sudoers file to allow running `undervolt-go` as sudo without requiring password
159+
`username ALL=(ALL) NOPASSWD: /usr/local/bin/undervolt-go`
160+
3. `Ctrl`+`X` to exit, `y` and `enter` to save.
161+
4. Make sure that you are absolutely sure that the computer won't crash with the commands that you are putting in `.profile`. Otherwise, your computer will always crash upon login. In such a case, you may try to shift to tty4 (`Ctrl`+`Alt`+`F4`) before login (or any other tty), and remove the commands causing issues from `.profile` file. This would usually work if X Server is causing issues.
162+
147163

148164
## Examples
149165

@@ -219,6 +235,11 @@ undervolt-go supports a range of Intel CPUs, particularly those from the Haswell
219235
220236
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.
221237

238+
## Credits
239+
240+
* [undervolt](https://github.com/georgewhewell/undervolt) for Intel CPUs on Linux
241+
* [Softorage](https://softorage.com)
242+
222243
## License
223244

224245
This project is licensed under the GNU General Public License v3.0. See the [LICENSE.txt](LICENSE.txt) file for details.

0 commit comments

Comments
 (0)