From 1b774b11acb802b33f751a52bdd44e3588419bf3 Mon Sep 17 00:00:00 2001
From: Tulir Asokan <tulir@maunium.net>
Date: Sun, 27 Aug 2023 13:11:31 +0300
Subject: [PATCH] Add readme to manualdecrypt

[skip ci]
---
 libgm/manualdecrypt/README.md | 14 ++++++++++++++
 1 file changed, 14 insertions(+)
 create mode 100644 libgm/manualdecrypt/README.md

diff --git a/libgm/manualdecrypt/README.md b/libgm/manualdecrypt/README.md
new file mode 100644
index 0000000..0ccb8f6
--- /dev/null
+++ b/libgm/manualdecrypt/README.md
@@ -0,0 +1,14 @@
+# manualdecrypt
+This tool can be used to inspect requests that the messages.google.com/web app sends
+
+0. Install [Go](https://go.dev/dl/) 1.20 or higher and `protoc`
+   (`sudo apt install protobuf-compiler` on Debian).
+1. Clone this repository (`git clone https://github.com/mautrix/gmessages.git`).
+2. Enter this directory (`cd libgm/manualdecrypt`) and compile it (`go build`).
+3. Run `./manualdecrypt`
+   * On first run, it'll ask for `pr_crypto_msg_enc_key` and `pr_crypto_msg_hmac`
+     from the localStorage of the messages for web app.
+4. Find the relevant `SendMessage` HTTP request in browser devtools and copy
+   the entire raw request body (a bunch of nested JSON arrays).
+5. Paste the request body into manualdecrypt, then press Ctrl+D on a blank line
+   to tell it to parse the pasted data.