2020-05-12 00:43:03 -04:00
2023-07-07 11:24:11 -04:00
# Matrix Moderation Tool
2020-05-12 00:43:03 -04:00
This is a script i wrote to make moderating a Synapse server easier.
Contact me at: @PC -Admin:perthchat.org if you get stuck or have an edit in mind.
***
## Licensing
2023-07-01 15:23:16 -04:00
This work is published under the MIT license, for more information on this license see here: https://opensource.org/license/mit/
2020-05-12 00:43:03 -04:00
***
## Setup script
You can hard code the server URL, federation port and access token for faster use, it will prompt you for these values if you don't.
2020-09-22 09:23:04 -04:00
Your access token can be found in Element > Settings > Help & About, your user account must first be upgraded to a server admin.
2020-05-12 00:43:03 -04:00
***
## Upgrade user to 'server admin'
https://github.com/matrix-org/synapse/tree/master/docs/admin_api
“So first connect to the correct db and then run the UPDATE users...”
$ sudo -i -u postgres
$ psql synapse
synapse=# UPDATE users SET admin=1 WHERE name='@PC-Admin:perthchat.org';
UPDATE 1
synapse=#
‘ ’ ‘ ’
It means you didn't type a complete SQL query yet.
You need a semicolon to terminate the command.
***
## Make sure /_synapse/ is mapped
A few of the commands will not work unless /_synapse/ is mapped to port 8008. Here is a example for nginx:
```
location /_matrix {
proxy_pass http://127.0.0.1:8008;
proxy_set_header X-Forwarded-For $remote_addr;
}
location /_synapse {
proxy_pass http://127.0.0.1:8008;
proxy_set_header X-Forwarded-For $remote_addr;
}
```
2020-06-01 04:21:16 -04:00
You can also run the script locally on your server if you do not wish to map /_synapse/.
2023-07-01 15:23:16 -04:00
***
## rdlist Functionality
'rdlist' is a comprehensive list of child abuse related rooms on Matrix, it's a safety initiative led by the [Legion of Janitors ](https://matrix.to/#/#janitors:glowers.club ).
This script can automatically load and block/purge abusive rooms from rdlist, making it **very easy** for inexperienced administrators to block this harmful content.
2023-07-04 09:44:03 -04:00
To get started, just dm me at [@michael:perthchat.org ](https://matrix.to/#/@michael:perthchat.org ) and I can invite you to the 'Legion of Janitors' room.
2023-07-01 15:23:16 -04:00
2023-07-04 09:44:03 -04:00
Once you have read access to the [rdlist repository ](https://code.glowers.club/loj/rdlist ), simply run this moderation script like so:
2023-07-01 15:23:16 -04:00
```
$ python3 modtool.py
Please select one of the following options:
...
#### rdlist ####
30) Block all rooms with specific rdlist tags.
('q' or 'e') Exit.
30
Cloning rdlist repo...
Cloning into 'rdlist'...
Username for 'https://code.glowers.club': PC-Admin
Password for 'https://PC-Admin@code.glowers.club':
remote: Enumerating objects: 563, done.
remote: Counting objects: 100% (563/563), done.
remote: Compressing objects: 100% (556/556), done.
remote: Total 563 (delta 355), reused 0 (delta 0), pack-reused 0
Receiving objects: 100% (563/563), 5.47 MiB | 800.00 KiB/s, done.
Resolving deltas: 100% (355/355), done.
Printing details about the current tags in rdlist:
# Tags
### Greedy Tags
*Rooms with these tags may not exist to host such content, however do not remove it.*
Tag|Description
-|-
[`csam`][csam] | Child Sexual Abuse Material
[`cfm`][cfm] | An abundance of content which would directly appeal to those seeking csam.
[`jailbait`][jailbait] | Photos which contain underage individuals in questionable or suggestive situations.
[`tfm`][tfm] | An abundance of content which would directly appeal to those seeking jailbait.
`beastiality` | Self explanatory.
`3d_loli` | Pornography which depicts photorealistic underage characters.
`stylized_3d_loli` | Pornography which depicts underage characters that are not depicted in a realistic style.
`gore` | Self explanatory.
`snuff` | Self explanatory.
### Topic Tags
*Tags here describe the room or the room's characteristics.*
Tag|Description
-|-
`degen_misc` | Other types of coomers rooms.
`degen_larp` | Coomer larp rooms.
`degen_meet` | Coomer socializing rooms.
`degen_porn` | Rooms dedicated to pornography, excluding types which have dedicated tags.
`bot_porn` | Rooms which contain bots that spam pornographic content.
`bot_spam` | Rooms which contain bots that spam content. Primarily for malvertising and cryptospam
`preban` | Rooms which may not contain tagged content, however have clear intent. i.e: Rooms with names like "CP Room", "Child Porn", etc
`hub_room_trade` | Rooms which exist solely to trade illegal or questionable content. i.e: csam, jailbait
`hub_room_sussy` | A room which is sussy. This tag does not have a solid definition, see existing tagged rooms
`abandoned` | Similar to `anarchy` , primarily for rooms which have automated spam bots.
`anarchy` | Unmoderated rooms.
`hub_room_underage` | Rooms which contain a disproportionate amount of underage users.
`hub_room_links` | Rooms which exist to share links to other rooms.
`toddlercon` | Lolicon but younger.
`loli` | Rooms which exist to host lolicon.
[csam]: https://en.wikipedia.org/wiki/Child_pornography 'Child Sexual Abuse Material. COPAINE >=2'
[cfm]: https://en.wikipedia.org/wiki/Child_erotica 'Child Fetish Material'
[jailbait]: https://en.wikipedia.org/wiki/Jailbait_images 'Jailbait'
[tfm]: about:blank 'Teen Fetish Material'
[wp:copaine-scale]: https://en.wikipedia.org/wiki/COPINE_scale 'COPINE scale - Wikipedia'
Please enter a space seperated list of tags you wish to block:
2023-07-02 04:11:04 -04:00
hub_room_links preban degen_misc beastiality degen_porn gore hub_room_trade snuff degen_larp hub_room_sussy bot_spam cfm 3d_loli jailbait bot_porn toddlercon loli csam tfm anarchy abandoned degen_meet stylized_3d_loli
2023-07-01 15:23:16 -04:00
Tag: csam
Room IDs: [***REDACTED***]
Tag: 3d_loli
Room IDs: [***REDACTED***]
Tag: jailbait
Room IDs: [***REDACTED***]
Tag: toddlercon
Room IDs: [***REDACTED***]
Tag: loli
Room IDs: [***REDACTED***]
...
Do you want to block/purge all these rooms? y/n? y
Please enter the local username that will create a 'muted violation room' for your users (Example: michael): mod_team
Please enter the room name of the muted violation room your users will be sent to: POLICY VIOLATION
Please enter the shutdown message that will be displayed to users: THIS ROOM HAS BEEN SHUTDOWN AS IT VIOLATES PERTHCHAT.ORG POLICIES!
Do you want to purge these rooms? (This deletes all the room history from your database.) y/n? y
Do you want to block these rooms? (This prevents your server users re-entering the room.) y/n? y
Number of rooms being shutdown: 320
Are you sure you want to shutdown these rooms? y/n? y
curl -kXGET 'https://matrix.perthchat.org/_synapse/admin/v1/rooms/!***REDACTED***:matrix.org/state?access_token=***REDACTED***' > ./!***REDACTED***:matrix.org_state_1688238203.json
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 50 0 50 0 0 891 0 --:--:-- --:--:-- --:--:-- 892
Exported room state events to file, this data can be useful for profiling a room after you've blocked/purged it: ./state_events!***REDACTED***:matrix.org_state_1688238203.json
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 226 0 32 100 194 341 2069 --:--:-- --:--:-- --:--:-- 2430
% Total % Received % Xferd Average Speed Time Time Time Current
Dload Upload Total Spent Left Speed
100 318 0 318 0 0 7095 0 --:--:-- --:--:-- --:--:-- 7227
status: complete
!***REDACTED***:matrix.org has been successfully shutdown!
```
2023-07-02 04:11:04 -04:00
Note that this script before shutting these rooms down will save the state events to the "./state_events" folder, this data is important for law enforcement. Please collect these files and send them back to the [Legion of Janitors ](https://matrix.to/#/#janitors:glowers.club ) for collection and analysis.
