Skip to content

Instantly share code, notes, and snippets.

@5E7EN
Last active February 29, 2024 00:24
Show Gist options
  • Star 8 You must be signed in to star a gist
  • Fork 0 You must be signed in to fork a gist
  • Save 5E7EN/6c55297856c36efc6e0921b0eeff72d0 to your computer and use it in GitHub Desktop.
Save 5E7EN/6c55297856c36efc6e0921b0eeff72d0 to your computer and use it in GitHub Desktop.
Migrate WhatsApp messages from an unrooted Android device to an iPhone - without a physical Mac (Windows 10).

Migrate WhatsApp from Android to iPhone (without root)

Description

After working around the clock searching for a way to migrate WhatsApp messages from Android to my brand-spankin' old iPhone X, coming across countless articles explaining that it was virtual impossible - especially without access to a Mac device, I thankfully came across a solution, and only felt it necessary to share.
I have tested this method using a Moto G Fast (Android 11), iPhone X (iOS 14.6), and Windows 10 PC.

Important Notes:

  • Media files and shared locations will not be imported/migrated. They will be shown instead as placeholders.
  • If you've already started using WhatsApp on your iPhone, fret not, this will simply merge your old messages with any existing ones. They should not be overwritten.
  • Messages from contacts that changed IDs (phone numbers) will not be linked.

Tools

The following applications will be utilized to complete the process:

Guide

As described at https://github.com/residentsummer/watoi#prerequisites, we will need to take care of some prerequisites before the actual migration.

Failsafe Backup

I would highly advise creating an iTunes backup of your device in the event that anything goes wrong down the line. Launch iTunes on Windows 10 and create a backup to This Computer (not iCloud). Once that's finished, continue below.

Decrypted msgstore.db from Android

  1. Follow the installation and extraction instructions for WhatsApp-Key-Database-Extractor.
  2. After successful extraction, locate the msgstore.db file and save in a memorable location.

Mac with installed Xcode and iTunes

  1. Follow a guide to install macOS in VMWare:
    • For Intel-based processors: Full Guide
    • For AMD-based processors, you will need to use AMD OSX kernel patches: Full Guide.
      Note: If you run into boot errors, you need to edit your .vmx file. Find it C:\Users\yourUsername\Documents\Virtual Machines\macOS 10.12, then search and edit the following lines to match:
      virtualHW.version = "10"
      firmware = "bios"
  2. Once you're all booted up to the macOS desktop, congratulations, you've completed the hardest step! Next, download Xcode 8.3.3, extract it, then move it to the /Applications folder.
  3. Open a Terminal window, run sudo xcodebuild -license, and agree to the Xcode Terms of Use.
    • Note: If you come across an error at this point (along the lines of tool 'xcodebuild' requires Xcode...), you may need to first run sudo xcode-select -s /Applications/Xcode.app/Contents/Developer, and try again.
  4. Open iTunes on macOS and attempt to connect the iPhone to the VM via USB passthrough (image). You may need to update iTunes to version 12.7 or later.
  5. Drag & drop the msgstore.db file from earlier into the Downloads folder within the VM. You will need this for the next step.
  6. Continue with the step-by-step instructions for watoi.

Whatsapp.ipa of the same version

At the time of writing, the most recent WhatsApp version is 2.21.11. The IPA for this version can be found at https://www.itsappleos.com/2021/01/downlaod-whatsapp-messenger-22111-ipa.html (direct download).
Simply download this file within the VM and after you've cloned watoi, move it to /Downloads/watoi along with the msgstore.db file.


Acknowledgements

I hope this guide proved itself useful, and I'd just like to acknowledge the efforts put in by those who made such a great feature possible without it being natively supported - including but not limited to:

@buryo
Copy link

buryo commented Feb 28, 2024

Step 2 where you ask to install "Xcode 8.3.3" doesn't work because the link doesn't work for me. I am facing "Your account can’t access this page."

Note: I found same version and downloaded from https://xcodereleases.com/

@5E7EN
Copy link
Author

5E7EN commented Feb 29, 2024

Step 2 where you ask to install "Xcode 8.3.3" doesn't work because the link doesn't work for me. I am facing "Your account can’t access this page."

Note: I found same version and downloaded from https://xcodereleases.com/

Nice find, I will update the download link in the gist.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment