amdfriend

AMDFriend

Note: All of this is experimental software and it should only be referred to for the purpose of testing.

Introduction

This project stems directly from the excellent guide made by tomnic over at the MacOS86 forums.

Since userland patching is not possible with Lilu on Big Sur+, manual patching of libraries of certain programs is needed to get them to work reliably on AMD hackintoshes.

Tomnic did outline some general bit patterns to search for, but then he admitted that a crude find and replace wouldn't be viable. This project uses regular expressions to find those patterns and patch them.

Usage

Only use this if you know what you're doing. Also, this is incomplete software.

From the Releases section

Just grab the latest binary from the Releases section, mark it as executable, clear XAttrs as I cannot sign it, and use it. You can put it in your PATH (usually /usr/local/bin) if you want, for easy access.

As a Node module installed globally on the system

You will need:

• Node.js: brew install nodejs
• Yarn (optional, used for contributions): brew install yarn

Install (and update) AMDFriend on your system with this command:

npm install -g amdfriend

Or, if you've installed yarn

yarn global add amdfriend

Use it with:

amdfriend "/path/to/your/library.dylib"

Observed quirks

• Discord's Krisp module will only work if SIP is disabled. Reason is that the system usually won't load libraries that are not signed with the same key as the main application.

Command line arguments

Argument	Type	Default value	Description
--in-place	Boolean	false	Directly patch the library, as opposed to creating a patched library with .patched appended to the file name.
--backup	Boolean	false	Only works in conjunction with --in-place; it backs up the original library by copying it and appending .bak on its extension.
--sign	Boolean	false	Automatically invoke codesign on patched libraries.
--clear-xa	Boolean	true	Automatically invoke xattr -c on patched libraries.
--dry-run	Boolean	false	Do all checking and patching, but DO NOT write anything to disk. This is useful to test performance and to scan for matches in a given library.
--directories	Array	Not set	Scan directories alongside files. It will search for any file with no extension and with extension .dylib, as they are the common ones to patch.
--jobs	Number	N. of threads available	The number of jobs that will be spawned to process the libraries.

Contributing

If you want to contribute to this project, clone it to your computer!

git clone https://github.com/NyaomiDEV/AMDFriend
cd AMDFriend
yarn
yarn test "/path/to/your/library.dylib"

Tips and tricks

Scan for patchable files in a directory:

amdfriend --dry-run --directories /path/to/dir /path/to/another/dir | grep "Routines found"

Scan for patchable files and patch them (NOT recommended, might use sudo in front of the command if patching directories not owned by the current user):

amdfriend --in-place --backup --sign --directories /path/to/dir /path/to/another/dir

License

Refer to the LICENSE file.

Credits

Tomnic, Tomnic and Tomnic again. You don't know him? He's this guy.