KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#dsh #dsh-plugin #ai-agent #developer-tools #codex #typescript #cli #deepseek-harness #claude-code #ai-agents #mcp #rust

beepserv-rewrite

★ 63 Open GitHub ↗

A small service that generates iMessage registration data on a jailbroken iPhone, now with an app and local state notifications

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# beepserv
A tweak for jailbroken iPhones that can be connected with Beeper Mini to provide phone number registration functionality

## Note
This is a rewrite of the original [beepserv](https://github.com/beeper/phone-registration-provider) with some code from the original.

There is also [JJTech's ValidationRelay](https://github.com/JJTech0130/ValidationRelay) now which allows you to use non-jailbroken iOS devices and can be more reliable if you're having issues with this tweak.

Joshua Higgins' blog has a [great guide](https://joshuafhiggins.github.io/post/the-ultimate-beeper-guide-2024/) on how to get iMessage working with Beeper.

The tweak is now split into 4 parts:
- **Application**: An app that shows the registration code, logs, and allows state notifications to be turned on or off
- **Controller**: A launch daemon that manages basically everything, including the relay connection
- **NotificationHelper**: This hooks into `SpringBoard` and sends local notifications
- **IdentityServices**: The part that hooks into `identityservicesd` and handles the generation of validation data

The app is pretty simple and does not have an icon yet.

## Building
You need to have [Theos](https://theos.dev/docs/installation) installed.

Also make sure Theos is up-to-date by running `$THEOS/bin/update-theos` (or `make update-theos`).

### Rootful
`make clean package FINALPACKAGE=1`

The Makefiles currently assume you have Xcode 11.7 installed at `/Applications/Xcode_11.7.app` when packaging for rootful to ensure compatibility with A12+ devices on iOS 12.0-13.7 ([more here](https://theos.dev/docs/arm64e-deployment)). You can either download this version from Apple or edit the Makefiles if you want to build with a different version.

### Rootless
`make clean package THEOS_PACKAGE_SCHEME=rootless FINALPACKAGE=1`

## Usage
This tweak should automatically run in the background, connected to Beeper's relay service, available to facilitate registering your Android's phone number with Apple.

To start this registration process, open the beepserv app, and enter the displayed registration code into Beeper Mini, and it should automatically start the registration process.

If you cannot find the code, SSH into the device and run `cat /var/mobile/.beepserv_state` (rootful) or `cat /var/jb/var/mobile/.beepserv_state` (rootless) to view the registration code.

### Using a self-hosted relay
If you are hosting your own [registration relay](https://github.com/beeper/registration-relay) server instead of using the default one, run the commands below on your device (replacing the URL with the one you want to use).

#### Rootful
1. `launchctl unload /Library/LaunchDaemons/com.beeper.beepservd.plist`
2. `echo "https://registration-relay.beeper.com/api/v1/provider" > /var/mobile/.beepserv_relay_url`
3. `rm -f /var/mobile/.beepserv_state`
4. `launchctl load /Library/LaunchDaemons/com.beeper.beepservd.plist`

#### Rootless
1. `launchctl unload /var/jb/Library/LaunchDaemons/com.beeper.beepservd.plist`
2. `echo "https://registration-relay.beeper.com/api/v1/provider" > /var/jb/var/mobile/.beepserv_relay_url`
3. `rm -f /var/jb/var/mobile/.beepserv_state`
4. `launchctl load /var/jb/Library/LaunchDaemons/com.beeper.beepservd.plist`

beepserv-rewrite

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README