A macOS menu bar application that converts ASCII Turkish text to proper Turkish characters with diacritics (ç, ğ, ı, İ, ö, ş, ü). Perfect for Turkish speakers living abroad using English keyboards.

• ⚡ Global Hotkey: Convert selected text anywhere with ⌥⌘T
• 🔤 Menu Bar Integration: Lightweight, always-accessible interface
• 📝 Real-time Conversion: Type and see results instantly
• 📋 Smart Clipboard: Auto-copy converted text
• 🚀 High Performance: Pattern-based algorithm with 13,462 contextual rules

# Clone the repository
git clone https://github.com/armish/TurkishDeasciifier.git
cd TurkishDeasciifier

# Build the application
./build_direct.sh

# Run the app
./TurkishDeasciifier

1. Menu Bar Access: Click the "tü" icon in your menu bar
2. Global Hotkey: Select any text and press ⌥⌘T to convert instantly
3. Manual Conversion: Type in the app window for real-time conversion

• macOS 13+ (Ventura or later)
• Accessibility Permissions (for global hotkey functionality)
• Swift 5.8+ (for building from source)

./build_direct.sh

swift build -c release
# Output: .build/release/TurkishDeasciifier

cd Sources
swiftc -o ../TurkishDeasciifier \
    TurkishDeasciifierApp.swift \
    ContentView.swift \
    TurkishDeasciifier.swift \
    -framework SwiftUI \
    -framework AppKit \
    -framework Carbon \
    -O

1. Run the app for the first time
2. Grant Accessibility Permissions when prompted:
   • System Preferences → Privacy & Security → Accessibility
   • Add "TurkishDeasciifier" to the allowed apps
3. Restart the app to enable global hotkey

# Build the application
./build_direct.sh

# Test accuracy
swift Tests/accuracy_test.swift

• 13,462 patterns for contextual character conversion
• Bidirectional context analysis (10 characters each direction)
• Ranking system for pattern confidence
• Special handling for Turkish capitalization rules

• 100% accuracy on comprehensive test corpus
• Matches Python implementation character-by-character
• Real-world tested with Turkish news articles and literature

If you encounter Xcode Command Line Tools issues:

# Use the direct build method instead
./build_direct.sh

If global hotkey doesn't work:

1. Check Accessibility permissions in System Preferences
2. Remove and re-add the app if needed
3. Restart the application

If conversion accuracy is low:

1. Ensure Sources/turkish_patterns.json exists
2. Check file permissions (chmod 644 Sources/turkish_patterns.json)
3. Verify file size is ~175KB

Edit TurkishDeasciifierApp.swift line 110:

// Change key code 17 ('T') to desired key
if event.modifierFlags.contains([.command, .option]) && event.keyCode == 17 {

Edit TurkishDeasciifier.swift line 7:

private let turkishContextSize = 10  // Characters to analyze around target

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Add tests for new functionality
4. Ensure 100% accuracy is maintained (swift Tests/accuracy_test.swift)
5. Commit your changes (git commit -m 'Add amazing feature')
6. Push to the branch (git push origin feature/amazing-feature)
7. Submit a pull request

MIT License - see LICENSE file for details.

This project builds upon the excellent work of the Turkish NLP community and enthusiasts:

• deasciifier by Mustafa Emre Acer
• deasciify by Deniz Yuret
• turkish-deasciifier by Emre Sevinc

Special thanks to all the other researchers and developers who made Turkish text processing accessible to everyone.

• Issues: Report bugs and feature requests via GitHub Issues
• Accuracy Problems: Include sample text and expected output
• Build Problems: Specify macOS version and Xcode setup
• Discussions: Join conversations on GitHub Discussions

Made with ❤️ for the Turkish community worldwide 🇹🇷