projects / omakaomoji / README.md

omakaomoji

Fast native Japanese kaomoji picker & emoticon search for Omarchy — (◕‿◕)

01README

🌸 Kaomoji (omakaomoji)

A fast, lightweight, and native Japanese Kaomoji & Emoticon picker for Omarchy.

¯\_(ツ)_/¯ (。♥‿♥。) (╯°□°)╯︵ ┻━┻ ʕっ•ᴥ•ʔっ ( ͡° ͜ʖ ͡°)

Kaomoji Preview


✨ Features

  • ⚡ 0ms In-Memory Search: Embedded JavaScript search engine with zero process spawning overhead.
  • 🔍 Fuzzy Subsequence Matching: Type shorthand abbreviations (e.g. tbl $\rightarrow$ (╯°□°)╯︵ ┻━┻ TableFlip, shrg $\rightarrow$ ¯\_(ツ)_/¯).
  • 🔠 Multi-Keyword Matching: Narrow down expressions with space-separated terms (e.g. bear hug $\rightarrow$ ʕっ•ᴥ•ʔっ, sad cry $\rightarrow$ (╥﹏╥)).
  • 🏷️ Category Quick Filters: Interactive pill tabs for Happy, Love, Bear, Cat, TableFlip, Shrug, Cool, Wave, Sad, Angry, and Music.
  • ↵ Auto-Paste & Copy: Selecting a kaomoji automatically types it straight into your active application/chat via wtype and copies it to clipboard (wl-copy).
  • 🎨 100% Native Omarchy Theme Integration: Uses Omarchy's menu color tokens and surface borders — automatically matches Turbonite, Catppuccin, Nord, Everforest, Tokyo Night, and custom themes.
  • ⌨️ Keyboard-First Control: Smooth arrow navigation ( ), PageUp/PageDown, Enter to insert, and Esc to clear/dismiss.

📦 Installation

Install directly with the Omarchy plugin manager:

omarchy plugin add https://github.com/JoeJoeflyn/omakaomoji.git --enable

⌨️ Hyprland Keybinding

Add this to your ~/.config/hypr/hyprland.conf to summon the kaomoji picker with a hotkey (e.g. Super + Alt + K):

bind = SUPER ALT, K, exec, omarchy-shell shell toggle omakaomoji

🚀 Omarchy Menu Integration (Super + Space)

Kaomoji automatically integrates into your Omarchy menu upon install! Press Super + Space $\rightarrow$ Trigger $\rightarrow$ Kaomoji or search kaomoji / emoticon directly from the launcher.


🗑️ Removal

omarchy plugin remove omakaomoji

📜 License

MIT License © 2026 JoeJoeflyn

02Stats

0
stars
0
forks
QML
language
Aug 23, 2026
last push

03Repository

omakaomoji

omakaomoji — Nguyen Thai Tai | Nguyen Thai Tai