Pietro Rampazzo

moon indicating dark mode
sun indicating light mode

Migrate WhatsApp Chats from Android to iOS

December 18, 2021

I haven’t posted for a very long time, this is the opportunity to give some space to some experiments I have done recently 🚀.

Most of the work has already been done and it’s open source - this article aims to describe what are steps needed to be conducted and which are the limitations.

At the time of writing, WhatsApp doesn’t support an official workflow to let users migrate their chats from an Android device to an iPhone. However, it looks like this feature is under development.

Worth mentioning, this solution is a bit hacky. Only text messages would be migrated. This means media (pictures and videos) and audio notes won’t be migrated to the new device. Instead, a placeholder would be display instead such as <image> or <audio>.

IMG 0038

IMG 0037

Therefore, it is necessary to have XCode installed.

  1. Run a full backup on the Android device.
  2. Activate WhatsApp on the iPhone.
  3. Create a backup of WhatsApp on your iPhone.
  4. Using WhatsApp-Key-DB-Extractor a copy of the backup stored in the Android device can be transferred to the laptop - download the project and extract it, be sure to have all the prerequisites set up. The device must be connected to the laptop and the debugging mode enabled. After exporting the history it might be impossible to launch WhatsApp on your Android device.
  5. (Optional) If you copy on your laptop the WhatsApp media folder you can export into html file all the chats using Whatsapp-Chat-Exporter.
  6. Clone watoi project (or download it as previously done in step 4). Following the step-by-step guide a local backup of the iPhone will be created (with the new MacOS version must be done using Finder and not iTunes) - therefore, the idea is to inject inside the existing backup the history stored in the backup created previously on the Android device. Finally, restore the iPhone from the updated backup.

IMG 0039

A part of the groups, all the chats will be listed in the ‘Archived’ tab. Although, when opening a chat all the saved messages will be displayed!


Hi, I'm Pietro.
Some guy in from Padova.