Skip to content
/ teximo Public

A beautiful macOS menu bar app for keyboard layout switching and text transliteration

License

Notifications You must be signed in to change notification settings

dmrkv/teximo

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

60 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Teximo

A seamless macOS menu bar app for keyboard layout switching and text manipulation.

Features

  • ⚙️ Customizable Shortcuts: Configure your own keyboard shortcuts for all actions
  • 🎨 Settings Window: Unified settings interface for shortcuts, layouts, and startup preferences
  • ⌨️ Smart Layout Switching: Choose specific keyboard layouts for English and Russian
  • 🔄 Text Transliteration: Convert selected text between English and Russian (Cyrillic)
  • 🔠 Case Toggle: Cycle through lowercase, UPPERCASE, Title Case, and Sentence case
  • 🔍 Smart Detection: Automatically detects text direction for transliteration
  • 👻 Invisible Operation: Works seamlessly in the background without interrupting your workflow
  • ⚠️ Conflict Detection: Visual warnings when shortcuts overlap

Installation

Option 1: Homebrew (Recommended)

brew install dmrkv/teximo/teximo

Note: This installs Teximo from the Homebrew tap. Make sure you have Homebrew installed first.

Option 2: Download from Releases

  1. Go to the Releases page

  2. Download the latest Teximo.dmg file

  3. Open the DMG and drag Teximo to your Applications folder

  4. 🚨 IMPORTANT - Security Warning Fix:

    When you first try to launch Teximo, macOS will show a security warning:

    "Teximo.app Not Opened"

    Screenshot 1

    To fix this, you MUST:

    • Go to MacOS Settings (Spotlight → System Settings)
    • Click "Open" in the security dialog
    • In the left sidebar find Privacy and Security, and then in the right side of the window find Security → "Teximo.app" was blocked to protect your Mac. Click on Open anyway Screenshot 2
    • When you run Teximo next time from Applications, click again on "Open anyway" Screenshot 3

    This is a one-time step - after this, Teximo will launch normally!

  5. After that launch Teximo from Applications

Option 3: Build from Source

  1. Clone this repository
  2. Open Teximo.xcodeproj in Xcode
  3. Build and run (Cmd+R)

First Launch

When you first launch Teximo, you'll see a permission window guiding you through enabling accessibility permissions:

  1. Click "Open System Settings"
  2. Navigate to Privacy & Security → Accessibility
  3. Find 'Teximo' in the list and check the box

Usage

Once permissions are granted, Teximo will appear in your menu bar with a "T" icon.

Settings Window

Click the menu bar icon and select "Settings..." to:

  • Customize keyboard shortcuts for layout switching, transliteration, and case toggle
  • Choose specific keyboard layouts for English and Russian
  • Enable/disable launching Teximo at macOS startup
  • Reset all settings to defaults

Default Shortcuts

The app works globally in any application with these default shortcuts (customizable in Settings):

  • ⌘⇧ (Cmd+Shift): Switch between keyboard layouts
  • ⌥⇧ (Option+Shift): Transliterate selected text between English and Russian
  • ⌃⇧ (Ctrl+Shift): Toggle case of selected text

Troubleshooting

Alternative Method (if right-click doesn't work):

  1. Go to System PreferencesSecurity & PrivacySecurity
  2. Look for a message about Teximo being blocked
  3. Click "Open Anyway"

Layout Switching Popover (macOS Sonoma and later)

If you see a small popover appearing near your cursor when switching layouts, this is a macOS system feature introduced in Sonoma. Teximo uses direct system APIs that work instantly and don't depend on macOS keyboard shortcuts.

To disable the system popover (optional):

defaults write kCFPreferencesAnyApplication TSMLanguageIndicatorEnabled 0

After running this command, restart your applications for the change to take effect. This will revert to the older style indicator or hide it completely.

Other Issues

If you encounter any other issues, please check the Issues page or create a new issue.

Requirements

  • macOS 13.0 or later
  • Accessibility permissions (guided setup on first launch)

Privacy

Teximo processes text locally on your device. No data is sent to external servers. The app only requires accessibility permissions to simulate keystrokes for text manipulation.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.

Acknowledgments

Inspired by the need for efficient keyboard layout switching and text manipulation on macOS.

About

A beautiful macOS menu bar app for keyboard layout switching and text transliteration

Resources

License

Stars

Watchers

Forks

Packages

No packages published