# LangToLang

Convert text between keyboard layouts with a hotkey - for macOS

## 🎯 What It Does

Ever typed in the wrong keyboard layout? LangToLang fixes it instantly!

- Type text in wrong layout → Press **Ctrl+Shift+Space** → Text converts automatically
- Works in **any app**: TextEdit, Slack, Figma, Mail, Notes, Pages, and more
- **100% local** - no internet, no logging, complete privacy

**Example:**
```
You type: יקממם (Hebrew keyboard, but thinking in English)
Press: Ctrl+Shift+Space
Result: hello ✨
```

---

## ✨ Features

- ⌨️ **Smart Conversion**: English ↔ Hebrew (more languages coming)
- 🔥 **Global Hotkey**: Works everywhere
- 📊 **Statistics**: Track your conversions
- 🔄 **Auto-Switch**: Keyboard switches to converted language
- 🚫 **App Blacklist**: Disable in specific apps
- 🎨 **Menu Bar App**: Clean, non-intrusive
- 🔒 **Privacy First**: All processing happens locally

---

## 📥 Installation

### For Users

1. Download the latest release from [Releases](../../releases)
2. Unzip and drag **LangToLang.app** to Applications
3. Open the app (right-click → Open first time)
4. Grant Accessibility permission when prompted
5. Done! Look for the icon in your menu bar

### For Developers

```bash
git clone https://github.com/yourusername/LangToLang.git
cd LangToLang
open LangToLang.xcodeproj
```

Requirements:
- macOS 13.0+ (Ventura or later)
- Xcode 15.0+
- KeyboardShortcuts package (auto-installed)

---

## 🚀 Usage

1. **Type text** in any app (even if keyboard is "wrong")
2. **Select the text** (or just place cursor at end of line)
3. **Press Ctrl+Shift+Space**
4. **Text converts** instantly! ✨

### Keyboard Shortcut

Default: **Ctrl+Shift+Space**

Change it: Menu bar icon → Preferences → Global Hotkey

---

## 📊 Statistics

Track your productivity:
- Conversions per day/week/month/year
- Language-specific breakdowns
- Character count

Access: Menu bar icon → Statistics

---

## ⚙️ Preferences

- **Keyboards**: Select which layouts to convert between
- **Hotkey**: Customize the global shortcut
- **Auto-Switch**: Toggle automatic keyboard switching
- **Blacklist**: Disable in specific apps
- **Start at Login**: Launch automatically

---

## 🔒 Privacy

- ✅ **All processing happens on your Mac**
- ✅ **No internet connection required**
- ✅ **No data collection or logging**
- ✅ **Open source code** - audit it yourself!

---

## 🛠️ Supported Languages

**Current (v1.5.0):**
- English ↔ Hebrew

**Coming Soon:**
- Russian ↔ English
- Arabic ↔ English
- Spanish ↔ English
- Your suggestion? [Open an issue](../../issues)!

---

## 📱 System Requirements

- macOS 13.0 (Ventura) or later
- Accessibility permission (app guides you through this)

---

## 🐛 Troubleshooting

### Hotkey doesn't work
1. Check Accessibility permission: System Settings → Privacy & Security → Accessibility
2. Make sure LangToLang is enabled
3. Check if app is enabled (menu bar icon → should say "Disable")

### Can't convert in certain apps
- Some apps (like password managers) may be blacklisted
- Check: Preferences → App Blacklist

### Text not recognized
- Currently supports English & Hebrew only
- More languages coming in future updates

[Full troubleshooting guide](./TROUBLESHOOTING.md)

---

## 🤝 Contributing

Contributions welcome! Please:

1. Fork the repo
2. Create a feature branch (`git checkout -b feature/AmazingFeature`)
3. Commit changes (`git commit -m 'Add some AmazingFeature'`)
4. Push to branch (`git push origin feature/AmazingFeature`)
5. Open a Pull Request

### Adding New Languages

See [CONTRIBUTING.md](./CONTRIBUTING.md) for language mapping templates.

---

## 📝 Changelog

### v1.5.0 (February 2026) - Early Adopter Edition
- ✨ NEW: Conversion statistics with language breakdowns
- ✨ NEW: Visual feedback when app is disabled
- ✨ NEW: App blacklist functionality
- ✨ NEW: Feedback form
- ✨ NEW: About window with Early Adopter badge
- 🎨 IMPROVED: Reorganized menu structure
- 🎨 IMPROVED: Better multi-line text handling
- 🐛 FIX: Capital letters now convert properly

### v1.0.0 (February 2026)
- 🎉 Initial release
- ⌨️ English ↔ Hebrew conversion
- 🔥 Global hotkey support
- 📋 Clipboard fallback
- 🔄 Auto-switch keyboard

[Full changelog](./CHANGELOG.md)

---

## 📜 License

Copyright © 2026 Ronen Berliner

All rights reserved. This software is provided for personal use only.

### Third-Party Libraries

- [KeyboardShortcuts](https://github.com/sindresorhus/KeyboardShortcuts) by Sindre Sorhus (MIT License)

---

## 🌟 Early Adopters

Using v1.x? You're an **Early Adopter** - thank you!  
You get **free access forever**, even when we introduce premium features.

---

## 💬 Feedback & Support

- 🐛 **Bug Reports**: [Open an issue](../../issues)
- ✨ **Feature Requests**: [Open an issue](../../issues)
- 💬 **Questions**: Use the in-app feedback form
- 📧 **Email**: Available in app

---

## 🙏 Credits

Created by **Ronen Berliner**

Inspired by the Windows LangOver app, rebuilt for macOS with love.

---

**Made with ❤️ for multilingual typers everywhere**
