{"id":15093352,"url":"https://github.com/residentsummer/watoi","last_synced_at":"2025-04-05T22:07:57.334Z","repository":{"id":38360619,"uuid":"89517356","full_name":"residentsummer/watoi","owner":"residentsummer","description":"Whatsapp Android To iOS Importer","archived":false,"fork":false,"pushed_at":"2022-01-03T13:54:36.000Z","size":49,"stargazers_count":448,"open_issues_count":17,"forks_count":57,"subscribers_count":16,"default_branch":"master","last_synced_at":"2025-03-29T21:05:56.222Z","etag":null,"topics":["android","ios","migration","whatsapp"],"latest_commit_sha":null,"homepage":null,"language":"Objective-C","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/residentsummer.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2017-04-26T19:09:07.000Z","updated_at":"2025-03-09T21:07:02.000Z","dependencies_parsed_at":"2022-08-26T16:51:44.232Z","dependency_job_id":null,"html_url":"https://github.com/residentsummer/watoi","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/residentsummer%2Fwatoi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/residentsummer%2Fwatoi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/residentsummer%2Fwatoi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/residentsummer%2Fwatoi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/residentsummer","download_url":"https://codeload.github.com/residentsummer/watoi/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247406090,"owners_count":20933803,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["android","ios","migration","whatsapp"],"created_at":"2024-09-25T11:21:42.560Z","updated_at":"2025-04-05T22:07:57.309Z","avatar_url":"https://github.com/residentsummer.png","language":"Objective-C","funding_links":[],"categories":["Objective-C"],"sub_categories":[],"readme":"# Whatsapp Android To iOS Importer\n\nMigrate Whatsapp chats history from Android to iOS.\n\n## Caveats\n\n* Media files and shared locations are not imported (got placeholders instead)\n* Messages from contacts that changed ids (phone numbers) are not linked\n\n## User-contributed guides\n\nThanks to our excellent community members, there are few guides that may be easier\nto follow than one written by me. Some of them include instructions on how to\nextract whatsapp database from Android phone.\n\n* 2021-11-17: [full guide](https://github.com/tim25651/WhatsApp2iOS) by @tim25651\n* 2021-12-30: [full guide](https://github.com/needs-coffee/Whatsapp-android-to-ios-guide) by @needs-coffee, on Windows via MacOS VM\n\nMany users also contributed tips on how to get certain prerequisites done.\n\n* 2021-01-07: [getting database from Android](https://github.com/residentsummer/watoi/issues/35#issue-780915054) by @MaxWolodin\n* 2021-06-23: [MacOS VM setup](https://gist.github.com/5E7EN/6c55297856c36efc6e0921b0eeff72d0) by @5E7EN\n* See [#9](https://github.com/residentsummer/watoi/issues/9), [#27](https://github.com/residentsummer/watoi/issues/27), [#28](https://github.com/residentsummer/watoi/issues/28), [#35](https://github.com/residentsummer/watoi/issues/35) and [#43](https://github.com/residentsummer/watoi/issues/43) for more tips and cases\n\n## Prerequisites\n\n* Mac with installed Xcode and iTunes (or MacOS VM)\n* Decrypted `msgstore.db` from Android\n* Installed and activated Whatsapp on your iDevice\n* `Whatsapp.ipa` of the same version (google will help)\n\n## Step-by-step guide\n\n* Check that Whatsapp is activated on iDevice. You should see the list of *group* chats\n  when you open the app. Most likely, there won't be any messages prior to moving to iOS.\n  You can even send/receive a message or two to be sure that there is something to back up.\n* If you're on Mac OS 10.14 or later, [enable full disk access for your terminal app](https://osxdaily.com/2018/10/09/fix-operation-not-permitted-terminal-error-macos/).\n* Build the migration utility (I'll assume `~/Downloads` folder):\n\n      cd ~/Downloads\n      git clone https://github.com/residentsummer/watoi\n      cd watoi\n      xcodebuild -project watoi.xcodeproj -target watoi\n\n* Create an unencrypted backup to local computer (not iCloud) with iTunes.\n* Find out the ID of the latest backup and export it into an env var for later use\n\n      scripts/bedit.sh list-backups\n      # total 0\n      # drwxr-xr-x@   266 user  staff    8512 Nov 19 22:25 3105fe2b1e4688d54920d5b7eff3a06a71fd5957  # \u003c= this is the latest\n      # drwxr-xr-x  20781 user  staff  664992 Aug 16 14:19 e38ebede76a7801807fe98684fd6d0b7fc3e64ba\n\n      export BACKUP_ID=\"put ID of the backup here\"\n      # For example (do not copy-paste the line below, your ID will be different!):\n      # export BACKUP_ID=3105fe2b1e4688d54920d5b7eff3a06a71fd5957\n\n* Extract whatsapp's chat storage and backup important files\n\n      export ORIGINALS=\"originals/$(date +%s)\"\n      mkdir -p $ORIGINALS\n      scripts/bedit.sh extract-chats $BACKUP_ID $ORIGINALS/ChatStorage.sqlite\n      scripts/bedit.sh extract-blob $BACKUP_ID Manifest.db $ORIGINALS/Manifest.db\n      cp $ORIGINALS/ChatStorage.sqlite ./ChatStorage.sqlite\n\n* Extract the contents of `Whatsapp.ipa` (we'll need CoreData description files):\n\n      cd ~/Downloads/watoi\n      unzip ~/Downloads/WhatsApp_Messenger_x.y.z.ipa -d app\n\n* Run the migration:\n\n      build/Release/watoi \u003cpath-to-msgstore.db\u003e ./ChatStorage.sqlite app/Payload/WhatsApp.app/Frameworks/Core.framework/WhatsAppChat.momd\n\n* Replace database file inside the backup with the updated one:\n\n      scripts/bedit.sh replace-chats $BACKUP_ID ./ChatStorage.sqlite\n\n* Restore the backup with iTunes\n\n## Troubleshooting\n\n[![Gitter](https://badges.gitter.im/gitterHQ/gitter.svg)](https://gitter.im/residentsummer_watoi/Lobby?utm_source=badge\u0026utm_medium=badge\u0026utm_campaign=pr-badge)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresidentsummer%2Fwatoi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fresidentsummer%2Fwatoi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fresidentsummer%2Fwatoi/lists"}