Improved documentation for installing on macOS

[blanchardjeremy]

Hey folks!

It took me a bit of fussing around to figure out how to get this working on my mac. I'd love to submit a pull request for slight improvements to the README documentation to handle edge case questions a little better and maek sure it's clear start-to-finish.

Here's what I had to do. I think some of these steps might not actually be necessary since I temporarily went down a route of compiling it myself, which ended up not being necessary.

Request - could others confirm if this is what they did? Or ideally, could someone try this from scratch and see if they can get it working following these exact steps.

Equipment

I was using the following equipment:

• Macbook Pro, silicon M2 running macOS Sequoia 15.3.2
• Orbic RC400L running firmware version 1.2.0

Step-by-step instructions

1. First, install homebrew
2. Install adb:

brew install android-platform-tools

4. Download the latest release.tar from the Rayhunter releases page
5. Unzip the release.tar. Open the terminal and navigate to the folder

cd ~/Downloads/rayhunter-[VERSION] # change to the version number you downloaded

7. Plug in the Orbic. Press the power button for 3 seconds to power it on.
   • Note: if you try running adb devices at this point, you may not see it listed, but the next step should still work.
8. Run the installer

./install-mac.sh

9. Access the web UI either:

   • Over WiFi: Connect to the Orbic's 2.4GHz network and visit http://192.168.1.1:8080/ (you can find the password by going to the Orbics menu > 2.4 GHz WIFI Info > Enter > find the 8-character password next to the 🔒 icon.)
   • Over USB: Run adb forward tcp:8080 tcp:8080 and visit http://localhost:8080/

Steps that are NOT needed (probably?)

I also did these steps at some point. I think these are only needed if you're building the code from source. But I wanted to drop them here in case they are actually pre-reqs for adb that I missed.

brew tap messense/macos-cross-toolchains
brew install arm-unknown-linux-gnueabihf
brew install rust
brew install android-platform-tools
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh -s -- -y
rustup target add armv7-unknown-linux-gnueabihf

[ardaniel]

I did not build from source on an M2 MacBook Pro, just used the release tarball, and didn't need the additional steps for brew/curl, just as a point of confirmation.

[aaronkarp123]

You've likely already seen this, but just to flag that I ran into an issue with installation on MacOs 15.13.2 with a Bad CPU type in executable error that was resolved via this comment: #124 (comment) . If this is an issue for many Mac users it may be helpful to add something about it in the docs.

[cooperq]

@blanchardjeremy your install steps look correct to me with the caveat that homebrew and adb don't actually need to be installed, the install script will download the latest version of adb if it can't be found. And you are right about steps that are not needed. I would be happy to accept a pull request. It would also be good if you could note that these are the steps for m1/m2 macs and that intel macs will need a different process as @aaronkarp123 mentions above.

[blanchardjeremy]

@aaronkarp123 - I'll make a PR for the M1/M2/silicon macs. Do you want to make one afterward for Intel macs?

[aaronkarp123]

Sure thing- I'll wait till yours is approved since you added the spot for it to go, then will put in NyarlaCat's compiled solution for Intel macs.