Terminator: Getting Started

git clone https://github.com/mediar-ai/terminator
cd terminator 

pip install terminator-py

import terminator
desktop = terminator.Desktop()
desktop.open_application('calc')
seven = desktop.locator('name:Seven')
seven.click()

bun i terminator.js # or npm, pnpm, yarn

const { Desktop } = require('terminator.js');
const desktop = new Desktop();
await desktop.openApplication('notepad')
await desktop.locator('name:Edit').typeText('hello world')

import terminator

# create desktop instance
desktop = terminator.Desktop()

# open calculator
desktop.open_application('calc')

# interact with calculator buttons
seven = desktop.locator('name:Seven')
plus = desktop.locator('name:Plus')
equals = desktop.locator('name:Equals')

# perform calculation: 7 + 7 = 14
seven.click()
plus.click()
seven.click()
equals.click()

const { Desktop } = require('terminator.js');

async function automateNotepad() {
  const desktop = new Desktop();
  
  // open notepad
  await desktop.openApplication('notepad');
  
  // find text editor and type
  const editor = desktop.locator('name:Edit');
  await editor.typeText('hello from terminator!\nthis is automated text input.');
  
  // get the text back
  const content = await editor.getText();
  console.log('editor content:', content);
}

automateNotepad();