From c3fd724ac108d55871b64e8e4718e4917dad2c16 Mon Sep 17 00:00:00 2001 From: Markus Unterwaditzer Date: Tue, 24 Jun 2025 19:50:50 +0200 Subject: [PATCH 1/6] doc: Give guidance on which device to get --- doc/supported-devices.md | 18 +++++++++++------- 1 file changed, 11 insertions(+), 7 deletions(-) diff --git a/doc/supported-devices.md b/doc/supported-devices.md index 1be8dc9..682e837 100644 --- a/doc/supported-devices.md +++ b/doc/supported-devices.md @@ -1,15 +1,19 @@ # Supported devices -Rayhunter was built and tested primarily on the Orbic RC400L mobile hotspot, but the community has been working hard at adding support for other devices. Theoretically, if a device runs a Qualcomm modem and exposes a `/dev/diag` interface, Rayhunter may work on it. +## Recommended devices -If you have a device in mind which you'd like Rayhunter to support, please [open a discussion on our Github](https://github.com/EFForg/rayhunter/discussions)! - -## Tier 1 - Fully supported devices These devices have been extensively tested by the core developers and are widely used. We recommend running Rayhunter on one of these devices if you can. + - [Orbic RC400L](./orbic.md) - [TP-Link M7350](./tplink-m7350.md) -- [TP-Link M7310](./tplink-m7310.md) -## Tier 2 - Functional devices -Some developers have succeeded in getting Rayhunter running on these devices, but they have not received the same level of adoption as tier 1 devices. +If you are in the US, use the Orbic. TP-Link M7350 also works but is usually more expensive to obtain. Otherwise use TP-Link M7350. + +## Other devices + +These devices are also supported but less commonly used. We do not recommend getting them for this purpose unless you already have one. + +- [TP-Link M7310](./tplink-m7310.md) - [Wingtech CT2MHS01](./wingtech-ct2mhs01.md) + +Theoretically, if a device can be rooted, runs a Qualcomm modem and exposes a `/dev/diag` interface, Rayhunter may work on it. If you have a device in mind which you'd like Rayhunter to support, please [open a discussion on our Github](https://github.com/EFForg/rayhunter/discussions)! From ef7b8129efe32520b9141b9acb5533218eb3e2e0 Mon Sep 17 00:00:00 2001 From: Markus Unterwaditzer Date: Tue, 24 Jun 2025 19:57:46 +0200 Subject: [PATCH 2/6] Fix version number in docs, 0.3.5 does not exist --- doc/tplink-m7310.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/tplink-m7310.md b/doc/tplink-m7310.md index 70946e2..2b7c369 100644 --- a/doc/tplink-m7310.md +++ b/doc/tplink-m7310.md @@ -1,6 +1,6 @@ # TP-Link M7310 -The TP-Link M7310 is **supported by Rayhunter since 0.3.5**. The device +The TP-Link M7310 is **supported by Rayhunter since 0.4.0**. The device works similarly to the [M7350](./tplink-m7350.md) and is essentially an older, more expensive version of it. Hardware version v1.0 has been successfully tested, later versions may work as well. From 8b44f604ea66ecfbc4203e689feb9f8f2f360ab3 Mon Sep 17 00:00:00 2001 From: Markus Unterwaditzer Date: Thu, 26 Jun 2025 22:02:48 +0200 Subject: [PATCH 3/6] sort orbic to the top --- doc/SUMMARY.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/SUMMARY.md b/doc/SUMMARY.md index f7de5e9..52c4a12 100644 --- a/doc/SUMMARY.md +++ b/doc/SUMMARY.md @@ -12,9 +12,9 @@ - [Rayhunter's heuristics](./heuristics.md) - [How we analyze a capture](./analyzing-a-capture.md) - [Supported devices](./supported-devices.md) + - [Orbic RC400L](./orbic.md) - [TP-Link M7350](./tplink-m7350.md) - [TP-Link M7310](./tplink-m7310.md) - - [Orbic RC400L](./orbic.md) - [Wingtech CT2MHS01](./wingtech-ct2mhs01.md) - [Support, feedback, and community](./support-feedback-community.md) - [Frequently Asked Questions](./faq.md) From bd074066c57c2deda6386ed5873b5499fd4721e9 Mon Sep 17 00:00:00 2001 From: Markus Unterwaditzer Date: Sun, 29 Jun 2025 00:37:43 +0200 Subject: [PATCH 4/6] Adjust language around supported versions, to be similar across pages --- doc/tplink-m7310.md | 12 ++++++++---- doc/tplink-m7350.md | 4 +++- 2 files changed, 11 insertions(+), 5 deletions(-) diff --git a/doc/tplink-m7310.md b/doc/tplink-m7310.md index 2b7c369..7a46774 100644 --- a/doc/tplink-m7310.md +++ b/doc/tplink-m7310.md @@ -1,6 +1,10 @@ # TP-Link M7310 -The TP-Link M7310 is **supported by Rayhunter since 0.4.0**. The device -works similarly to the [M7350](./tplink-m7350.md) and is essentially an older, -more expensive version of it. Hardware version v1.0 has been successfully -tested, later versions may work as well. +Supported in Rayhunter since version 0.4.0. + +The TP-Link M7310 works similarly to the [M7350](./tplink-m7350.md) and is +essentially an older, more expensive version of it. The installation procedure +is identical, `./installer tplink`. + +Hardware version v1.0 has been successfully tested, later versions may work as +well. diff --git a/doc/tplink-m7350.md b/doc/tplink-m7350.md index a5e509d..41d1202 100644 --- a/doc/tplink-m7350.md +++ b/doc/tplink-m7350.md @@ -1,6 +1,8 @@ # TP-Link M7350 -The TP-Link M7350 is **supported by Rayhunter since 0.3.0**. TP-Link M7350 supports many more frequency bands than Orbic and therefore works in Europe and also in some Asian and African countries. +Supported in Rayhunter since version 0.3.0. + +The TP-Link M7350 supports many more frequency bands than Orbic and therefore works in Europe and also in some Asian and African countries. ## Hardware versions From 3889c89b5ab5d7f56819e2eb7f612c8ce6d38296 Mon Sep 17 00:00:00 2001 From: Markus Unterwaditzer Date: Sun, 29 Jun 2025 00:51:01 +0200 Subject: [PATCH 5/6] Fix autolinks --- doc/installing-from-release-windows.md | 2 +- doc/tplink-m7350.md | 2 +- doc/using-rayhunter.md | 6 +++--- doc/wingtech-ct2mhs01.md | 9 +++++---- 4 files changed, 10 insertions(+), 9 deletions(-) diff --git a/doc/installing-from-release-windows.md b/doc/installing-from-release-windows.md index af26a14..62bf042 100644 --- a/doc/installing-from-release-windows.md +++ b/doc/installing-from-release-windows.md @@ -4,7 +4,7 @@ Windows support in Rayhunter's installer is a work-in-progress. Depending on the ## TP-Link -1. Connect the device via WiFi or USB Tethering -- you should be able to view the TP-Link admin page on [http://192.168.0.1](http://192.168.0.1). +1. Connect the device via WiFi or USB Tethering -- you should be able to view the TP-Link admin page on . 2. Download the latest release (must be at least 0.3.0), and unpack the zipfile. 3. Open PowerShell or CMD in that extracted folder, and run the binary appropriate for your operating system: `./installer-windows-x86_64/installer tplink` 4. Follow the instructions on the screen, if there are any. diff --git a/doc/tplink-m7350.md b/doc/tplink-m7350.md index 41d1202..a91f6f0 100644 --- a/doc/tplink-m7350.md +++ b/doc/tplink-m7350.md @@ -28,7 +28,7 @@ You can get your TP-Link M7350 from: ## Installation & Usage -Follow the [release installation guide](./installing-from-release.md). Substitute `./installer orbic` for `./installer tplink` in other documentation. The Rayhunter UI will be available at [http://192.168.0.1:8080](http://192.168.0.1:8080). +Follow the [release installation guide](./installing-from-release.md). Substitute `./installer orbic` for `./installer tplink` in other documentation. The Rayhunter UI will be available at . ## Obtaining a shell diff --git a/doc/using-rayhunter.md b/doc/using-rayhunter.md index 60f4750..3ce54e2 100644 --- a/doc/using-rayhunter.md +++ b/doc/using-rayhunter.md @@ -11,15 +11,15 @@ It also serves a web UI that provides some basic controls, such as being able to You can access this UI in one of two ways: * **Connect over WiFi:** Connect your phone/laptop to your device's WiFi - network and visit [http://192.168.1.1:8080](http://192.168.1.1:8080) (orbic) - or [http://192.168.0.1:8080](http://192.168.0.1:8080) (tplink). + network and visit (orbic) + or (tplink). Click past your browser warning you about the connection not being secure, Rayhunter doesn't have HTTPS yet. On the **Orbic**, you can find the WiFi network password by going to the Orbic's menu > 2.4 GHz WIFI Info > Enter > find the 8-character password next to the lock 🔒 icon. On the **TP-Link**, you can find the WiFi network password by going to the TP-Link's menu > Advanced > Wireless > Basic Settings. -* **Connect over USB (Orbic):** Connect your device to your laptop via USB. Run `adb forward tcp:8080 tcp:8080`, then visit [http://localhost:8080](http://localhost:8080). +* **Connect over USB (Orbic):** Connect your device to your laptop via USB. Run `adb forward tcp:8080 tcp:8080`, then visit . * For this you will need to install the Android Debug Bridge (ADB) on your computer, you can copy the version that was downloaded inside the `releases/platform-tools/` folder to somewhere else in your path or you can install it manually. * 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), (don't worry about instructions for installing it on a phone/device yet). * On MacOS, the easiest way to install ADB is with Homebrew: First [install Homebrew](https://brew.sh/), then run `brew install android-platform-tools`. diff --git a/doc/wingtech-ct2mhs01.md b/doc/wingtech-ct2mhs01.md index 00dc9ef..ab22012 100644 --- a/doc/wingtech-ct2mhs01.md +++ b/doc/wingtech-ct2mhs01.md @@ -5,11 +5,12 @@ Supported in Rayhunter since version 0.4.0. The Wingtech CT2MHS01 hotspot is a Qualcomm mdm9650-based device with a screen available for US$15-35. This device is often used as a base platform for white labeled versions like the T-Mobile TMOHS1. AT&T branded versions of the hotspot seem to be the most abundant. ## Hardware + Wingtechs are abundant on ebay and can also be found on Amazon: -- https://www.amazon.com/AT-Turbo-Hotspot-256-Black/dp/B09YWLXVWT -- https://www.ebay.com/itm/135205906535 -- https://www.ebay.com/itm/126987839936 -- https://www.ebay.com/itm/127147132518 +- +- +- +- Rayhunter has been tested on From e259417f35b8770c11efbbb9eb2d8d13b274776e Mon Sep 17 00:00:00 2001 From: Markus Unterwaditzer Date: Sun, 29 Jun 2025 01:57:28 +0200 Subject: [PATCH 6/6] Revert some of the changes in supported-devices index --- doc/supported-devices.md | 16 +++++++--------- 1 file changed, 7 insertions(+), 9 deletions(-) diff --git a/doc/supported-devices.md b/doc/supported-devices.md index 682e837..1dd24dd 100644 --- a/doc/supported-devices.md +++ b/doc/supported-devices.md @@ -1,19 +1,17 @@ # Supported devices -## Recommended devices +Rayhunter was built and tested primarily on the Orbic RC400L mobile hotspot, but the community has been working hard at adding support for other devices. Theoretically, if a device runs a Qualcomm modem and exposes a `/dev/diag` interface, Rayhunter may work on it. +If you have a device in mind which you'd like Rayhunter to support, please [open a discussion on our Github](https://github.com/EFForg/rayhunter/discussions)! + +## Tier 1 - Fully supported devices These devices have been extensively tested by the core developers and are widely used. We recommend running Rayhunter on one of these devices if you can. - - [Orbic RC400L](./orbic.md) - [TP-Link M7350](./tplink-m7350.md) If you are in the US, use the Orbic. TP-Link M7350 also works but is usually more expensive to obtain. Otherwise use TP-Link M7350. -## Other devices - -These devices are also supported but less commonly used. We do not recommend getting them for this purpose unless you already have one. - -- [TP-Link M7310](./tplink-m7310.md) +## Tier 2 - Functional devices +Some developers have succeeded in getting Rayhunter running on these devices, but they have not received the same level of adoption as tier 1 devices. - [Wingtech CT2MHS01](./wingtech-ct2mhs01.md) - -Theoretically, if a device can be rooted, runs a Qualcomm modem and exposes a `/dev/diag` interface, Rayhunter may work on it. If you have a device in mind which you'd like Rayhunter to support, please [open a discussion on our Github](https://github.com/EFForg/rayhunter/discussions)! +- [TP-Link M7310](./tplink-m7310.md)