Emoji & Slang Message Translator

🔗 Created by David Sopas
🔗 Live Application: https://msgdecode.com

A simple web app that helps parents, educators, or anyone decode hidden meanings in messages containing emojis and slang. Built to raise awareness about potentially inappropriate or risky content often found in teen messaging, this tool translates emojis, emoji combos, and text slang into plain English.

---

🚀 Features

• ✅ Translates individual emojis and emoji combinations (e.g. 👉👌)
• ✅ Detects and decodes modern slang and chat acronyms (e.g. DTF, Netflix and chill)
• ✅ Works entirely client-side — no data is saved or sent
• ✅ Multi-language support
• ✅ Mobile-friendly responsive design
• ✅ Lightweight, fast, and easy to use

---

💻 How to Use

1. Paste or type a message into the text box (e.g. from a chat or SMS).
2. Click the Translate button.
3. The app will display the interpreted meaning of emojis and slang.

You also have a button below Translate called Export which opens an HTML page with all emojis. This could be useful for printing or taking a look on all emojis support by this application.

---

📸 Screenshots

Here’s a quick look at the Emoji & Slang Message Translator in action:

---

🛠️ Installation (for local use or customization)

git clone https://github.com/dsopas/emoji-translator.git
cd emoji-translator
python3 -m http.server 8000 

---

🌍 How to Contribute a New Language

We welcome contributions to make this project accessible in more languages! To add a new translation:

1. Create a New UI Translation File
   • Copy lang/en.json
   • Rename it using the ISO language code (eg: fr.json, de.json)
   • Translate the values, keep the keys the same.
2. Translate emoji and slang dictionaries
   • dictionaries/emoji_en.json → dictionaries/emoji_es.json
   • dictionaries/slang_en.json → dictionaries/slang_es.json
   • dictionaries/combos_en.json → dictionaries/combos_es.json
   • Translate only the values, not the emoji or slang keys.
3. Submit a Pull Request
   • Fork this repo
   • Add your new files under lang/ and dictionaries/
   • Open a Pull Request with a short description

We’ll review and merge it!

---

📄 License

This project is licensed under the MIT License. Please see DISCLAIMER for intended use and legal notice and our Code of Conduct.

---

🙌 Acknowledgments

Inspired by resources from GetKidas, PSP, Netflix TV-show Adolescence and other digital safety initiatives. Thanks to the community for continued contributions and improvements.

---

👋 Want to Contribute?

Pull requests are welcome! Feel free to open issues to suggest features, emoji/slang additions, or bug fixes.