about summary refs log tree commit diff
diff options
context:
space:
mode:
authorRory& <root@rory.gay>2025-05-08 23:49:14 +0200
committerRory& <root@rory.gay>2025-05-08 23:49:14 +0200
commitb280d6fc78c81dd82934cab3b902edf348610973 (patch)
treebd83177b4acdf9a047015cd162127d0ae28dd298
parentSwitch to msc4222 (diff)
downloadMatrixAntiDmSpam-b280d6fc78c81dd82934cab3b902edf348610973.tar.xz
Update readme
-rw-r--r--README.MD23
1 files changed, 22 insertions, 1 deletions
diff --git a/README.MD b/README.MD

index 5492c58..49d0531 100644 --- a/README.MD +++ b/README.MD
@@ -5,10 +5,26 @@ A project to make invite spam more manageable at scale. [Matrix room](https://matrix.to/#/%23anti-dm-spam%3Arory.gay?via=rory.gay) ## Dependencies + - `dotnet-sdk 9.0.200+` - A device that is online a lot of the time, can be a server ## Setup + +```shell +# Check out the repository + submodules +git clone --recursive https://cgit.rory.gay/matrix/tools/MatrixAntiDmSpam.git + +# Build and install +./install.sh + +# Install or update services to make sure the bot starts up with your system +./install-user-services.sh +``` + +<details> + <summary>Manual setup</summary> + ```shell # Check out the repository + submodules git clone --recursive https://cgit.rory.gay/matrix/tools/MatrixAntiDmSpam.git @@ -33,15 +49,20 @@ Additionally, you want to copy `appsettings.Development.json` into your working Additionally: you can use `appsettings.SomethingHere.json` and use `DOTNET_ENVIRONMENT=SomethingHere` if you want to set this up for multiple accounts. `appsettings.json` is always loaded for shared values. Alternatively, you can use environment variables like `LibMatrixBot__AccessTokenPath=/path/to/access-token` to override values in the configuration file, using double undercores (`__`) as path separator. + +</details> + </details> Note that `PolicyLists` refers to special rooms known as Policy List rooms, which are commonly used by moderation bots as Mjolnir and Draupnir. The default value (Community Moderation Effort) is a policy list that is used by a fairly large number of communities, and is a good starting point. Additionally, Element Web supports these for hiding messages via a labs flag. -Also note that these may break certain clients, such as FluffyChat ([#814](https://github.com/krille-chan/fluffychat/issues/814), [#858](https://github.com/krille-chan/fluffychat/issues/858), [#905](https://github.com/krille-chan/fluffychat/issues/905)). +Also note that these may break certain clients, such as +FluffyChat ([#814](https://github.com/krille-chan/fluffychat/issues/814), [#858](https://github.com/krille-chan/fluffychat/issues/858), [#905](https://github.com/krille-chan/fluffychat/issues/905)). ## Running + ```shell # Run the bot cd ~/.local/share/MatrixAntiDmSpam