Emoogle Emoji Search Engine is an exceptional open-source tool designed for emoji enthusiasts, offering a straightforward and powerful way to discover and utilize emojis effortlessly. Built as the backbone of Emoogle, the premier emoji desktop application, this search engine serves as the ultimate resource for anyone looking to inject a bit of fun and expressiveness into their digital communication.

Key Features

• Extensive Emoji Keyword Database: Access the world's largest emoji keywords collection, boasting over 5,400 unique keywords for 1,872 emojis, all within a compact ~60kb bundle (gzipped).
• Advanced Ranking Algorithm: Benefit from a sophisticated ranking algorithm that applies more than 10 rules to ensure the most relevant emojis are shown first.
• Lightning-Fast Search: Experience an impressive search-as-you-type functionality, delivering results in about ~10ms on an Intel i7 and even faster on Apple M2.
• Customizable Search Experience: Personalize your search with options for custom keywords, favorites, and recently searched terms, catering to your specific emoji needs.
• Offline Capability: Use it seamlessly offline, without any dependencies.
• Module Availability: Compatible with both ES Module and CommonJS.
• Up-to-Date Emoji Support: Stay current with Emoji v15.1, ensuring access to the latest emojis.

Note: Currently, the search engine only supports English keywords.

How It Works

The Emoogle Emoji Search Engine operates on two main components: an extensive keyword database and an efficient ranking algorithm. When you input a query, the engine quickly identifies matching emojis and sorts them using its sophisticated ranking rules, all executed with impressive speed.

Keyword Database

The database's robust foundation stems from the Unicode's CLDR emoji keywords list, supplemented by a manual curation process that incorporates top-used English words to ensure everyday relevance.

Ranking Algorithm

The ranking algorithm sorts emoji results based on various essential rules, ensuring users receive the most pertinent options based on their searches. For example, an exact match will rank higher than a prefix match, and user preferences may take precedence over default rankings.

A detailed exploration of the ranking rules can be found in the repository and includes specific scenarios for clarity.

Usage Scenarios

Integrating Emoogle into your applications is straightforward. Here's how you can implement the emoji search in your code:

import { searchEmojis } from 'emoogle-emoji-search-engine';

// Basic example
searchEmojis('amazing');
// => ['🤩', '💯', '🙌', '🌈']

// Searching with limits
const maxLimit = 2;
searchEmojis('amazing', maxLimit);
// => ['🤩', '💯']

// Using custom keywords
const customEmojiKeywords = {
	'🏆': ['amazing'],
};
searchEmojis('amazing', undefined, { customEmojiKeywords });
// => ['🤩', '💯', '🙌', '🌈', '🏆']

Additionally, search functionalities can be adapted for best match scenarios or keyword database access, showcasing the tool's flexibility and robustness.

Contribution

Emoogle thrives on community input! If you notice any missing keywords in the emoji database, don't hesitate to contribute. Whether you're coding directly or adding keywords through a simple spreadsheet interface, your efforts will help enhance the Emoogle experience for everyone.

Discover more or access the demo at emoogle.org/emoji-search. Join us in making communication more vibrant and lively with emojis!