mirror of
https://github.com/sirjonasxx/G-Earth.git
synced 2024-11-30 12:00:51 +01:00
90 lines
4.5 KiB
Markdown
90 lines
4.5 KiB
Markdown
**NOTE: Currently supported browsers: ONLY Firefox and Chromium, works on Habbo AIR too**
|
||
|
||
# MacOS Installation Guide
|
||
|
||
G-Earth depends on an application named [G-Mem](https://github.com/sirjonasxx/G-Mem),
|
||
this application scans the memory contents of the Habbo client applicaton and extracts a cipher key
|
||
that is used to decrypt packets coming from the Habbo server.
|
||
|
||
There is a few steps u have to complete in order to get it to work on MacOS.
|
||
|
||
## Code-Sign G-Mem file and make it executable
|
||
|
||
### Certificate Creation
|
||
1. Open `Keychain Access` (press `⌘ + Enter`, type `KeyChain Access` to open it from spotlight)
|
||
2. Navigate from the top menu to `Keychain Access > Certificate Assistant > Create Certificate...`
|
||
|
||
3. In the `Create Your Certificate` do the following:
|
||
* Set `Name:` to `gmem-cert`
|
||
* Set `Cerificate Type:` to `Code Signing`
|
||
* Toggle the `Let me override default` button
|
||
|
||
|
||
|
||
5. Press `Continue` until you reach the `Specify a Location For The Certificate`, now do the following:
|
||
* Set `Keychain:` to `System`
|
||
|
||
|
||
|
||
6. Enter your login credentials when prompted and press `Done`
|
||
|
||
### Signing of G-Mem
|
||
1. Open `Terminal` (press `⌘ + Enter`, type `Terminal` to open it from spotlight)
|
||
2. Type `codesign -fs "gmem-cert" ` (do not press enter yet)
|
||
3. Drag the `G-Mem` file into your terminal window *(this will append the path to the terminal)*
|
||
|
||
Your terminal window should now resemble the following:
|
||
|
||
|
||
|
||
4. Now press enter and enter your login credentials when prompted.
|
||
|
||
### Making G-Mem executable
|
||
1. Open `Terminal` (press `⌘ + Enter`, type `Terminal` to open it from spotlight)
|
||
2. Type `chmod 755 ` (do not press enter yet)
|
||
3. Drag the `G-Mem` file into your terminal window *(this will append the path to the terminal)*
|
||
|
||
Your terminal window should now resemble the following:
|
||
|
||
|
||
|
||
4. Now press enter and verify the `Kind` of the `G-Mem` file is now `Unix Executable File`
|
||
|
||
|
||
|
||
## Disabling SIP
|
||
|
||
Modern machines running MacOS have a security feature that shields of the memory of processes from other processes.
|
||
Depending on your machine you may have to disable SIP.
|
||
|
||
**For M1 macs it is required to disable SIP.**
|
||
|
||
### :warning: CAUTION :warning:
|
||
Turning off SIP allows any program with sudo privileges to modify memory contents of other processes. If you use pirated software, or other unverified apps, DO NOT DO THIS for your own safety! See the following stackoverflow post for some more info: https://apple.stackexchange.com/a/412281.
|
||
|
||
A guide for disabling SIP can be found here: https://developer.apple.com/documentation/security/disabling_and_enabling_system_integrity_protection
|
||
|
||
## Launching G-Earth
|
||
1. Open `Terminal` (press `⌘ + Enter`, type `Terminal` to open it from spotlight)
|
||
2. Type `sudo java -jar `
|
||
3. Drag the `G-Earth.jar` file into your terminal window *(this will append the path to the terminal)*
|
||
|
||
Your terminal window should now resemble the following:
|
||
|
||
|
||
|
||
5. Press enter and fill in your password if prompted
|
||
|
||
## Troubleshooting
|
||
|
||
### 🚫 Apple can’t check app for malicious software
|
||
In this case, you can grant an exception for a blocked app by clicking the `Open Anyway` button in Privacy & Security settings.
|
||
This button is available for about an hour after you try to open the app. Where it appears exactly depends on the OS version u are running,
|
||
more details about it can be found here: https://support.apple.com/en-gb/guide/mac-help/mchleab3a043/mac
|
||
|
||
### Other
|
||
If you experience any other issues and the [Troubleshooting Page](https://github.com/sirjonasxx/G-Earth/wiki/Troubleshooting) doesn't help,
|
||
|
||
it might be useful to have a look at the following issues: [#67](../issues/67) [#10](../issues/10)
|
||
|