Transflow

Real-time translation while you type. Seamless. Invisible. Magical.

Features • Demo • Installation • Usage • Configuration • Contributing

---

Why Transflow?

Ever wished you could just type in your native language and have it magically appear in another language? No copy-paste. No switching apps. No interrupting your flow.

Transflow lives in your menu bar and watches what you type. When you pause, it translates. When you continue typing, it waits. It's like having a translator that reads your mind.

Features

• 🌊 Flow-Based Translation — Translates when you stop typing, not before
• ⚡ Zero Friction — Works in any text field, any app, system-wide
• 🔄 Smart Fallback — Multiple translation providers ensure reliability
• 🌍 10 Languages — English, 中文, 日本語, 한국어, Français, Deutsch, Español, Italiano, Português, Русский
• ⌨️ Hotkey Control — Cancel, confirm, or undo with keyboard shortcuts
• 💫 Elegant Indicator — Minimal floating animation shows translation status
• 🎛️ Fully Configurable — Adjust timing, hotkeys, and behavior
• 🔒 Privacy First — No data stored, no accounts required
• 🪶 Lightweight — Native Swift, minimal resource usage

Demo

💡 Tip: The floating indicator shows the current status with subtle animations.

Installation

Download (Recommended)

1. Download the latest Transflow.dmg from Releases
2. Open the DMG and drag Transflow to Applications
3. Launch Transflow from Applications
4. Grant Accessibility permission when prompted

Build from Source

# Clone the repository
git clone https://github.com/TryAwesome/Transflow.git

# Open in Xcode
cd Transflow
open Transflow.xcodeproj

# Build and run (⌘R)

Usage

Quick Start

1. Launch Transflow — it appears in your menu bar
2. Type in any text field in any app
3. Pause for a moment — Transflow translates automatically
4. Continue typing or use hotkeys to control

Hotkeys

Action	Default Hotkey	Description
Cancel	Esc	Cancel current translation, keep original text
Confirm	Enter	Confirm translation immediately
Undo	⌘Z	Revert to original text after translation

Menu Bar

Click the Transflow icon in the menu bar to:

• ✅ Enable/disable translation
• 🌐 Change target language
• ⚙️ Open settings
• ℹ️ View about info

Configuration

Access Settings from the menu bar or use ⌘,

General

Setting	Description	Default
Target Language	Language to translate into	English
Idle Threshold	Wait time before translating (ms)	800
Confirm Threshold	Time before auto-confirm (ms)	2000
Launch at Login	Start Transflow on system boot	Off

Shortcuts

All hotkeys are customizable in Settings. Click a shortcut field and press your desired key combination.

Supported Languages

Language	Code	Native Name
English	en	English
Chinese	zh	中文
Japanese	ja	日本語
Korean	ko	한국어
French	fr	Français
German	de	Deutsch
Spanish	es	Español
Italian	it	Italiano
Portuguese	pt	Português
Russian	ru	Русский

Requirements

• macOS 14.0 (Sonoma) or later
• Accessibility Permission — Required for system-wide text monitoring

How It Works

┌─────────────────────────────────────────────────────────────┐
│                        Transflow                            │
├─────────────────────────────────────────────────────────────┤
│                                                             │
│   ┌─────────┐    ┌─────────┐    ┌─────────┐    ┌─────────┐ │
│   │Observer │───▶│  State  │───▶│ Engine  │───▶│Committer│ │
│   │         │    │ Manager │    │         │    │         │ │
│   └─────────┘    └─────────┘    └─────────┘    └─────────┘ │
│        │              │              │              │       │
│   Focus Track    Phase Control   Translate     Write Text  │
│   Text Watch     Version Mgmt    Fallback      Safety Guard│
│   Idle Detect                    Provider                  │
│                                                             │
└─────────────────────────────────────────────────────────────┘

Contributing

Contributions are welcome! Whether it's bug reports, feature requests, or code contributions, we appreciate your help in making Transflow better.

How to Contribute

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

Ideas for Contributions

• 🌐 Add more language support
• 🎨 UI/UX improvements
• 🐛 Bug fixes and performance optimizations
• 📝 Documentation improvements
• 🧪 Test coverage

Development Setup

# Clone your fork
git clone https://github.com/YOUR_USERNAME/Transflow.git
cd Transflow

# Open in Xcode
open Transflow.xcodeproj

# Make your changes and test

Support the Project

If Transflow has been helpful to you, consider supporting its development!

ETH / BTC / USDT
0x63aA7972242d86E91dd9c587BddF6cc4f4716A67

Your support helps me dedicate more time to maintaining and improving Transflow. Thank you! 🙏

License

This project is licensed under the MIT License — see the LICENSE file for details.

Author

Haosen Shi
haocean.shi@gmail.com

---

Made with ❤️ for seamless multilingual communication

⭐ Star this repo if you find it useful!