|
1 | | -# Maunium sticker picker |
2 | | -A fast and simple Matrix sticker picker widget. Tested on Element Web, Android & iOS. |
3 | | - |
4 | | -## Discussion |
5 | | -Matrix room: [`#stickerpicker:maunium.net`](https://matrix.to/#/#stickerpicker:maunium.net) |
6 | | - |
7 | | -## Instructions |
8 | | -For setup and usage instructions, please visit the [wiki](https://github.com/maunium/stickerpicker/wiki): |
9 | | - |
10 | | -* [Creating packs](https://github.com/maunium/stickerpicker/wiki/Creating-packs) |
11 | | -* [Enabling the widget](https://github.com/maunium/stickerpicker/wiki/Enabling-the-widget) |
12 | | -* [Hosting on GitHub pages](https://github.com/maunium/stickerpicker/wiki/Hosting-on-GitHub-pages) |
13 | | - |
14 | | -If you prefer video tutorials, [Brodie Robertson](https://www.youtube.com/c/BrodieRobertson) has made a great video on setting up the picker and creating some packs: https://youtu.be/Yz3H6KJTEI0. |
15 | | - |
16 | | -## Comparison with other sticker pickers |
17 | | - |
18 | | -* Scalar is the default integration manager in Element, which can't be self-hosted and only supports predefined sticker packs. |
19 | | -* [Dimension](https://github.com/turt2live/matrix-dimension) is an alternate integration manager. It can be self-hosted, but it's more difficult than Maunium sticker picker. |
20 | | -* 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. |
21 | | - |
22 | | -| Feature | Scalar | Dimension | Maunium sticker picker | |
23 | | -|---------------------------------|--------|-----------|------------------------| |
24 | | -| Free software | ❌ | ✔️ | ✔️ | |
25 | | -| Custom sticker packs | ❌ | ✔️ | ✔️ | |
26 | | -| Telegram import | ❌ | ✔️ | ✔️ | |
27 | | -| Works on Element mobiles | ✔️ | ❌ | ✔️ | |
28 | | -| Easy multi-user setup | ✔️ | ✔️ | ❌<sup>[#7][#7]</sup> | |
29 | | -| Frequently used stickers at top | ❌ | ❌ | ✔️ | |
30 | | - |
31 | | -[#7]: https://github.com/maunium/stickerpicker/issues/7 |
32 | | - |
33 | | -## Preview |
34 | | -### Element Web |
35 | | - |
36 | | - |
37 | | -### Element Android |
38 | | - |
39 | | - |
40 | | -### Element iOS (dark theme) |
41 | | - |
| 1 | +# Sanae's collection of Matrix sticker packs |
| 2 | + |
| 3 | +> [Preview address](https://matrix-stickers.pages.dev/) |
| 4 | +
|
| 5 | +## How to use this? |
| 6 | + |
| 7 | +This picker only supports Element (Web, Electron, Android, iOS) clients as well as clients based on it. |
| 8 | + |
| 9 | +Type `/devtools` in any chat window of your Element (web or desktop) and send it, a Developer Tools window will open, select Explore account data, find m.widgets in it and add the following to the "content": |
| 10 | + |
| 11 | +``` |
| 12 | +{ |
| 13 | + "stickerpicker": { |
| 14 | + "content": { |
| 15 | + "type": "m.stickerpicker", |
| 16 | + "url": "https://matrix-stickers.pages.dev/?theme=$theme", |
| 17 | + "name": "Stickerpicker", |
| 18 | + "creatorUserId": "@you:matrix.server.name", |
| 19 | + "data": {} |
| 20 | + }, |
| 21 | + "sender": "@you:matrix.server.name", |
| 22 | + "state_key": "stickerpicker", |
| 23 | + "type": "m.widget", |
| 24 | + "id": "stickerpicker" |
| 25 | + } |
| 26 | +} |
| 27 | +``` |
| 28 | + |
| 29 | +If m.widgets is not found, select Send custom account data event directly in the bottom right corner, select m.widgets for the event type and fill in: |
| 30 | + |
| 31 | + |
| 32 | +``` |
| 33 | +{ |
| 34 | + "type": "m.widgets", |
| 35 | + "content": { |
| 36 | + "stickerpicker": { |
| 37 | + "content": { |
| 38 | + "type": "m.stickerpicker", |
| 39 | + "url": "https://matrix-stickers.pages.dev/?theme=$theme", |
| 40 | + "name": "Stickerpicker", |
| 41 | + "data": {} |
| 42 | + }, |
| 43 | + "sender": "@you:matrix.server.name", |
| 44 | + "state_key": "stickerpicker", |
| 45 | + "type": "m.widget", |
| 46 | + "id": "stickerpicker" |
| 47 | + } |
| 48 | + } |
| 49 | +} |
| 50 | +``` |
| 51 | +The same account should only need to be set up once. |
| 52 | + |
| 53 | +## I'd like to add other stickers! |
| 54 | + |
| 55 | +You can fork this repository and follow the [Wiki](https://github.com/maunium/stickerpicker/wiki/Creating-packs) prompts to import new stickers.The repository welcomes new sticker requests, so please initiate Pull Requests (from A to Z) by sorting the links to the original sticker pack. |
| 56 | + |
| 57 | +Note: The repository does not accept stickers that contain explicit pornographic content. |
0 commit comments