STXP 1.0.0
A tool to capture selected text and send via email
Requires Python: >=3.6

# Text Spy Changelog

## Version 1.1.0 - Debug Mode & English Interface

### ✨ New Features

#### Debug Mode
- Added `--debug` command line parameter
- All debug messages are now only shown in debug mode
- Silent operation in normal mode for better user experience

#### English Interface
- All user-facing messages converted to English
- Email content now uses English format
- Timestamp format changed to international standard (YYYY-MM-DD HH:MM)

#### Improved Exit Handling
- Multiple exit methods: Ctrl+Z, ESC, Ctrl+C
- Proper resource cleanup on exit
- Signal handling for graceful shutdown

### 🔧 Technical Improvements

#### Keyboard Monitoring
- Enhanced Ctrl+C detection for Windows systems
- Support for control characters (`\x03`, `\x1a`)
- Better handling of left/right Ctrl keys

#### Error Handling
- Comprehensive try-catch blocks
- Debug-only error messages
- Graceful failure handling

#### Configuration Management
- Silent configuration loading in normal mode
- Debug output for configuration issues
- Better validation and error reporting

### 📝 Code Changes

#### Main Class (`STXP`)
- Added `debug` parameter to constructor
- All print statements wrapped with debug checks
- Improved method documentation in English

#### Command Line Interface
- Added `--debug` parameter support
- Updated help text to English
- Better parameter parsing

#### Email Functionality
- English email templates
- International timestamp format
- Debug-only success/error messages

### 🚀 Usage Examples

#### Normal Mode (Silent)
```bash
STXP
```
- Runs silently in background
- No console output
- Perfect for production use

#### Debug Mode (Verbose)
```bash
STXP --debug
```
- Shows detailed operation information
- Displays keyboard events
- Shows clipboard changes
- Reports email sending status

#### Configuration
```bash
STXP --config
```
- Interactive configuration setup
- English prompts and messages
- Clear setup instructions

### 🔍 Debug Output Examples

When running in debug mode, you'll see:
```
Text Spy started, listening for Ctrl+C...
Press Ctrl+Z to stop listening
Test: Press Ctrl+C to test functionality
Ctrl key pressed
Ctrl+C combination detected!
New text detected: This is some selected text...
[2024-01-15 14:30] Text successfully sent to user@example.com
Ctrl+Z detected, exiting program...
Listener stopped
```

### 📋 File Structure Updates

```
text_spy/
├── main.py              # Main program (updated with debug mode)
├── debug_test.py        # Debug mode testing script
├── test_spy.py          # General functionality tests
├── setup.py             # Package configuration
├── requirements.txt     # Dependencies
├── README.md           # Updated documentation
├── INSTALL.md          # Updated installation guide
├── CHANGELOG.md        # This file
├── LICENSE             # License file
└── MANIFEST.in         # Package manifest
```

### 🐛 Bug Fixes

- Fixed Ctrl+Z exit detection
- Improved Windows keyboard monitoring
- Better error handling for network issues
- Fixed configuration file loading issues

### 🔄 Migration Notes

#### From Version 1.0.0
- All Chinese messages are now in English
- Debug mode is now required to see operation details
- Email timestamps use international format
- Exit behavior is more reliable

#### Configuration Files
- Existing configuration files remain compatible
- No migration required for user settings
- Debug mode can be enabled without reconfiguration
---

**Note**: This version maintains full backward compatibility while adding significant improvements to usability and debugging capabilities.