TEXT2EMO – Text Emotion Detection Tool (Full Source Code)

TEXT2EMO is a modern Python desktop application for offline text emotion detection and sentiment screening. It analyzes written text and identifies the dominant emotional tone with an optional confidence score, all while remaining privacy-safe and fully local.

This repository contains the full source code, allowing you to customize the emotion engine, UI layout, confidence logic, or extend it with advanced NLP models.

---

🌟 SCREENSHOT

---

🌟 FEATURES

• 📝 Text Emotion Analysis — Detects the dominant emotional tone from user input

• 😊 Supported Emotions

• Happy

• Sad

• Angry

• Fear

• Surprise

• Neutral

• 📊 Confidence Scoring — Optional percentage-based confidence output

• ⚡ Fast & Offline — No internet connection or APIs required

• 🧵 Multithreaded Processing — Keeps the UI responsive during analysis

• 📈 Live Progress Bar — Visual feedback during processing

• 📜 Live Output Console — Step-by-step status updates

• 🎨 Modern Themed UI — Built with Tkinter + ttkbootstrap (Superhero theme)

• 🛑 Safe Stop Control — Stop button to interrupt processing

• 📘 Built-In Help Window — Usage instructions and developer info

• 🔒 Privacy-Safe — All processing happens locally

---

🚀 INSTALLATION

1. Clone or download this repository:

git clone https://github.com/rogers-cyber/TEXT2EMO.git cd TEXT2EMO

1. Install required Python packages:

pip install ttkbootstrap

(Tkinter is included with standard Python installations.)

1. Run the application:

python TEXT2EMO.py

1. Optional: Build a standalone executable using PyInstaller:

pyinstaller –onefile –windowed TEXT2EMO.py

---

💡 USAGE

Enter Text:

• Paste or type text into the Text Input field

Configure Settings:

• Enable or disable Confidence Score output

Analyze Text:

• Click ✅ Analyze Text
• Watch progress and live output

Stop Analysis:

• Click ⛔ Stop to interrupt processing

View Results:

• Detected emotion
• Optional confidence percentage

Help:

• Click ℹ Help for feature overview and usage tips

---

⚙️ CONFIGURATION OPTIONS

Option Description

---

Text Input User-provided text for analysis Show Confidence Score Toggle confidence percentage display Analyze Text Start emotion detection Stop Interrupt current analysis Progress Bar Visual processing indicator Live Output Status and results console Help Built-in instructions and info

---

📦 OUTPUT

• Detected Emotion — Dominant emotional category
• Confidence Score — Percentage confidence (optional)

---

📦 DEPENDENCIES

• Python 3.10+
• Tkinter — Standard Python GUI framework
• ttkbootstrap — Modern themed UI components
• Threading — Background processing
• OS / SYS / Time — Utility and runtime support

---

📝 NOTES

• Designed for fast sentiment screening
• Keyword-based emotion engine (easy to extend)
• Ideal for offline use, moderation tools, and demos
• Can be upgraded with ML / NLP libraries (e.g., spaCy, transformers)
• Fully portable when compiled as a standalone executable

---

👤 ABOUT

TEXT2EMO is developed and maintained by Mate Technologies, providing practical AI-powered desktop tools built with Python.

Website: https://matetools.gumroad.com

---

📜 LICENSE

Distributed as commercial source code. You may use it for personal or commercial projects. Redistribution, resale, or rebranding as a competing product is not allowed.