You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
mewmew 7d781306d7 Add 'README.md' 1 week ago
README.md Add 'README.md' 1 week ago
matrix-emotes.py update to new mxc 2 weeks ago

README.md

matrix-emoji-upload

This is a script to easily upload emoji packs to Matrix rooms for MSC2545.

usage: matrix-emotes.py [-h] -l DIRECTORY [-n NAME] [-d TEXT] [-c IMAGE] -i INSTANCE -t TOKEN -r ROOMID

required options:

-i is the domain of the homeserver you use, for example matrix.blob.cat
-t is your user-token. currently login is not supported, so grab the token using inspect-element on your Element client
-r is the ID (not alias) of the room. if you use bash make sure you escape the ! like \! or it won't work and you won't be able to use the up-arrow to edit the command because... bash
-l is the directory where the emojis are. if there are non-emoji files in said directory, they'll be uploaded too, so be careful :p

optional options:

-n is the name of the pack (used for state_key). highly recommended to specify this
-d is the description of the pack. recommended to specify this, defaults to name if not set
-c is the cover-image of the pack. specify the location on the filesystem (using an emoji name won't work)

Warning: If uploading without a packname, you'll overwrite previously-uploaded emojis without a packname in the same room. If uploading with a packname, you'll overwrite the previous emoji pack with that packname.

Feel free to contact the maintainer @mewmew:blob.cat on Matrix, or join the Matrix room for the project #matrix-emoji-upload:blob.cat (there are lots of emojis there, uwu!).