mojeeio / mojee

Lightning fast Emoji library for .NET & TypeScript

title	icon
Welcome	home

Welcome to Mojee 🤪

What is Mojee?

Mojee is a lightning ⚡ fast Emoji library for .NET.

Mojee's big party trick is the ultra-high-performance parse and replacement of emoji :short-codes: within a block of text. Pass a string of text to Mojee, and Mojee will convert valid emoji :short-codes: into emoji characters. Here's a basic Mojee Replace sample:

// Replace all shortcodes with an emoji
var result = Mojee.Replace("Hello, world :smile:");

Console.WriteLine(result);

The console output from the above sample would be:

Hello, world 😄

Mojee is also amazing at Emoji search. Search for any term and Mojee will hand back a collection of emoji results. The following sample demonstrates a basic emoji search.

// Search for emojis
Mojee.Search("smile").ToList()
     .ForEach(emoji => Console.Write(emoji));

The console output from the above sample would be:

😄 😸 😃 😺 😅

Getting Started

Within seconds, Mojee can be added to any .NET Core project using the NuGet package, or search for Mojee from within the NuGet Package Manager in Visual Studio.

+++ dotnet CLI

dotnet add package Mojee

+++ NuGet CLI

Install-Package Mojee

+++

The following sequence of commands could be used to create a new .NET Console project using the dotnet CLI, add Mojee to the project, and finally open the new project in Visual Studio Code.

mkdir MojeeDemo          # Make a new folder
cd MojeeDemo             # Move into the new folder
dotnet new console       # Create a new .NET Console app
dotnet add package Mojee # Add Mojee to your new project
code .                   # Open in Visual Studio Code

The MojeeIO API is now available within your app. The following sample demonstrates a basic Console app scenario with Mojee.

using System;
using MojeeIO;

namespace MojeeDemo
{
    class Program
    {
        static void Main(string[] args)
        {
            // Replace all shortcodes with an emoji
            var result = Mojee.Replace("Hello, world :+1:");

            Console.WriteLine(result);
            Console.ReadKey();
        }
    }
}

API Docs

Mojee Class

Replace static method

The static method Mojee.Replace will replace all emoji shortcodes in a string with Unicode emoji characters.

string Mojee.Replace(string text)

Argument	Type	Description
text	string	The input text to perform the replacement on.

Returns a new string with all matched :short-codes: replaced.

Example

var result = Mojee.Replace("Hello, world :smile:");

Console.WriteLine(result);

The Replace method also has a handy overload where an EmojiMatch evaluator can be passed. Each matched :short-code: found by Mojee is passed to the evaluator for custom processing.

string Mojee.Replace(string text, Func<EmojiMatch, string> evaluator)

Argument	Type	Description
text	string	The input text to perform the replacement on.
evaluator	Func<EmojiMatch, string>	The function evaluating a replacement string based on the matched Emoji. Returning null keeps the original capture as is.

Returns a new string with all matched :short-codes: replaced with the result from the evaluator.

A basic use-case for the evaluator would be logging each emoji match. In the following sample, we keep a simple count of the emoji shortcode matches that occur within a string.

Example

static void Main(string[] args)
{
    var count = 0;

    var result = Mojee.Replace(":+1: Hello, world :smile:", match =>
    {
        count++;

        // Any custom processing of the
        // emoji match can happen here.

        // Return the Emoji character
        return match.Emoji.Character;
    });

    Console.WriteLine($"Count: {count}");
    Console.WriteLine(result);

    Console.ReadKey();
}

The console output from the above sample would be:

Count: 2
👍 Hello, world 😄

Search static method

Search for emojis.

Search by any Shortcode substring ("cat"), or by an exact Emoji Shortcode (":smile:"), or if a Shortcode startsWith (":smi").

IEnumerable<Emoji> Mojee.Search(string query)

Argument	Type	Description
query	string	Any substring, exact Emoji Shortcode, or a Shortcode starting with.

Returns the matched Emoji instances as an IEnumerable<Emoji>.

Example

var result = Mojee.Search("smile");

result.ToList().ForEach(emoji =>
{
    Console.WriteLine($"{emoji}: {emoji.Shortcode}");
});

The console output from the above sample would be:

😄: :smile:
😃: :smiley:
😅: :sweat_smile:
😋: :yum:
😁: :grin:
😊: :blush:
😆: :laughing:
😍: :heart_eyes:
😈: :smiling_imp:
😻: :heart_eyes_cat:

