reincubate/ricloud

Python client for Reincubate's ricloud API. Yes, it works with iOS 14 & iPhone 12 backups!

ricloud-py: iCloud access made easy

This is the Python client for ricloud, Reincubate's Cloud Data API.

Refer to the comprehensive ricloud documentation for a fuller picture of the API's capabilities, specifications, and benefits. See also the Apple iCloud service documentation for its rich capabilities in accessing iCloud data.

Installation

The library can be installed with a single command:

$ pip install ricloud

Note the version is specified explicitly above, that is because this version is currently in beta.

Usage

A sample script is included which provides an example of how the API can be used to access a range of datatypes in a way that is compatible with Apple's 2FA mechanism.

Before you can start using the API you will need to get setup with an access token. More details on getting started with the API can be found in the docs.

To run the sample script in interactive mode, execute the following command:

$ ricloud samples icloud [email protected]

More details on how to use the ricloud-py client can be found in our docs.

Troubleshooting

See the support & service status page.

Need more functionality?

Reincubate's vision is to provide data access, extraction and recovery technology for all app platforms - be they mobile, desktop, web, appliance or in-vehicle.

The company was founded in 2008 and was first to market with both iOS and iCloud data extraction technology. With over half a decade's experience helping law enforcement and security organisations access iOS data, Reincubate has licensed software to government, child protection and corporate clients around the world.

The company can help users with:

• iCloud access and data recovery
• Recovery of data deleted from SQLite databases
• Bulk iOS data recovery
• Forensic examination of iOS data
• Passcode, password, keybag and keychain analysis
• Custom iOS app data extraction
• Advanced PList, TypedStream and Mbdb manipulation

Contact Reincubate for more information.

Terms & license

See the LICENSE.md file for details on this implementation's license. Users must not use the API in any way that is unlawful, illegal, fraudulent or harmful; or in connection with any unlawful, illegal, fraudulent or harmful purpose or activity.

ricloud's Issues

how use this to backup my activation Files

Thanks for the pull request guys, this is awesome. I'm afraid we can't accept it as-is, as it would remove MySQL support from the application. Are you able to make it optional?

Thanks for the pull request guys, this is awesome. I'm afraid we can't accept it as-is, as it would remove MySQL support from the application. Are you able to make it optional?

Is the relay mode simply to allow use of two keys simultaneously? If so, have you thought about instead running it with two different configs? Otherwise you run the risk of needing to make more modification like this if you used 3 or 4 keys. Use of multiple keys simultaneously can come in thru use of trial keys, or simultaneous real-time, subscription or local data feeds, etc.

Originally posted by @afit in #11 (comment)

Download snapchat file?

Hi, is this possible? I get a file_id for snapchat but when I download it it is showing as a text document.

Here is my code

 data_types = BackupClient.DATA_SNAPCHAT_MESSAGES

 data = api.backup_client.request_data(device, data_mask=data_types, since=since)

 i = 0

for chat in data['snapchat_messages']:
    handle = chat['handle']
    attachments = chat['attachments']

    for attachment in attachments:
        file_id = attachment['file_id']
        filename = "file-%s" % str(i)
        with open(filename, 'wb') as out:
            api.backup_client.download_file(device, file_id, out)

        i = i + 1

Install of ricloud package fails with pip >= v10

I have the feeling that with version 10 of pip, the install of the package is not working any more.

Apparently, the imports from pip should now be done with:

from pip._internal.req import parse_requirements

More info in this post

Output of my terminal when trying to install ricloud with pip 10.0.1

Collecting ricloud
  Using cached https://files.pythonhosted.org/packages/a9/88/98b5a7378f6a5b6a217d5f297676402549c48981c0336c22542ab1ea0267/ricloud-2.3.6.tar.gz
    Complete output from command python setup.py egg_info:
    Traceback (most recent call last):
      File "<string>", line 1, in <module>
      File "/private/var/folders/v9/mprh4w_1495_wv5yckc82d_h0000gn/T/pip-install-Izyh21/ricloud/setup.py", line 2, in <module>
        from pip.req import parse_requirements
    ImportError: No module named req
    
    ----------------------------------------

Error:  An error occurred while installing ricloud!
Command "python setup.py egg_info" failed with error code 1 in /private/var/folders/v9/mprh4w_1495_wv5yckc82d_h0000gn/T/pip-install-Izyh21/ricloud/

This is likely caused by a bug in ricloud. Report this to its maintainers.

Ios9.0 and above icloud backup

Hi,
i want to list and download the backups in iCloud of ios version 9.0 and above. I tried this code to do so as this code is showing error while authenticating my icloud account. error its showing is error 14090086:SSL routines:SSL3_Get_Server_Certificate:Certificate verify failed.

Can not get devices after login

Hey,
I was just trying out this package, but didn't go well as expected.

I tried to login using api.login(APPLE_ID, APPLE_PASSWORD)
It successfully logged in. But api.devices empty and my iCloud has one device attached.
I didn't overwrite anything in ricloud.ini
Any clue what is going Wrong?

ricloud

Invalid Token

hi, i installed the python extension and cloned the repo, but when i run it with i get "invalid token"

`pi@raspberrypi:~/ricloud $ python -m ricloud f*******@.it --password=*****

Push Api Error:
{
"message": "Failed to authenticate credentials for reason: invalid token.",
"success": false,
"error": "asapi-auth-invalid"
}
`

What's the problem?