From 09162bf522ce227a694257b3bc2ca6c67e69bb7b Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Mon, 20 Oct 2025 05:55:09 +0000 Subject: [PATCH 1/8] Update README with usage notes and Android link Added note about providing link for Android export instructions. --- README.md | 2 ++ 1 file changed, 2 insertions(+) diff --git a/README.md b/README.md index 7094437..937dde4 100644 --- a/README.md +++ b/README.md @@ -17,6 +17,8 @@ To contribute, see the [Contributing Guidelines](https://github.com/KnugiHK/What > [!NOTE] > Usage in README may be removed in the future. Check the usage in [Wiki](https://github.com/KnugiHK/Whatsapp-Chat-Exporter/wiki) +> +> Click [here](https://github.com/KnugiHK/WhatsApp-Chat-Exporter/wiki/Android-Usage#crypt15-end-to-end-encrypted-backup) for the most trivia way for exporting from Android First, install the exporter by: ```shell From 1d5bad92a7fbc29880d6da75e3cd1746107cc8a2 Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Fri, 7 Nov 2025 13:13:14 +0000 Subject: [PATCH 2/8] Add new IV and DB entry to utility.py Reported by @silasjelley --- Whatsapp_Chat_Exporter/utility.py | 1 + 1 file changed, 1 insertion(+) diff --git a/Whatsapp_Chat_Exporter/utility.py b/Whatsapp_Chat_Exporter/utility.py index 6d9fd36..16e927f 100644 --- a/Whatsapp_Chat_Exporter/utility.py +++ b/Whatsapp_Chat_Exporter/utility.py @@ -365,6 +365,7 @@ CRYPT14_OFFSETS = ( {"iv": 67, "db": 193}, {"iv": 67, "db": 194}, {"iv": 67, "db": 158}, + {"iv": 67, "db": 196} ) From f6442f9d73949ada48df2bf31840053d78f3ad17 Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Sun, 14 Dec 2025 09:20:41 +0000 Subject: [PATCH 3/8] Update Nuitka installation in CI workflow Removed specific version for Nuitka installation. --- .github/workflows/compile-binary.yml | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/.github/workflows/compile-binary.yml b/.github/workflows/compile-binary.yml index 48e459d..466fc64 100644 --- a/.github/workflows/compile-binary.yml +++ b/.github/workflows/compile-binary.yml @@ -20,7 +20,7 @@ jobs: - name: Install dependencies run: | python -m pip install --upgrade pip - pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka==2.6.7 + pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka pip install . - name: Build binary with Nuitka run: | @@ -45,7 +45,7 @@ jobs: - name: Install dependencies run: | python -m pip install --upgrade pip - pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka==2.6.7 + pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka pip install . - name: Build binary with Nuitka run: | @@ -69,7 +69,7 @@ jobs: - name: Install dependencies run: | python -m pip install --upgrade pip - pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka==2.6.7 + pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka pip install . - name: Build binary with Nuitka run: | From fa629503f7272bb717f2b210373d84c6c9f675ee Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Sun, 14 Dec 2025 09:43:50 +0000 Subject: [PATCH 4/8] Update Nuitka version and build commands in workflow --- .github/workflows/compile-binary.yml | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/.github/workflows/compile-binary.yml b/.github/workflows/compile-binary.yml index 466fc64..2a09440 100644 --- a/.github/workflows/compile-binary.yml +++ b/.github/workflows/compile-binary.yml @@ -20,13 +20,13 @@ jobs: - name: Install dependencies run: | python -m pip install --upgrade pip - pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka + pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka==2.8.9 pip install . - name: Build binary with Nuitka run: | - python -m nuitka --no-deployment-flag=self-execution --onefile \ + python -m nuitka --onefile \ --include-data-file=./Whatsapp_Chat_Exporter/whatsapp.html=./Whatsapp_Chat_Exporter/whatsapp.html \ - --assume-yes-for-downloads --follow-imports Whatsapp_Chat_Exporter/__main__.py --output-filename=wtsexporter_linux_x64 + --assume-yes-for-downloads Whatsapp_Chat_Exporter --output-filename=wtsexporter_linux_x64 sha256sum wtsexporter_linux_x64 - uses: actions/upload-artifact@v4 with: @@ -45,11 +45,11 @@ jobs: - name: Install dependencies run: | python -m pip install --upgrade pip - pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka + pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka==2.8.9 pip install . - name: Build binary with Nuitka run: | - python -m nuitka --no-deployment-flag=self-execution --onefile --include-data-file=./Whatsapp_Chat_Exporter/whatsapp.html=./Whatsapp_Chat_Exporter/whatsapp.html --assume-yes-for-downloads --follow-imports Whatsapp_Chat_Exporter\__main__.py --output-filename=wtsexporter + python -m nuitka --onefile --include-data-file=./Whatsapp_Chat_Exporter/whatsapp.html=./Whatsapp_Chat_Exporter/whatsapp.html --assume-yes-for-downloads Whatsapp_Chat_Exporter --output-filename=wtsexporter copy wtsexporter.exe wtsexporter_x64.exe Get-FileHash wtsexporter_x64.exe - uses: actions/upload-artifact@v4 @@ -69,13 +69,13 @@ jobs: - name: Install dependencies run: | python -m pip install --upgrade pip - pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka + pip install pycryptodome vobject javaobj-py3 ordered-set zstandard nuitka==2.8.9 pip install . - name: Build binary with Nuitka run: | - python -m nuitka --no-deployment-flag=self-execution --onefile \ + python -m nuitka --onefile \ --include-data-file=./Whatsapp_Chat_Exporter/whatsapp.html=./Whatsapp_Chat_Exporter/whatsapp.html \ - --assume-yes-for-downloads --follow-imports Whatsapp_Chat_Exporter/__main__.py --output-filename=wtsexporter_macos_x64 + --assume-yes-for-downloads Whatsapp_Chat_Exporter --output-filename=wtsexporter_macos_x64 shasum -a 256 wtsexporter_macos_x64 - uses: actions/upload-artifact@v4 with: From 75720c6d0a6c3afbda8e4705bc21c208ba0b10d6 Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Sun, 14 Dec 2025 17:08:49 +0000 Subject: [PATCH 5/8] Upgrade GitHub Actions to use version 6 --- .github/workflows/compile-binary.yml | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/.github/workflows/compile-binary.yml b/.github/workflows/compile-binary.yml index 2a09440..04532bf 100644 --- a/.github/workflows/compile-binary.yml +++ b/.github/workflows/compile-binary.yml @@ -12,9 +12,9 @@ jobs: linux: runs-on: ubuntu-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: '3.13' - name: Install dependencies @@ -28,7 +28,7 @@ jobs: --include-data-file=./Whatsapp_Chat_Exporter/whatsapp.html=./Whatsapp_Chat_Exporter/whatsapp.html \ --assume-yes-for-downloads Whatsapp_Chat_Exporter --output-filename=wtsexporter_linux_x64 sha256sum wtsexporter_linux_x64 - - uses: actions/upload-artifact@v4 + - uses: actions/upload-artifact@v6 with: name: binary-linux path: | @@ -37,9 +37,9 @@ jobs: windows: runs-on: windows-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: '3.13' - name: Install dependencies @@ -52,7 +52,7 @@ jobs: python -m nuitka --onefile --include-data-file=./Whatsapp_Chat_Exporter/whatsapp.html=./Whatsapp_Chat_Exporter/whatsapp.html --assume-yes-for-downloads Whatsapp_Chat_Exporter --output-filename=wtsexporter copy wtsexporter.exe wtsexporter_x64.exe Get-FileHash wtsexporter_x64.exe - - uses: actions/upload-artifact@v4 + - uses: actions/upload-artifact@v6 with: name: binary-windows path: | @@ -61,9 +61,9 @@ jobs: macos: runs-on: macos-latest steps: - - uses: actions/checkout@v4 + - uses: actions/checkout@v6 - name: Set up Python - uses: actions/setup-python@v5 + uses: actions/setup-python@v6 with: python-version: '3.13' - name: Install dependencies @@ -77,7 +77,7 @@ jobs: --include-data-file=./Whatsapp_Chat_Exporter/whatsapp.html=./Whatsapp_Chat_Exporter/whatsapp.html \ --assume-yes-for-downloads Whatsapp_Chat_Exporter --output-filename=wtsexporter_macos_x64 shasum -a 256 wtsexporter_macos_x64 - - uses: actions/upload-artifact@v4 + - uses: actions/upload-artifact@v6 with: name: binary-macos path: | From 71ca2935570802dca3f87a380729fdaedb69f295 Mon Sep 17 00:00:00 2001 From: KnugiHK <24708955+KnugiHK@users.noreply.github.com> Date: Mon, 15 Dec 2025 01:12:04 +0800 Subject: [PATCH 6/8] Add main entry point Added a main entry point in __main__.py to allow running the exporter as a script. Required for standalone binary --- Whatsapp_Chat_Exporter/__main__.py | 5 ++++- 1 file changed, 4 insertions(+), 1 deletion(-) diff --git a/Whatsapp_Chat_Exporter/__main__.py b/Whatsapp_Chat_Exporter/__main__.py index bf130be..b9a8578 100644 --- a/Whatsapp_Chat_Exporter/__main__.py +++ b/Whatsapp_Chat_Exporter/__main__.py @@ -730,4 +730,7 @@ def main(): # Handle media directory handle_media_directory(args) - print("Everything is done!") \ No newline at end of file + print("Everything is done!") + +if __name__ == "__main__": + main() From dffce977de65f86226cec358dc25efbd59465eec Mon Sep 17 00:00:00 2001 From: KnugiHK <24708955+KnugiHK@users.noreply.github.com> Date: Mon, 15 Dec 2025 01:12:14 +0800 Subject: [PATCH 7/8] Bump version to 0.12.1 --- README.md | 2 +- pyproject.toml | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 937dde4..226e8e9 100644 --- a/README.md +++ b/README.md @@ -243,7 +243,7 @@ Miscellaneous: --max-bruteforce-worker MAX_BRUTEFORCE_WORKER Specify the maximum number of worker for bruteforce decryption. -WhatsApp Chat Exporter: 0.12.0 Licensed with MIT. See https://wts.knugi.dev/docs?dest=osl for all open source +WhatsApp Chat Exporter: 0.12.1 Licensed with MIT. See https://wts.knugi.dev/docs?dest=osl for all open source licenses. ``` diff --git a/pyproject.toml b/pyproject.toml index 0027184..f5931d4 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -4,7 +4,7 @@ build-backend = "setuptools.build_meta" [project] name = "whatsapp-chat-exporter" -version = "0.12.0" +version = "0.12.1" description = "A Whatsapp database parser that provides history of your Whatsapp conversations in HTML and JSON. Android, iOS, iPadOS, Crypt12, Crypt14, Crypt15 supported." readme = "README.md" authors = [ From ea60f878becd3671f5a974fb53e7ff430362168b Mon Sep 17 00:00:00 2001 From: Knugi <24708955+KnugiHK@users.noreply.github.com> Date: Mon, 15 Dec 2025 14:53:39 +0000 Subject: [PATCH 8/8] Upgrade CodeQL action versions to v4 --- .github/workflows/codeql.yml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/.github/workflows/codeql.yml b/.github/workflows/codeql.yml index 7468264..f2c3ce8 100644 --- a/.github/workflows/codeql.yml +++ b/.github/workflows/codeql.yml @@ -67,7 +67,7 @@ jobs: # Initializes the CodeQL tools for scanning. - name: Initialize CodeQL - uses: github/codeql-action/init@v3 + uses: github/codeql-action/init@v4 with: languages: ${{ matrix.language }} build-mode: ${{ matrix.build-mode }} @@ -95,6 +95,6 @@ jobs: exit 1 - name: Perform CodeQL Analysis - uses: github/codeql-action/analyze@v3 + uses: github/codeql-action/analyze@v4 with: category: "/language:${{matrix.language}}"