EmojiMatch Class

Property	Type	Description
Emoji	Emoji	The captured Emoji. readonly
Index	int	The position in the original string where the first character of the captured Emoji is found. readonly
Length	int	Gets the length of the Emoji capture. readonly
Type	MatchType	The match type - specifies what Emoji identifier was captured. readonly

MatchType Enum

Property	Description
Shortcode	An Emoji was captured by Shortcode

Emoji Class

Represents a single Emoji instance.

Property	Type	Description
Id	string	A unique identifier based on the unicode code point value.
Shortcode	string	The unique short name for this Emoji (e.g. :smile:).
Aliases	IReadOnlyList<string>	A list of Shortcode alias names.
Character	string	The unicode code point value for this Emoji.
UnicodeChars	char[]	Characters of the Character string.
Emoticon	string?	The emoticon string pattern for this Emoji.
Description	string?	A basic description of this Emoji or related keywords.
Tags	IReadOnlyList<string>	A list of tags related to this Emoji.
Order	int	The order of this Emoji within the collection of Emojis.
Category	Category	The Emoji Category.

Get static method

Example

var emoji = Emoji.Get("smile");
Console.Write($"{emoji.Shortcode}: {emoji}");
// smile: 😄

GetAll static method

Gets the list of all supported Emojis.

IReadOnlyList<Emoji> Emoji.GetAll()

Example

// Get the first 5 emojis
var emojis = Emoji.GetAll()
    .Take(5)
    .ToList();

// Iterate through the list of emojis
emojis.ForEach(emoji =>
{
    // Write the emojis to the Console
    Console.WriteLine(emoji);
});

The console output from the above sample would be:

😀
😃
😄
😁
😆

TryGet static method

Tries to get an Emoji object based on the supplied shortcode. See also Emoji.Get(string).

bool Emoji.TryGet(string shortcode, out Emoji emoji)

Argument	Type	Description
shortcode	string	A Shortcode. Colons are optional (both values are valid: ":smile:" and "smile").
out	Emoji	The found Emoji or null.

Example

var matched = Emoji.TryGet("smile", out var emoji);

Console.WriteLine($"Found something? {matched}");
Console.WriteLine(emoji);

The console output from the above sample would be:

Found something? True
Emoji: 😄

Licensing

Mojee is free to use in both open-source and commercial applications, although with support for a limited set of emojis unless a license key is purchased.

The 100 most popular emojis used on Twitter are supported for free, which covers approximately 4 out of every 5 emojis tweeted. The following table documents the 100 emojis currently supported in the free (no license key) version of Mojee. With each new release, Mojee will be updated with the latest 100 most popular emojis used on Twitter.

😀	😃	😄	😁	😆	😅	😂	😉	😊	😇
😍	😘	☺️	😚	😋	😛	😜	😝	😐	😑
😶	😏	😒	😬	😌	😔	😪	😴	😷	😎
😕	😳	😥	😢	😭	😱	😖	😣	😞	😓
😩	😫	😤	😡	😠	😈	💀	😻	🙈	🙊
💋	💘	💖	💗	💓	💞	💕	💔	❤️	💛
💚	💙	💜	💯	💥	👋	✋	👌	✌️	👈
👉	👇	👍	👊	👏	🙌	🙏	💪	👀	💁
🌸	🌹	🌚	☀️	⭐	⚡	🔥	✨	🎉	♥️
👑	🎶	📷	➡️	⬅️	▶️	♻️	✅	✔️	🔴

Please see the License Key Configuration guide for instructions on how to add your Mojee License key to a project.

Purchasing a Pro or Team license key will unlock the full power of Mojee with support for all 1743 emojis.

mojee's Issues

New Mojee.Match static method and overload

The new Mojee.Match static method and overloads enables the easy querying of the input text for list of Emoji Match instances that match emoji shortcodes or emoji characters or both.

Signatures

IEnumberable<Match> Mojee.Match(string text)
IEnumberable<Match> Mojee.Match(string text, MatchType filter)

By default, Mojee.Match will return all MatchType.Shortcode and MatchType.Character matches. The Match results can be narrowed by passing a MatchType as the second argument.

Usage

// Return a collection of all emoji shortcode and character matches from the input string
var list1 = Mojee.Match(text);

// Return a collection of all emoji shortcode matches from the input string
var list2 = Mojee.Match(text, MatchType.Shortcode);