Custom emoji
In addition to the standard emoji your phone offers, you can also use custom emoji — image-based emoji like :pepe-happy: or :blob-dance: that other people on Nostr have created and shared.
Custom emoji work in chat messages, reactions, and profile bios. The same emoji you bookmark on Shosho also work on other Nostr clients that support them (Amethyst, Damus, others).
How it works
Custom emoji on Nostr are organised into sets. A set is a collection of emoji — usually around a theme — published by someone on Nostr. You don’t add emoji one by one; you bookmark a whole set, and every emoji in that set becomes available to you.
Once you’ve bookmarked a set, you can type its shortcodes (:emoji-name:) in any message or reaction and Shosho will render the emoji image inline.
Discover and add a set
The easiest place to browse custom emoji sets is emojito.meme , a Nostr app for creating and discovering emoji sets.
To add a set:
- Open the set’s page on emojito.meme.
- Sign in with the same Nostr profile you use on Shosho.
- Bookmark the set.
Behind the scenes, this updates your Nostr profile’s emoji list. The next time Shosho fetches your profile, the new emoji are available.
If you want to add a set without using emojito.meme, see the developer docs for custom emoji — the underlying mechanism is a single Nostr event you can publish from any client.
Use an emoji in chat
Type : and the chat panel will bring up your custom emoji picker.
Then either select your custom emoji, or continue typing the shortcode and your message.
:pepe-happy: that was a great point!Shosho replaces the shortcode with the image when the message renders.
You can also add a custom emoji as a reaction to someone else’s message — same syntax, available from the reactions menu on any chat message.