🍎

Script Tool for macOS

macOS 11 Big Sur or later  ·  Apple Silicon & Intel

Download .zip

Installation

Follow all three steps in order. Each step is required for the app to work fully.

1

Open the app — bypass Gatekeeper

macOS blocks apps that aren't signed by a registered Apple developer. Script Tool is safe — use the below steps methods to allow it:

System Settings easiest

  1. Download Script-Tool-mac.zip and double-click it — Script Tool.app appears.
  2. Double-click Script Tool → macOS shows a warning → Click Cancel.
  3. Open Apple menu → System Settings → Privacy & Security.
  4. Scroll down to the blocked-app notice and click Open Anyway.
  5. Confirm by clicking Open in the dialog that appears.
2

Grant Accessibility permission required for IME

The inline Sanskrit IME intercepts keystrokes system-wide. macOS requires explicit Accessibility permission for this.

  1. Launch Script Tool — the ॐ icon appears in your menu bar.
  2. Press Alt+Shift+M to toggle the IME — macOS will prompt you to open System Settings.
  3. Go to System Settings → Privacy & Security → Accessibility.
  4. Find Script Tool in the list and toggle it ON.
  5. Quit and relaunch Script Tool, then try Alt+Shift+M again.

Without Accessibility permission the IME shortcut will do nothing. The offline converter and quick panel work without it.

How to use Script Tool

A

Inline IME — type in any app

Keystrokes intercepted system-wide. Text inserted directly, no copy-paste.

1

Toggle IME on — Alt+Shift+M

A slim indicator bar appears at the top of your screen showing your active scheme and script (e.g. ITRANS ▶ Active). Click into any text field in any app.

2

Type phonetic text

Start typing — e.g. namaskaara. The indicator bar shows namaskaara → नमस्कार live as you type. Your keystrokes are intercepted; nothing appears in the app yet.

3

Commit the word — Space or Enter

Press Space — नमस्कार is inserted directly into the text field. Press Enter to insert with a newline. Continue typing the next word immediately.

4

Switch script or scheme mid-sentence

Press Alt+Shift+O to cycle through all 7 scripts. Press Alt+Shift+1/2/3 to switch between ITRANS, Harvard-Kyoto, and SLP1 — without leaving your app.

5

Exit IME — Esc or Alt+Shift+M

Press Esc to cancel the current word and exit IME mode. Or press Alt+Shift+M again to toggle it off.

B

Offline Converter

Side-by-side Indic script + IAST output. Copy with one click.

1

Open the converter — Alt+Shift+I

Press the shortcut from any app, or click the ॐ menu bar icon and choose Open Script Tool.

2

Type/Copy and Choose scheme/script

Type in or Paste your input which is auto-detected and select an output script (Devanagari, Kannada, Telugu, Tamil, Bengali, Malayalam, or IAST) using the buttons. Click Copy on whichever output you need.

C

Quick Panel

Floating overlay — type once, paste directly into the active app.

1

Open the panel — Alt+Shift+S

A small floating panel appears over whatever you're working in. The app behind it stays focused.

2

Type and preview

Type your word phonetically. You'll see the Devanagari preview instantly below the input field.

3

Paste — Enter

Press Enter or click Paste ↵. The converted text is pasted directly into the app that was active behind the panel. Press Esc to close without pasting.

Keyboard Shortcuts

Global — work from any app, always active

Open converter window
⌥⇧I
Open quick panel
⌥⇧S
Toggle Sanskrit IME on/off
⌥⇧M

While IME is active

Switch to ITRANS scheme
⌥⇧1
Switch to Harvard-Kyoto scheme
⌥⇧2
Switch to SLP1 scheme
⌥⇧3
Cycle output script
⌥⇧O
Commit word + space
Space
Commit word + newline
Enter
Delete last phonetic character
⌫
Cancel and exit IME
Esc