Skip to content

Commit

Permalink
feat: change to original readme
Browse files Browse the repository at this point in the history
  • Loading branch information
alvindimas05 committed Oct 7, 2024
1 parent 41be2dc commit e38c901
Show file tree
Hide file tree
Showing 5 changed files with 54 additions and 2 deletions.
2 changes: 1 addition & 1 deletion Cargo.toml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
[workspace]
members = ["amdhelper", "amdhelper-chromium", "amdhelper-tui"]
members = ["amdhelper", "amdhelper-chromium", "amdhelper-friend", "amdhelper-tui"]
resolver = "2"

[profile.release]
Expand Down
44 changes: 43 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1,3 +1,45 @@
# AMDHelper

Tool with workarounds for AMD systems running macOS.
AMDHelper is an experimental application designed to help patch unsupported apps on AMD Hackintoshes.
It specifically addresses issues with apps that rely on Dual Source Blend
(previously assumed to be an OpenGL issue) and Intel MKL libraries.
While AMDHelper can resolve some compatibility problems, it may not fix all unsupported apps.

### How this works?
- For apps utilizing Intel MKL libraries, AMDHelper employs [AMDFriend](https://github.com/NyaomiDEV/AMDFriend) to patch these libraries for better compatibility.

- For apps relying on Dual Source Blend, the current solution is to disable GPU features within the app.
Unfortunately, this is a temporary workaround, and we must wait for [NootedRed](https://github.com/ChefKissInc/NootedRed) to provide a more permanent fix.

### How to use?

Install (or update) AMDHelper on your system
```
curl -sL https://raw.githubusercontent.com/alvindimas05/AMDHelper/main/install.sh | bash
```

Run AMDHelper (Please run as sudo)
```
sudo amdhelper
```

### Building Manually

You want to change the code and build it manually? Here are the steps
1. Install Node.js 18.19.0 using [nvm](https://github.com/nvm-sh/nvm?tab=readme-ov-file#install--update-script)
(The version needs to be specific due to [nexe](https://github.com/nexe/nexe) Node.js version)
2. Install [bun](https://bun.sh/) runtime
3. Run ```bun run build```
4. Your build should be ready at ```build/amdhelper```

## Credits
- [VisualEhrmanntraut](https://github.com/VisualEhrmanntraut) for developing [NootedRed](https://github.com/ChefKissInc/NootedRed)
to support Hackintosh on AMD iGPU.
- [tomnic](https://macos86.it/profile/69-tomnic/) for [guide](https://macos86.it/topic/5489-tutorial-for-patching-binaries-for-amd-hackintosh-compatibility/)
to patch apps that uses Intel MKL libraries.
- [NyaomiDEV](https://github.com/NyaomiDEV) for developing [AMDFriend](https://github.com/NyaomiDEV/AMDFriend)
to automatically patch apps that uses Intel MKL libraries.
- [gmatht](https://github.com/gmatht) for script code [gz99](https://github.com/gmatht/joshell/blob/master/scripts/gz99)
script for better compression.
- [FlyGoat](https://github.com/FlyGoat) for developing [RyzenAdj](https://github.com/FlyGoat/RyzenAdj) to add power management feature.
- [ExtremeXT](https://github.com/ExtremeXT) for providing compiled MacOs version of [RyzenAdj](https://github.com/FlyGoat/RyzenAdj).
3 changes: 3 additions & 0 deletions amdhelper-friend/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
discord_krisp.node
discord_krisp_backup.node
discord_krisp_patched.node
7 changes: 7 additions & 0 deletions amdhelper-friend/Cargo.toml
Original file line number Diff line number Diff line change
@@ -0,0 +1,7 @@
[package]
name = "amdhelper-friend"
version = "0.1.0"
edition = "2021"

[dependencies]
regex = "1.11.0"
Empty file added amdhelper-friend/src/main.rs
Empty file.

0 comments on commit e38c901

Please sign in to comment.