AkkomaGang/akkoma
AkkomaGang
/
akkoma
12
63
Fork 83
Code Issues 171 Pull Requests 13 Packages Projects 2 Releases 13 Wiki Activity

Add docs about emoji stealing
ci/woodpecker/pr/woodpecker Pipeline is pending Details

This commit is contained in:
timorl 2022-12-11 11:36:43 +01:00
parent 77e9a52450
commit fa9c7eae56
No known key found for this signature in database
GPG Key ID: B2AEA8339A71AB99
1 changed files with 26 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

26
docs/docs/configuration/custom_emoji.md
View File

@ -67,3 +67,29 @@ Priority of tags assigns in emoji.txt and custom.txt:
Priority for globs:
`special group setting in config.exs > default setting in config.exs`
## Stealing emoji
Managing your emoji can be hard work, and you just want to have the cool emoji your friends use? As usual, crime comes to the rescue!
You can use the `Pleroma.Web.ActivityPub.MRF.StealEmojiPolicy` Message Rewrite Facility to automatically add to your instance emoji that massages from specific servers contain. Note that this happens on message processing, so the emoji will be added only after your instance receives some interaction containing emoji _after_ configuring this.
To activate this you have to configure it in your configuration file (`prod.secret.exs` or `dev.secret.exs`). For example if you wanted to steal from `coolemoji.space` and `spiceenthusiasts.biz` any emoji that is not related to cinnamon and not larger than about 10K you would add the following:
```elixir
config :pleroma, :mrf,
policies: [
Pleroma.Web.ActivityPub.MRF.StealEmojiPolicy
]
config :pleroma, :mrf_steal_emoji,
hosts: [
"coolemoji.space",
"spiceenthusiasts.biz"
],
rejected_shortcodes: [
".*cinnamon.*"
],
size_limit: 10000
```
Note that this _might_ actually be illegal in some ways, due to emoji pack licensing. It's extremely unlikely that anyone will care, but keep this in mind for when Nintendo starts their own instance.