Skip to content

A macOS app that automatically switches input methods for different applications. 自动切换不同应用输入法的 macOS 应用。

License

Notifications You must be signed in to change notification settings

ygsgdbd/TypeSwitch

Repository files navigation

TypeSwitch 🔄

TypeSwitch is a modern macOS application built with SwiftUI for automatically switching input methods across different applications. Leveraging the latest Swift features and native macOS capabilities, it provides a seamless and efficient experience for managing input method preferences.

✨ Screenshots

Main Interface

Main Interface - Set default input method for different applications

Search Function

Search Function - Quickly find and configure applications

🎯 Features

  • 🔄 Auto Switch: Automatically switch to preset input methods when changing applications
  • 🔍 Quick Search: Support fuzzy search for applications
  • 🎯 Precise Match: Set independent input method preferences for each application
  • 🚀 Auto Start: Support automatic startup
  • ⌨️ Keyboard Shortcuts:
    • ⌘ + F - Quick search applications
    • ⌘ + R - Refresh application list
    • ⌘ + Q - Quit application
  • 🎯 Quick Switch: Support customizable shortcut for switching current application's default input method

🔧 System Requirements

  • 🖥 macOS 13.0 or later
  • 🔐 Accessibility permission for monitoring application switches
  • ⌨️ Input method switching permission

📦 Installation

🍺 Option 1: Homebrew

# Add tap
brew tap ygsgdbd/tap

# Install application
brew install --cask typeswitch

💾 Option 2: Manual Installation

  1. Download the latest version from Releases
  2. Drag the application to Applications folder
  3. Grant necessary system permissions on first launch

📖 Usage

  1. After launching, the app icon appears in the menu bar
  2. Click the menu bar icon to open the main interface
  3. Find the application you want to configure in the list
  4. Select the default input method for the application
  5. The input method will automatically switch when you switch to that application

🔒 Security

TypeSwitch takes user privacy and security seriously:

  • 🏠 All data is stored locally, nothing is uploaded to the network
  • 🚫 No user information or usage data is collected
  • 📖 Source code is fully open source and welcome for review
  • 🛡️ Uses Swift's built-in security features
  • 🔐 Permission usage:
    • Accessibility: Only used for detecting application switches
    • Input method switching: Only used for switching input methods
    • Auto-start: Only used for launching at startup

Dependencies

This project uses the following open source libraries:

  • Defaults (9.0.0) - For persistent settings storage
  • SwiftUIX (0.1.9) - Provides additional SwiftUI components
  • SwifterSwift (7.0.0) - Swift native extensions
  • KeyboardShortcuts (2.2.2) - Add user-customizable global keyboard shortcuts

Build tools:

  • Tuist - For project generation and management

Development

Requirements

  • Xcode 15.0+
  • Swift 5.9+
  • macOS 13.0+
  • Tuist

Build Steps

  1. Install Tuist

  2. Clone repository

git clone https://github.com/ygsgdbd/TypeSwitch.git
cd TypeSwitch
  1. Generate Xcode project
tuist generate
  1. Open and build
open TypeSwitch.xcworkspace

Automated Build and Release

This project uses GitHub Actions for automated building and releasing:

  1. Push a new version tag to trigger automatic build:
git tag v1.0.0
git push origin v1.0.0
  1. GitHub Actions will automatically:

    • Build the application
    • Create DMG package
    • Release new version
    • Generate changelog
  2. Build artifacts can be downloaded from Releases

Project Structure

TypeSwitch/
├── Project.swift       # Tuist project configuration
├── Tuist/             # Tuist configuration files
├── Sources/           # Source code
│   ├── Models/        # Data models
│   ├── Views/         # SwiftUI views
│   ├── ViewModels/    # View models
│   └── Utils/         # Utility classes
└── Tests/            # Test files

Contributing

Pull requests and issues are welcome. Before submitting a PR, please ensure:

  1. Code follows project style
  2. Necessary tests are added
  3. Documentation is updated

License

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

Acknowledgments 🙏

This project was inspired by and received help from:

  • SwitchKey - An excellent input method switcher that provided valuable reference
  • Swift and SwiftUI community
  • All contributors and users who provided feedback

About

A macOS app that automatically switches input methods for different applications. 自动切换不同应用输入法的 macOS 应用。

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages