Add README and goosehints

README.md

@@ -0,0 +1,30 @@
+# Google Cookie Retrieval
+
+This is a simple Selenium script used to quickly run through the [Mautrix Google Chat Authentication Process](https://docs.mau.fi/bridges/python/googlechat/authentication.html).
+
+It was written primarily with [goose](https://github.com/block/goose) (honk!).
+
+## The goal: Automate this
+1. Open a private chat with the bridge bot. Usually @googlechatbot:your.server.
+    - If the bot doesn't accept the invite, see the troubleshooting page
+
+1. Open https://chat.google.com in a private browser window and log in normally, then extract cookies:
+    1. Press F12 to open developer tools.
+    1. select the "Application" (Chrome) or "Storage" (Firefox) tab.
+    1. In the sidebar, expand "Cookies" and select https://chat.google.com.
+    1. In the cookie list, find the COMPASS, SSID, SID, OSID and HSID rows.
+        - When using Firefox, you may have multiple COMPASS cookies with different paths. Pick the one where path is /.
+    1. Form a JSON object with the extracted cookies. It should look something like this (field names are case-insensitive):
+    ```json
+    {
+      "compass": "dynamite-ui=...",
+      "ssid": "...",
+      "sid": "...",
+      "osid": "...",
+      "hsid": "..."
+    }
+    ```
+    1. Close the browser window to prevent the cookies being invalidated (Google uses refresh tokens, so you need to close the window within a few minutes).
+1. Send login-cookie {the json object} to the bot.
+
+Recent chats should now get portals automatically. Other chats will get portals as you receive messages.