Sneed-Group/pypush-plus-plus
1
0
Fork 0
mirror of https://github.com/Sneed-Group/pypush-plus-plus synced 2024-12-24 03:42:43 -06:00
Code Issues Projects Releases Packages Wiki Activity Actions
No description
196 commits 5 branches 0 tags 838 KiB
Python 99.1%
Shell 0.9%
Find a file
SpaceSaver 4f7f0ada51 Implement in sms_registration.py
2023-09-22 15:58:49 -04:00
emulated Add licensing information 2023-08-02 11:42:06 -04:00
ids make publishing client_data optional 2023-08-28 08:01:41 -04:00
proxy Iterate over references instead of indexes for identities 2023-08-20 17:15:45 -06:00
.gitignore incorporate most of June's changes 2023-08-19 15:25:21 -04:00
albert.py incorporate most of June's changes 2023-08-19 15:25:21 -04:00
apns.py incorporate most of June's changes 2023-08-19 15:25:21 -04:00
bags.py more refactoring 2023-07-27 17:34:38 -04:00
demo.py Fix manual PDU method for SMS registration 2023-09-16 21:11:02 -05:00
gateway_fetch.py Add gateway_fetch code 2023-09-22 15:44:25 -04:00
imessage.py refactoring and cleanup 2023-08-25 22:26:37 -04:00
LICENSE Add licensing information 2023-08-02 11:42:06 -04:00
README.md Add licensing information 2023-08-02 11:42:06 -04:00
requirements.txt Add trio to requirements.txt 2023-09-01 13:54:00 +01:00
sms_registration.py Implement in sms_registration.py 2023-09-22 15:58:49 -04:00

README.md

pypush

pypush is a POC demo of my recent iMessage reverse-engineering. It can currently register as a new device on an Apple ID, set up encryption keys, and send and receive iMessages!

pypush is completely platform-independent, and does not require a Mac or other Apple device to use!

Installation

It's pretty self explanatory:

  1. git clone https://github.com/JJTech0130/pypush
  2. pip3 install -r requirements.txt
  3. python3 ./demo.py

Troubleshooting

If you have any issues, please join the Discord and ask for help.

Operation

pypush will generate a config.json in the repository when you run demo.py. DO NOT SHARE THIS FILE. It contains all the encryption keys necessary to log into you Apple ID and send iMessages as you.

Once it loads, it should prompt you with >>. Type help and press enter for a list of supported commands.

Special Notes

Unicorn dependency

pypush currently uses the Unicorn CPU emulator and a custom MachO loader to load a framework from an old version of macOS, in order to call some obfuscated functions.

This is only necessary during initial registration, so theoretically you can register on one device, and then copy the config.json to another device that doesn't support the Unicorn emulator. Or you could switch out the emulator for another x86 emulator if you really wanted to.

Public key caching

iMessage will cache public keys. If you get decryption errors in pypush or can only send and not receive messages from another device, try logging out and back into iMessage on that device, forcing it to refresh it's key cache. Alternatively, you can wait and the cache should expire eventually.

Licensing

This project is licensed under the terms of the SSPL. Portions of this project are based on macholibre by Aaron Stephens under the Apache 2.0 license.

If you would like to use all or portions of this project in a commercial produce (without releasing source code), we are open to contacts about possible dual-licensing terms.