Getting Started

Install TextGO, grant required permissions, and create your first shortcut.

System Requirements

macOS

• macOS 11 or higher
• Requires Accessibility permission

Windows

• Windows 10 or higher
• 64-bit operating system

Download and Installation

1. Visit the GitHub Releases page
2. Download the package for your system:
   • macOS (Apple Silicon): TextGO_x.x.x_aarch64.dmg
   • macOS (Intel): TextGO_x.x.x_x64.dmg
   • Windows: TextGO_x.x.x_x64-setup.exe

Permission Settings

macOS

On macOS, TextGO needs the Accessibility permission to read selected text and simulate keyboard input.

Setup steps:

1. Open "System Settings" > "Privacy & Security" > "Accessibility"
2. Find TextGO and enable it
3. If TextGO is not listed, click the "+" button to add it manually

TIP

The system will automatically prompt for authorization when the app is used for the first time.

WARNING

TextGO is not signed. After updating the app on macOS, remove the old TextGO entry from Accessibility and add it again.

Windows

TextGO on Windows requires no additional permissions.

First Launch

1. Start the App

   • macOS: Launch from Launchpad or Applications folder
   • Windows: Launch from Start menu or desktop shortcut

2. Menu Bar or System Tray

   After launch, the app icon appears in the macOS menu bar or Windows system tray. The menu provides:

   • Open TextGO
   • Manage Shortcuts
   • View History
   • Settings...
   • Quit

Basic Usage

1. Open the main window
2. Click Register Shortcut
3. Select Double-Click or Drag-Select
4. Keep the default Toolbar Mode
5. Click + in the rules list to add a rule
6. Select recognition type and execution action
7. Click Confirm to save

Execution Modes

• Quiet Mode: Runs an action immediately after text selection; ideal for simple conversions
• Toolbar Mode: Shows a floating toolbar for choosing from multiple actions

Output Modes

• Replace: Replaces the selected text with the result
• Popup: Shows the result for further editing or copying
• No visual output: Leaves both options unselected; the result can still be copied to the clipboard

Available output options depend on the action. AI actions always open a popup, while actions such as web search, copy, cut, and paste do not return text results.

Double-click or drag to select text. The floating toolbar then lets you choose a preset action.

Rules with "Save result to history" enabled store their results in the history window:

Settings Overview

The settings pages group related options:

• Custom Recognitions: Manage classification models and regular expressions
• Custom Actions: Configure AI conversations, script execution, and web searches
• Display Settings: Adjust the toolbar and popup appearance and behavior
• Mouse Settings: Configure text selection, cursor behavior, and long-press triggers
• General Settings: Set the language, theme, history retention, behavior, and permissions

Use the buttons in the upper right corner to import or export all settings. Click the version number in the lower left corner to check for updates and install a newer version.

Get Help

• Check the FAQ
• Report a problem on GitHub Issues