cynic/redact-matrix
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Script that redacts (erases) every message in a room.
30 Commits 1 Branch 0 Tags 677 KiB
Python 100%
e6bc359392
Go to file
cynic e6bc359392 Update README.md
2024-07-12 03:18:31 -05:00
.gitignore Initial commit 2024-06-01 11:31:32 -05:00
element_room_id.png Upload files to "/" 2024-06-01 15:59:39 -05:00
element.png Upload files to "/" 2024-06-01 15:38:26 -05:00
image.jpg Upload files to "/" 2024-06-01 11:34:59 -05:00
LICENSE Initial commit 2024-06-01 11:31:32 -05:00
README.md Update README.md 2024-07-12 03:18:31 -05:00
redact_all_messages.py parse arguments 2024-07-12 02:30:45 -05:00

README.md

Redact Matrix

Small script that redacts (deletes) every message written by the user in specified room(s).

Usage

Installation

Download the script:

git clone https://git.thisisjoes.site/cynic/redact-matrix.git
cd redact-matrix
chmod +x redact_matrix.py  # optional

Getting your access token

On Cinny, for example, go to Firefox's Inspect tool, to the Storage tab, and copy your cinny_access_token.

image

Other clients may have a similar key with this value.

On Element it is found at: ⚙️ Quick settings > All Settings > Help & About > Advanced > Access Token

image

The token is different for each session and remains valid as long as you don't log out.

Getting the room id

On Cinny we can see this value in the source of sent messages.

The room id looks like this: !cdPNSVToruMtXqGznY:domain.tld

On Element it can be found at ℹ️ Room info > Settings > Advanced > Internal room ID

image

Running the script

python redact_matrix.py -s matrix.thisisjoes.site -t syt_uaY3lMW_nAyiumHhGDhXJBFLKdoY_3RRBuz \!xTDdCBHByVyZtZEmNI:hackliberty.org '!cdPNSVToruMtXqGznY:domain.tld'

As we can see here, it is possible to apply the command to more than one room.

Additionally, by adding the -n flag after redact_matrix.py the Nuke mode is turned on, which means that you will not be deleting only your own messages but also those of other users in the room, as long as you have permissions (e.g. admin). In other words, it attempts to nuke the room, so, please, be very careful with this flag.

When in doubt, see the help by passing --help or -h:

# python redact_matrix.py --help
usage: redact_matrix.py [-h] [-n] -s HOMESERVER -t ACCESS_TOKEN [room_ids ...]

positional arguments:
  room_ids              room ID's

options:
  -h, --help            show this help message and exit
  -n, --nuke            try and delete all messages in the room, not only mine

required:
  -s HOMESERVER, --homeserver HOMESERVER
                        homeserver's domain name
  -t ACCESS_TOKEN, --access-token ACCESS_TOKEN
                        Matrix access token

Note:

Once it has deleted all of your messages it may remove the room itself, if you had permissions to do so.