Metadata-Version: 2.4
Name: termimoji
Version: 1.0.0
Summary: Lightning-fast terminal emoji search & copy tool
Author-email: YaBoom <yaboom@example.com>
License-Expression: MIT
Keywords: emoji,terminal,cli,copy,search
Classifier: Development Status :: 4 - Beta
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Requires-Python: >=3.10
Description-Content-Type: text/markdown
License-File: LICENSE
Provides-Extra: dev
Requires-Dist: pytest; extra == "dev"
Requires-Dist: black; extra == "dev"
Requires-Dist: mypy; extra == "dev"
Dynamic: license-file

# 🔍 TermiMoji

<p align="center">
  <img src="https://img.shields.io/pypi/v/termimoji?style=flat&color=FF69B4" alt="PyPI">
  <img src="https://img.shields.io/pypi/pyversions/termimoji" alt="Python">
  <img src="https://img.shields.io/github/license/YaBoom/termimoji" alt="License">
</p>

> A lightning-fast terminal emoji search & copy tool with fuzzy matching. Never struggle finding the perfect emoji again! ✨

## ✨ Features

- 🚀 **Lightning Fast** - Instant fuzzy search across 3000+ emojis
- 🎯 **Smart Fuzzy Matching** - Find emojis even with typos
- 📋 **One-Click Copy** - Auto-copy to clipboard with zero friction
- 🎨 **Rich Categories** - Search by keywords, emotions, or activities
- 🌙 **Dark Mode** - Beautiful default theme for terminal
- ⚡ **Zero Dependencies** - Pure Python, no bloat

## 📦 Installation

```bash
# Via pip
pip install termimoji

# Via uv (faster)
uv add termimoji
```

## 🎮 Usage

```bash
# Interactive search mode
termimoji

# Quick search from command line
termimoji "party"
termimoji "fire" --copy
termimoji "cat" --limit 5
```

### Interactive Mode

```
🔍 Search: love
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
❤️  red_heart     love      hearts    love_letter
💕  two_hearts    sparkling_heart  heart_eyes
💖  growing_heart  heart_with_arrow
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
↑↓ Navigate  Enter Copy  Esc Quit
```

## 🧩 Example Searches

| Query | Results |
|-------|---------|
| `party` | 🎉 🎊 🥳 🎈 |
| `fire` | 🔥 🚒 🧨 💥 |
| `cat` | 🐱 😺 😸 😹 |
| `coffee` | ☕ 🫖 🥤 🍵 |
| `money` | 💰 💵 💴 💶 |

## 🛠️ Configuration

Create `~/.termimoji/config.json`:

```json
{
  "limit": 10,
  "auto_copy": true,
  "theme": "dark",
  "categories": ["smileys", "animals", "food"]
}
```

## 📋 Requirements

- Python 3.10+
- pip / uv

## 🤝 Contributing

Contributions are welcome! Feel free to:
- Report bugs
- Suggest new features
- Submit PRs

## 📜 License

MIT License - See [LICENSE](LICENSE) for details.

---

<p align="center">Made with ❤️ for terminal lovers</p>
