✨ Rephraser

Rephrase any selected text, anywhere on your computer, instantly.

Select text in any app, hit a hotkey, and Rephraser turns it into a polished version using Google Gemini. One click to paste it back over the original.

You're writing an email, a Slack message, a PR description, and a sentence isn't quite right. Normally you'd:

1. Cut the sentence,
2. Switch to ChatGPT/Gemini in a browser,
3. Paste it, ask for a rephrase,
4. Copy the result,
5. Switch back, paste it.

With Rephraser, you:

1. Select the text,
2. Press Ctrl+Alt+J,
3. Click Rephrase → Replace.

No browser. No tab switching. No context loss.

• 🌐 Works in any app. Browsers, Notepad, VS Code, Slack, Word, anywhere you can select text.
• ⚡ Global hotkey. Capture from anywhere with Ctrl+Alt+J (customizable).
• 🪄 One-click rephrase and replace. Pastes the new version back over your original selection.
• 🍎 Cross-platform. Windows (Win32 + PowerShell) and macOS (AppleScript).
• 🔒 Local-first. Your API key and settings live on your machine, never on a server.
• 🎨 Choose your model. gemini-2.5-flash (default), flash-lite (fastest), or pro (best quality).
• ⚙️ Customizable shortcut with a recorder UI and collision detection.
• 🚪 Background-resident. Closing the window doesn't quit the app; the shortcut keeps working.

Settings	Pick your Gemini model
One-click copy with feedback

1. Download Rephraser Setup x.y.z.exe from the Releases page.
2. Double-click → follow the installer.
3. Launch Rephraser from the Start Menu.
4. On first run, paste your Gemini API key in Settings.

1. Download Rephraser-x.y.z-mac.zip from the Releases page.
2. Unzip → drag Rephraser.app into /Applications.
3. First launch will be blocked by Gatekeeper. Either:
   • Right-click the app → Open → Open Anyway, or
   • Run in Terminal:

     xattr -dr com.apple.quarantine /Applications/Rephraser.app

4. Launch the app. It will prompt for Accessibility permission. Open System Settings → Privacy & Security → Accessibility and toggle Rephraser on.
5. Quit and relaunch.

Go to aistudio.google.com/apikey, generate a key, and paste it into Rephraser's Settings. Free tier is generous enough for personal use.

1. Select any text in any application (browser, Notepad, VS Code, etc.).
2. Press Ctrl+Alt+J on Windows, or ⌘+⌥+J on macOS.
3. The Rephraser window appears with your selected text.
4. (Optional) Edit the captured text before rephrasing.
5. Click Rephrase. Wait a second or two.
6. Click Copy to copy the new version, or Replace to paste it directly back over your original selection in the source app.

💡 Tip: You can also type or paste text directly into Rephraser without the hotkey. Useful when you've already cleared your clipboard.

All settings are managed inside the app. Click the ⚙ icon in the top-right.

Settings live at:

• Windows: %APPDATA%\electron-app\settings.json
• macOS: ~/Library/Application Support/electron-app/settings.json

Another app or the OS is holding your chosen combo. Open Settings and pick a different shortcut.

You haven't granted Accessibility permission yet. System Settings → Privacy & Security → Accessibility → toggle Rephraser on. Then quit and relaunch.

Unsigned app. Right-click → Open → Open Anyway, or:

xattr -dr com.apple.quarantine /Applications/Rephraser.app

Want to run Rephraser from source, hack on it, or build your own installer? See CONTRIBUTING.md.

ISC