Skip to content

A fast Matrix sticker picker widget with our stickers

License

Notifications You must be signed in to change notification settings

hackerspace-ntnu/matrix-stickers

 
 

Repository files navigation

Maunium sticker picker

A fast and simple Matrix sticker picker widget. Tested on Element Web, Android & iOS.

Hackerspace How-to

First make sure you have python 3.6 or later installed. Then run the following commands:

pip install .

Now you can put the stickers in a pack in the packs directory. You can either use the hackerspace pack or create your own. Remember to add the number of the sticker in the starts of the file name. It should look liks this 01-name.png. You can use either png or jpg files.

Then to install the pack run the following command:

sticker-pack packs/<pack directory> --add-to-index web/packs/

For example:

sticker-pack packs/hackerspace --add-to-index web/packs/

When you push the repo the pack will be deployed to be used by the Hackerspace Matrix.

Discussion

Matrix room: #stickerpicker:maunium.net

Instructions

For setup and usage instructions, please visit the wiki:

If you prefer video tutorials, Brodie Robertson has made a great video on setting up the picker and creating some packs: https://youtu.be/Yz3H6KJTEI0.

Comparison with other sticker pickers

  • Scalar is the default integration manager in Element, which can't be self-hosted and only supports predefined sticker packs.
  • Dimension is an alternate integration manager. It can be self-hosted, but it's more difficult than Maunium sticker picker.
  • Maunium sticker picker is just a sticker picker rather than a full integration manager. It's much simpler than integration managers, but currently has to be set up manually per-user.
Feature Scalar Dimension Maunium sticker picker
Free software ✔️ ✔️
Custom sticker packs ✔️ ✔️
Telegram import ✔️ ✔️
Works on Element mobiles ✔️ ✔️
Easy multi-user setup ✔️ ✔️ #7
Frequently used stickers at top ✔️

Preview

Element Web

Element Web

Element Android

Element Android

Element iOS (dark theme)

Element iOS

About

A fast Matrix sticker picker widget with our stickers

Resources

License

Stars

Watchers

Forks

Languages

  • JavaScript 42.3%
  • Python 39.3%
  • Sass 11.5%
  • Go 4.5%
  • HTML 1.7%
  • Dockerfile 0.7%