muzy / TagUI

Command-line tool for robotic process automation (RPA) by AI Singapore

TagUI

Command-line tool for robotic process automation (RPA) by AI Singapore, a government-funded programme to accelerate AI in Singapore. For any support issues or questions, please let us know here. Our target is to respond to your query within 24 hours, including on weekends when IT projects usually go live.

Download TagUI v6.14 | Documentation | Demos | Samples | Slides | Feedback | Live Q&A

---

Write flows in simple TagUI language and automate your web, mouse and keyboard interactions on the screen.

TagUI is free to use and open-source. It's easy to setup and use, and works on Windows, macOS and Linux. Besides English, flows can also be written in 20 other languages, so go ahead and do RPA using your native language.

In TagUI language, you use steps like click and type to interact with identifiers, which include web identifiers, image snapshots, screen coordinates, or even text using OCR. Below is an example to login to Xero accounting:

https://login.xero.com/identity/user/login

type email as [e-mail]
type password as 12345678
click Log in

// besides web identifiers, images of UI elements can be used

type email_box.png as [e-mail]
type password_box.png as 12345678
click login_button.png

// (x,y) coordinates of user-interface elements can also be used

type (720,400) as [e-mail]
type (720,440) as 12345678
click (720,500)

v6 Features

TagUI live mode

You can run live mode directly for faster development by running tagui live on the command line.

Click text using OCR

TagUI can now click on the screen with visual automation just using text input, by using OCR technology.

click v6 Features using ocr

Deploy flows to run when double clicked

You can now create a shortcut for a flow, which can be moved to your desktop and double-clicked to run the flow. The flow will be run with all the options used when creating the shortcut.

$ tagui my_flow.tag -deploy
OR
$ tagui my_flow.tag -d

Running flows with options can be done with abbreviations

For example, you can now do tagui my_flow.tag -h instead of tagui my_flow.tag -headless.

Migrating to v6

Mandatory .tag file extension

All flow files must have a .tag extension.

Options must be used with a leading hyphen (-)

When running a flow with options, prefix a - to the options.

Before v6:

$ tagui my_flow.tag headless

After v6:

$ tagui my_flow.tag -headless
OR
$ tagui my_flow.tag -h

Change in syntax for echo, dump, write steps

The echo, dump and write steps are now consistent with the other steps. They no longer require quotes surrounding the string input. Instead, variables now need to be surrounded by backticks.

Before v6:

echo 'This works!' some_text_variable

After v6:

echo This works! `some_text_variable`

if and loop code blocks can use indentation instead of curly braces {}

This increases readability and ease of use. Just indent your code within the if and loop code blocks.

Before v6:

if some_condition
{
do_some_step_A
do_some_step_B
}

After v6:

if some_condition
  do_some_step_A
  do_some_step_B

TagUI v5.11

Visit v5.11 homepage for technical details of TagUI, such as its architecture diagram and codebase structure

Credits

• TagUI v3.0 - Ken Soh from Singapore
• SikuliX - Raimund Hocke from Germany
• CasperJS - Nicolas Perriault from France
• PhantomJS - Ariya Hidayat from Indonesia
• SlimerJS - Laurent Jouanneau from France

Sponsor

This project is supported by the National Research Foundation, Singapore under its AI Singapore Programme (AISG-RP-2019-050). Any opinions, findings and conclusions or recommendations expressed in this material are those of the author(s) and do not reflect the views of National Research Foundation, Singapore.