From b34045a59fcd4da40c1021def34415039b789f8b Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Tue, 2 Jul 2024 17:08:04 +0000 Subject: [PATCH 1/5] Update bug_report.md --- .github/ISSUE_TEMPLATE/bug_report.md | 3 ++- 1 file changed, 2 insertions(+), 1 deletion(-) diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md index 9747bf6..92697ed 100644 --- a/.github/ISSUE_TEMPLATE/bug_report.md +++ b/.github/ISSUE_TEMPLATE/bug_report.md @@ -8,7 +8,8 @@ assignees: '' --- # Must have -- WhatsApp version: [WhatsApp version] - [Android/iOS] +- WhatsApp version: [WhatsApp version] +- OS: [Android/iOS] - [version] - Platform: [Linux/Windows/MacOS] - Branch and version: [main/dev] - [exporter version] From af3d31f773d90fab68c9c04dc6c1412d88e543f2 Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Fri, 13 Sep 2024 12:37:18 +0000 Subject: [PATCH 2/5] Update README.md --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index a5c6b10..73d6362 100644 --- a/README.md +++ b/README.md @@ -6,6 +6,8 @@ A customizable Android and iPhone Whatsapp database parser that will give you the history of your Whatsapp conversations in HTML and JSON. Inspired by [Telegram Chat Export Tool](https://telegram.org/blog/export-and-more). **If you plan to uninstall WhatsApp or delete your WhatsApp account, please make a backup of your WhatsApp database. You may want to use this exporter again on the same database in the future as the exporter develops** +If you would like to support this project, all you need to do is to contribute or share this project! If you think otherwise and want to make a donation, please refer to the [Donation Guide](https://blog.knugi.com/DONATE.html). + # Usage **Usage in README may be removed in the future. Check the usage in [Wiki](https://github.com/KnugiHK/Whatsapp-Chat-Exporter/wiki)**. From 7b0965ac1d36b1c5e4a42665f8d7e5112128637c Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Fri, 20 Sep 2024 13:25:13 +0000 Subject: [PATCH 3/5] Update README.md --- README.md | 17 ++++++++++++----- 1 file changed, 12 insertions(+), 5 deletions(-) diff --git a/README.md b/README.md index 73d6362..1f446db 100644 --- a/README.md +++ b/README.md @@ -4,14 +4,17 @@ [![Python](https://img.shields.io/pypi/pyversions/Whatsapp-Chat-Exporter)](https://pypi.org/project/Whatsapp-Chat-Exporter/) A customizable Android and iPhone Whatsapp database parser that will give you the history of your Whatsapp conversations in HTML and JSON. Inspired by [Telegram Chat Export Tool](https://telegram.org/blog/export-and-more). -**If you plan to uninstall WhatsApp or delete your WhatsApp account, please make a backup of your WhatsApp database. You may want to use this exporter again on the same database in the future as the exporter develops** +> [!TIP] +> If you plan to uninstall WhatsApp or delete your WhatsApp account, please make a backup of your WhatsApp database. You may want to use this exporter again on the same database in the future as the exporter develops. If you would like to support this project, all you need to do is to contribute or share this project! If you think otherwise and want to make a donation, please refer to the [Donation Guide](https://blog.knugi.com/DONATE.html). # Usage -**Usage in README may be removed in the future. Check the usage in [Wiki](https://github.com/KnugiHK/Whatsapp-Chat-Exporter/wiki)**. -**If you want to use the old release (< 0.5) of the exporter, please follow the [old usage guide](https://github.com/KnugiHK/Whatsapp-Chat-Exporter/wiki/Old-Usage#usage)**. +> [!NOTE] +> Usage in README may be removed in the future. Check the usage in [Wiki](https://github.com/KnugiHK/Whatsapp-Chat-Exporter/wiki) +> +> If you want to use the old release (< 0.5) of the exporter, please follow the [old usage guide](https://github.com/KnugiHK/Whatsapp-Chat-Exporter/wiki/Old-Usage#usage). First, install the exporter by: ```shell @@ -44,7 +47,10 @@ In order to support the decryption, install pycryptodome if it is not installed pip install pycryptodome # Or pip install whatsapp-chat-exporter["android_backup"] # install along with this software ``` -### Crypt15 is now the easiest way to decrypt a backup. If you have the 32 bytes hex key generated when you enable End-to-End encrypted backup, you can use it to decrypt the backup. If you do not have the 32 bytes hex key, you can still use the key file extracted just like extacting key file for Crypt12 and Crypt14 to decrypt the backup. + +> [!TIP] +> Crypt15 is now the easiest way to decrypt a backup. If you have the 32 bytes hex key generated when you enable End-to-End encrypted backup, you can use it to decrypt the backup. If you do not have the 32 bytes hex key, you can still use the key file extracted just like extacting key file for Crypt12 and Crypt14 to decrypt the backup. + #### Crypt12 or Crypt14 You will need the decryption key file from your phone. If you have root access, you can find it as `/data/data/com.whatsapp/files/key`. Otherwise, if you used WhatsApp-Key-DB-Extractor before, it will appear in the WhatsApp backup directory as `WhatsApp/Databases/.nomedia`. @@ -87,7 +93,8 @@ Do an iPhone/iPad Backup with iTunes first. * iPhone backup on Windows: https://support.apple.com/HT212156 * iPad backup: https://support.apple.com/guide/ipad/ipad9a74df05xx/ipados ### Encrypted iOS/iPadOS Backup -**If you are working on unencrypted iOS/iPadOS backup, skip this** +> [!NOTE] +> If you are working on unencrypted iOS/iPadOS backup, skip this. If you want to work on an encrypted iOS/iPadOS Backup, you should install iphone_backup_decrypt from [KnugiHK/iphone_backup_decrypt](https://github.com/KnugiHK/iphone_backup_decrypt) before you run the extract_iphone_media.py. ```sh From 77c5a3e20c626c8d2cba12978e947b9c38815433 Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Fri, 20 Sep 2024 16:11:03 +0000 Subject: [PATCH 4/5] Update README.md --- README.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/README.md b/README.md index 1f446db..bff0ae8 100644 --- a/README.md +++ b/README.md @@ -88,7 +88,7 @@ wtsexporter -a -k 432435053b5204b08e5c3823423399aa30ff061435ab89bc4e6713969cdaa5 ``` ## Working with iOS/iPadOS (iPhone or iPad) -Do an iPhone/iPad Backup with iTunes first. +Do an iPhone/iPad Backup with iTunes/Finder first. * iPhone backup on Mac: https://support.apple.com/HT211229 * iPhone backup on Windows: https://support.apple.com/HT212156 * iPad backup: https://support.apple.com/guide/ipad/ipad9a74df05xx/ipados From 280a1186d8df60b99b0e51f5b93bca7ee857d531 Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Tue, 24 Sep 2024 15:37:27 +0000 Subject: [PATCH 5/5] Update README.md --- README.md | 4 +++- 1 file changed, 3 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index bff0ae8..c6070a9 100644 --- a/README.md +++ b/README.md @@ -188,6 +188,8 @@ This is a MIT licensed project. The Telegram Desktop's export is the reference for whatsapp.html in this repo. -bplist.py was released by Vladimir "Farcaller" Pouzanov under MIT license. +`bplist.py` was released by Vladimir "Farcaller" Pouzanov under MIT license. + +Please also refer to any files prefixed with `LICENSE` to obtain copies of the various licenses. WhatsApp Chat Exporter is not affiliated, associated, authorized, endorsed by, or in any way officially connected with the WhatsApp LLC, or any of its subsidiaries or its affiliates. The official WhatsApp LLC website can be found at https://www.whatsapp.com/.