Merge branch 'workflows' into documentation

.github/workflows/build-release.yml

@@ -0,0 +1,79 @@
+name: Build Release
+
+on:
+  push:
+    branches: [main]
+
+env:
+  CARGO_TERM_COLOR: always
+
+jobs:
+  build_serial:
+    strategy:
+      matrix:
+        platform:
+          - os: ubuntu-latest
+            build_name: serial
+          - os: windows-latest
+            build_name: serial.exe
+          - os: macos-latest
+            build_name: serial
+    runs-on: ${{ matrix.platform.os }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Build serial
+        run: cargo build --bin serial --release
+      - uses: actions/upload-artifact@v4
+        with:
+          name: serial-${{ matrix.platform.os }}
+          path: ./target/release/${{ matrix.platform.build_name }}
+          if-no-files-found: error
+  build_rootshell_and_rayhunter:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: dtolnay/rust-toolchain@stable
+        with:
+          targets: armv7-unknown-linux-gnueabihf
+      - name: Install cross-compilation dependencies
+        uses: awalsh128/cache-apt-pkgs-action@latest
+        with:
+          packages: build-essential libc6-armhf-cross libc6-dev-armhf-cross gcc-arm-linux-gnueabihf
+          version: 1.0
+      - name: Build rootshell (arm32)
+        run: cargo build --bin rootshell --target armv7-unknown-linux-gnueabihf --release
+      - uses: actions/upload-artifact@v4
+        with:
+          name: rootshell
+          path: target/armv7-unknown-linux-gnueabihf/release/rootshell
+          if-no-files-found: error
+      - name: Build rayhunter-daemon (arm32)
+        run: cargo build --bin rayhunter-daemon --target armv7-unknown-linux-gnueabihf --release
+      - uses: actions/upload-artifact@v4
+        with:
+          name: rayhunter-daemon
+          path: target/armv7-unknown-linux-gnueabihf/release/rayhunter-daemon
+          if-no-files-found: error
+  build_release_zip:
+    needs:
+      - build_serial
+      - build_rootshell_and_rayhunter
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/download-artifact@v4
+      - name: Setup release directory
+        run: mv rayhunter-daemon/rayhunter-daemon rootshell/rootshell serial-* dist
+      - name: Archive release directory
+        uses: thedoctor0/[email protected]
+        with:
+          type: 'zip'
+          filename: 'release.zip'
+          directory: 'dist'
+      # TODO: have this create a release directly
+      - name: Upload release
+        uses: actions/upload-artifact@v4
+        with:
+          name: release.zip
+          path: dist/release.zip
+          if-no-files-found: error

.github/workflows/rust.yml → .github/workflows/check-and-test.yml

@@ -1,4 +1,4 @@
-name: Rust
+name: Check and Test
 
 on:
   push:
@@ -10,13 +10,11 @@ env:
   CARGO_TERM_COLOR: always
 
 jobs:
-  build:
-
+  check_and_test:
     runs-on: ubuntu-latest
-
     steps:
     - uses: actions/checkout@v3
-    - name: Build
-      run: cargo build --verbose
+    - name: Check
+      run: cargo check --verbose
     - name: Run tests
       run: cargo test --verbose

README.md

@@ -33,41 +33,60 @@ Rayhunter is an IMSI Catcher Catcher for the Orbic mobile hotspot. Based on code
 Code is built and tested for the Orbic RC400L mobile hotspot, it may work on other orbics and other 
 linux/qualcom devices but this is the only one we have tested on. Buy the orbic [using bezos bucks](https://www.amazon.com/gp/product/B09CLS6Z7X/)
 
+## Setup
 
+1. Install the Android Debug Bridge (ADB) on your computer (don't worry about instructions for installing it on a phone/device yet). You can find instructions for doing so on your platform [here](https://www.xda-developers.com/install-adb-windows-macos-linux/#how-to-set-up-adb-on-your-computer).
+2. Download the latest rayhunter release bundle and unzip it.
+3. Run the install script inside the bundle corresponding to your platform (`install-linux.sh`, `install-mac.sh`, or `install-windows.bat`).
+4. Once finished, rayhunter should be running! You can verify this by visiting the web UI as described below.
 
+## Usage
+
+Once installed, rayhunter will run automatically whenever your Orbic device is running. It serves a web UI that provides some basic controls, such as being able to start/stop recordings, download captures, and view heuristic analyses of captures. You can access this UI in one of two ways:
+
+1. Over wifi: Connect your phone/laptop to the Orbic's wifi network and visit `http://192.168.1.1:8080` (click past your browser warning you about the connection not being secure, rayhunter doesn't have HTTPS yet!)
+    * Note that you'll need the Orbic's wifi password for this, which can be retrieved by pressing the "MENU" button on the device and opening the 2.4 GHz menu.
+2. Over usb: Connect the Orbic device to your laptop via usb. Run `adb forward tcp:8080 tcp:8080`, then visit `http://localhost:8080`.
+
+## Development
+* Install ADB  on your computer using the instructions above. 
 
-## Setup
 ### If your are on x86 linux
-on your linux laptop install rust the usual way and then install cross compiling dependences. 
-run `sudo apt install  build-essential libc6-armhf-cross libc6-dev-armhf-cross gcc-arm-linux-gnueabihf`
+* on your linux laptop install rust the usual way and then install cross compiling dependences. 
+* run `sudo apt install  build-essential libc6-armhf-cross libc6-dev-armhf-cross gcc-arm-linux-gnueabihf`
 
-set up cross compliing for rust:
+* set up cross compliing for rust:
 ```
 rustup target add x86_64-unknown-linux-gnu
 rustup target add armv7-unknown-linux-gnueabihf
 ```
 
 Now you can root your device and install rayhunter by running `./install.sh` - **Note:** You will have to install the cross compile tooling below before running this. 
 
-
 ### If you aren't on linux or can't run the install scripts 
-Root your device on windows using the instructions here: https://xdaforums.com/t/resetting-verizon-orbic-speed-rc400l-firmware-flash-kajeet.4334899/#post-87855183
+* Root your device on windows using the instructions here: https://xdaforums.com/t/resetting-verizon-orbic-speed-rc400l-firmware-flash-kajeet.4334899/#post-87855183
 
-Build for arm using `cargo build` 
+* Build for arm using `cargo build` 
 
-Run tests using `cargo test_pc`
+* Run tests using `cargo test_pc`
 
-Push the scripts in `scripts/` to /etc/init.d  on device and make a directory called /data/rayhunter using `adb shell` (and sshell for your root shell if you followed the steps above) 
+* Push the scripts in `scripts/` to /etc/init.d  on device and make a directory called /data/rayhunter using `adb shell` (and sshell for your root shell if you followed the steps above) 
 
-you also need to copy `config.toml.example` to /data/rayhunter/config.toml
+* you also need to copy `config.toml.example` to /data/rayhunter/config.toml
 
-Then run `./make.sh` this will build the binary and push it over adb. Restart your device or run `/etc/init.d/rayhunter_daemon start` on the device and you are good to go. 
+* Then run `./make.sh` this will build the binary and push it over adb. Restart your device or run `/etc/init.d/rayhunter_daemon start` on the device and you are good to go. 
 
-## Development
-Write your code and write tests 
+* Write your code and write tests 
+
+* Build for arm using `cargo build` 
+
+* Run tests using `cargo test_pc`
+
+* push to the device with `./make.sh`
 
-Build for arm using `cargo build` 
+## Documentation 
+* Build docs locallly using `RUSTDOCFLAGS="--cfg docsrs" cargo doc --no-deps --all-features  --open`
 
-Run tests using `cargo test_pc`
+**LEGAL DISCLAIMER:** Use this program at your own risk. We beilieve running this program does not currently violate any laws or FCC regulations in the United States. However, we are not responsible for civil or criminal liability resulting from the use of this software. If you are located outside of the US please consult with an attorney in your country to help you assess the legal risks of running this program. 
 
-push to the device with `./make.sh`
+*Good Hunting!*

dist/install-common.sh

@@ -0,0 +1,61 @@
+#!/bin/env bash
+
+install() {
+    if [[ -z "${SERIAL_PATH}" ]]; then
+        echo "SERIAL_PATH not set, did you run this from install-linux.sh or install-mac.sh?"
+        exit 1
+    fi
+    check_adb
+    force_debug_mode
+    setup_rootshell
+    setup_rayhunter
+}
+
+check_adb() {
+    if ! command -v adb &> /dev/null
+    then
+        echo "adb not found, please ensure it's installed or check the README.md"
+        exit 1
+    fi
+}
+
+force_debug_mode() {
+    # Force a switch into the debug mode to enable ADB
+    $(SERIAL_PATH) AT
+    echo -n "adb enabled, waiting for reboot"
+    until adb shell true 2> /dev/null
+    do
+        echo -n .
+        sleep 1
+    done
+    echo
+    echo "it's alive!"
+}
+
+setup_rootshell() {
+    _adb_push rootshell /tmp/
+    $(SERIAL_PATH) "AT+SYSCMD=mv /tmp/rootshell /bin/rootshell"
+    sleep 1
+    $(SERIAL_PATH) "AT+SYSCMD=chown root /bin/rootshell"
+    sleep 1
+    $(SERIAL_PATH) "AT+SYSCMD=chmod 4755 /bin/rootshell"
+    echo "we have root!"
+    adb shell /bin/rootshell -c id
+}
+
+_adb_push() {
+    adb push "$(dirname "$0")/$1" "$2"
+}
+
+setup_rayhunter() {
+    adb shell '/bin/rootshell -c "mkdir /data/rayhunter"'
+    _adb_push config.toml.example /data/rayhunter/config.toml
+    _adb_push rayhunter-daemon /data/rayhunter/
+    _adb_push scripts/rayhunter_daemon /tmp/rayhunter_daemon
+    _adb_push scripts/misc-daemon /tmp/misc-daemon
+    adb shell '/bin/rootshell -c "mv /tmp/rayhunter_daemon /etc/init.d/rayhunter_daemon"'
+    adb shell '/bin/rootshell -c "mv /tmp/misc-daemon /etc/init.d/misc-daemon"'
+    adb shell '/bin/rootshell -c "chmod 755 /etc/init.d/rayhunter_daemon"'
+    adb shell '/bin/rootshell -c "chmod 755 /etc/init.d/misc-daemon"'
+    adb shell '/bin/rootshell -c "/etc/init.d/rayhunter_daemon start"'
+}

dist/install-linux.sh

@@ -0,0 +1,6 @@
+#!/bin/env bash
+
+set -e
+export SERIAL_PATH="./serial-ubuntu-latest/serial"
+. "$(dirname "$0")"/install-common.sh
+install

dist/install-mac.sh

@@ -0,0 +1,6 @@
+#!/bin/env bash
+
+set -e
+export SERIAL_PATH="./serial-mac-latest/serial"
+. "$(dirname "$0")"/install-common.sh
+install

dist/install-windows.bat

@@ -0,0 +1 @@
+ECHO TODO