Skip to content

automagica/automagica

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 

Repository files navigation

https://automagica.com)

Automagica

The Automagica project began in 2018 with a focus on creating open source software to ensure that Robotic Process Automation technologies were accessible to all.

With subsequent releases of Automagica, more advanced features such as Wand and the Portal required a service infrastructure to deliver more resilient robots, advanced services, and management and control.

As use of these services has increased, the costs for hosting and maintaining the service layer have correspondingly increased.

In order to drive the next phase of development for these important services, today, 13th October 2020, we are pleased to announce that Netcall plc, a leading provider of low-code, customer engagement, and contact centre software, has acquired Oakwood Technologies BV (trading as ‘Automagica’).

Netcall will integrate Automagica’s RPA into its Liberty platform, providing a powerful combination of RPA, Low-code, and Customer Engagement solutions.

The Automagica Robot is no longer be available under the terms of the AGPL3 licence.

We’re not stopping the use of the services for robots already deployed. These will continue to operate with Wand and OCR, free of charge, for three months from today (13 Oct 20).

Existing users of the Automagica Portal will also be able to access, free of charge, for three months, during which time users will be offered options to migrate to a commercial service.

We wish to thank all contributors to the project.

Love Automagica Example

Components

The Automagica suite consists of the following components:

  • Automagica Bot: runtime/agent responsible for performing the automated tasks.
  • Automagica Flow: a visual flow designer to build automations quickly with full support for Python code.
  • Automagica Wand: UI element picker powered by AI.
  • Automagica Lab: Notebook-style automation development environment based on Jupyter Notebooks (requires Jupyter to be installed).
  • Automagica Portal: management of bots, credentials, automations, logs, ...

Portal and Flow

Example

Browser working with Excel:

Excel Example Automagica

Activities

An overview of all official Automagica activities:

Process Description
Cryptography ‌‌
Random key Generate random Fernet key.
Encrypt text Encrypt text with (Fernet) key,
Decrypt text Dexrypt bytes-like object to string with (Fernet) key
Encrypt file Encrypt file with (Fernet) key. Note that file will be unusable unless unlocked with the same key.
Decrypt file Decrypts file with (Fernet) key
Key from password Generate key based on password and salt. If both password and salt are known the key can be regenerated.
Hash from file Generate hash from file
Hash from text Generate hash from text. Keep in mind that MD5 is not cryptographically secure.
Random ‌‌
Random number Random numbers can be integers (not a fractional number) or a float (fractional number).
Random data Generates all kinds of random data. Specifying locale changes format for some options
Random boolean Generates a random boolean (True or False)
Random name Generates a random name. Adding a locale adds a more common name in the specified locale. Provides first name and last name.
Random words Generates a random sentence. Specifying locale changes language and content based on locale.
Random address Generates a random address. Specifying locale changes random locations and streetnames based on locale.
Random beep Generates a random beep, only works on Windows
Random date Generates a random date.
Today's date Generates today's date.
Generate unique identifier Generates a random UUID4 (universally unique identifier).
Output ‌‌
Display overlay message Display custom OSD (on-screen display) message. Can be used to display a message for a limited amount of time. Can be used for illustration, debugging or as OSD.
Print message in console Print message in console. Can be used to display data in the Automagica Flow console
Browser ‌‌
Chrome Open Chrome Browser
Save all images Save all images on current page in the Browser
Browse to URL Browse to URL.
Find elements by text Find all elements by their text. Text does not need to match exactly, part of text is enough.
Find all links Find all links on a webpage in the browser
Find first link on a webpage Find first link on a webpage
Get all text on webpage Get all the raw body text from current webpage
Highlight element Highlight elements in yellow in the browser
Exit the browser Quit the browser by exiting gracefully. One can also use the native 'quit' function
Find all XPaths Find all elements with specified xpath on a webpage in the the browser. Can also use native 'find_elements_by_xpath'
Find XPath in browser Find all element with specified xpath on a webpage in the the browser. Can also use native 'find_elements_by_xpath'
Find class in browser Find element with specified class on a webpage in the the browser. Can also use native 'find_element_by_class_name'
Find class in browser Find all elements with specified class on a webpage in the the browser. Can also use native 'find_elements_by_class_name' function
Find element in browser based on class and text Find all elements with specified class and text on a webpage in the the browser.
Find id in browser Find element with specified id on a webpage in the the browser. Can also use native 'find_element_by_id' function
Switch to iframe in browser Switch to an iframe in the browser
Credential Management ‌‌
Set credential Add a credential which stores credentials locally and securely. All parameters should be Unicode text.
Delete credential Delete a locally stored credential. All parameters should be Unicode text.
Get credential Get a locally stored redential. All parameters should be Unicode text.
FTP ‌‌
Create FTP connection (insecure) Can be used to automate activites for FTP
Download file Downloads a file from FTP server. Connection needs to be established first.
Upload file Upload file to FTP server
List FTP files Generate a list of all the files in the FTP directory
Check FTP directory Check if FTP directory exists
Create FTP directory Create a FTP directory. Note that sufficient permissions are present
Keyboard ‌‌
Press key Press and release an entered key. Make sure your keyboard is on US layout (standard QWERTY).If you are using this on Mac Os you might need to grant access to your terminal application.
Press key combination Press a combination of two or three keys simultaneously. Make sure your keyboard is on US layout (standard QWERTY).
Type text Simulate keystrokes. If an element ID is specified, text will be typed in a specific field or element based on the element ID (vision) by the recorder.
Mouse ‌‌
Get mouse coordinates Get the x and y pixel coordinates of current mouse position.
Display mouse position Displays mouse position in an overlay.
Mouse click Clicks on an element based on the element ID (vision)
Mouse click coordinates Clicks on an element based on pixel position determined by x and y coordinates. To find coordinates one could use display_mouse_position().
Double mouse click coordinates Double clicks on a pixel position determined by x and y coordinates.
Double mouse click Double clicks on an element based on the element ID (vision)
Right click Right clicks on an element based on the element ID (vision)
Right click coordinates Right clicks on an element based pixel position determined by x and y coordinates.
Move mouse Moves te pointer to an element based on the element ID (vision)
Move mouse coordinates Moves te pointer to an element based on the pixel position determined by x and y coordinates
Move mouse relative Moves the mouse an x- and y- distance relative to its current pixel position.
Drag mouse Drags mouse to an element based on pixel position determined by x and y coordinates
Drag mouse Drags mouse to an element based on the element ID (vision)
Image ‌‌
Random screen snippet Take a random square snippet from the current screen. Mainly for testing and/or development purposes.
Screenshot Take a screenshot of current screen.
Folder Operations ‌‌
List files in folder List all files in a folder (and subfolders)
Create folder Creates new folder at the given path.
Rename folder Rename a folder
Open a folder Open a folder with the default explorer.
Move a folder Moves a folder from one place to another.
Remove folder Remove a folder including all subfolders and files. For the function to work optimal, all files and subfolders in the main targetfolder should be closed.
Empty folder Remove all contents from a folderFor the function to work optimal, all files and subfolders in the main targetfolder should be closed.
Checks if folder exists Check whether folder exists or not, regardless if folder is empty or not.
Copy a folder Copies a folder from one place to another.
Zip Zip folder and its contents. Creates a .zip file.
Unzip Unzips a file or folder from a .zip file.
Return most recent file in directory Return most recent file in directory
Delay ‌‌
Wait Make the robot wait for a specified number of seconds. Note that this activity is blocking. This means that subsequent activities will not occur until the the specified waiting time has expired.
Wait for folder Waits until a folder exists.Note that this activity is blocking and will keep the system waiting.
Word Application ‌‌
Start Word Application For this activity to work, Microsoft Office Word needs to be installed on the system.
Save Save active Word document
Save As Save active Word document to a specific location
Append text Append text at end of Word document.
Replace text Can be used for example to replace arbitrary placeholder value. For example whenusing template document, using 'XXXX' as a placeholder. Take note that all strings are case sensitive.
Read all text Read all the text from a document
Export to PDF Export the document to PDF
Export to HTML Export to HTML
Set footers Set the footers of the document
Set headers Set the headers of the document
Quit Word This closes Word, make sure to use 'save' or 'save_as' if you would like to save before quitting.
Word File ‌‌
Read and Write Word files These activities can read, write and edit Word (docx) files without the need of having Word installed.
Read all text Read all the text from the document
Append text Append text at the end of the document
Save Save document
Save as Save file on specified path
Set headers Set headers of Word document
Replace all Replaces all occurences of a placeholder text in the document with a replacement text.
Outlook Application ‌‌
Start Outlook Application For this activity to work, Outlook needs to be installed on the system.
Send e-mail Send an e-mail using Outlook
Retrieve folders Retrieve list of folders from Outlook
Retrieve e-mails Retrieve list of messages from Outlook
Delete e-mails Deletes e-mail messages in a certain folder. Can be specified by searching on subject, body or sender e-mail.
Move e-mails Move e-mail messages in a certain folder. Can be specified by searching on subject, body or sender e-mail.
Save attachments Save all attachments from certain folder
Retrieve contacts Retrieve all contacts
Add a contact Add a contact to Outlook contacts
Quit Close the Outlook application
Excel Application ‌‌
Start Excel Application For this activity to work, Microsoft Office Excel needs to be installed on the system.
Add worksheet Adds a worksheet to the current workbook
Activate worksheet Activate a worksheet in the current Excel document by name
Save Save the current workbook. Defaults to homedir
Save as Save the current workbook to a specific path
Write cell Write to a specific cell in the currently active workbook and active worksheet
Read cell Read a cell from the currently active workbook and active worksheet
Write range Write to a specific range in the currently active worksheet in the active workbook
Read range Read a range of cells from the currently active worksheet in the active workbook
Run macro Run a macro by name from the currently active workbook
Get worksheet names Get names of all the worksheets in the currently active workbook
Get table Get table data from the currently active worksheet by name of the table
Activate range Activate a particular range in the currently active workbook
Activate first empty cell down Activates the first empty cell going down
Activate first empty cell right Activates the first empty cell going right
Activate first empty cell left Activates the first empty cell going left
Activate first empty cell up Activates the first empty cell going up
Write cell formula Write a formula to a particular cell
Read cell formula Read the formula from a particular cell
Insert empty row Inserts an empty row to the currently active worksheet
Insert empty column Inserts an empty column in the currently active worksheet. Existing columns will shift to the right.
Delete row in Excel Deletes a row from the currently active worksheet. Existing data will shift up.
Delete column Delete a column from the currently active worksheet. Existing columns will shift to the left.
Export to PDF Export to PDF
Insert data as table Insert list of dictionaries as a table in Excel
Read worksheet Read data from a worksheet as a list of lists
Quit Excel This closes Excel, make sure to use 'save' or 'save_as' if you would like to save before quitting.
Excel File ‌‌
Read and Write xlsx files. This activity can read, write and edit Excel (xlsx) files without the need of having Excel installed.
Export file to dataframe Export to pandas dataframe
Activate worksheet Activate a worksheet. By default the first worksheet is activated.
Save as Save file as
Save as Save file
Write cell Write a cell based on column and row
Read cell Read a cell based on column and row
Add worksheet Add a worksheet
Get worksheet names Get worksheet names
PowerPoint Application ‌‌
Start PowerPoint Application For this activity to work, PowerPoint needs to be installed on the system.
Save PowerPoint Save PowerPoint Slidedeck
Save PowerPoint Save PowerPoint Slidedeck
Close PowerPoint Application Close PowerPoint
Add PowerPoint Slides Adds slides to a presentation
Slide count Returns the number of slides
Text to slide Add text to a slide
Delete slide Delete a slide
Replace all occurences of text in PowerPoint slides Can be used for example to replace arbitrary placeholder value in a PowerPoint.
PowerPoint to PDF Export PowerPoint presentation to PDF file
Slides to images Export PowerPoint slides to seperate image files
Office 365 ‌‌
Send email Office Outlook 365 Send email Office Outlook 365
Salesforce ‌‌
Salesforce API Activity to make calls to Salesforce REST API.
E-mail (SMTP) ‌‌
Mail with SMTP This function lets you send emails with an e-mail address.
Windows OS ‌‌
Find window with specific title Find a specific window based on the name, either a perfect match or a partial match.
Login to Windows Remote Desktop Create a RDP and login to Windows Remote Desktop
Stop Windows Remote Desktop Stop Windows Remote Desktop
Set Windows password Sets the password for a Windows user.
Check Windows password Validates a Windows user password if it is correct
Lock Windows Locks Windows requiring login to continue.
Check if Windows logged in Checks if the current user is logged in and not on the lockscreen. Most automations do not work properly when the desktop is locked.
Check if Windows is locked Checks if the current user is locked out and on the lockscreen. Most automations do not work properly when the desktop is locked.
Get Windows username Get current logged in user's username
Set clipboard Set any text to the Windows clipboard.
Get clipboard Get the text currently in the Windows clipboard
Empty clipboard Empty text from clipboard. Getting clipboard data after this should return in None
Run VBSscript Run a VBScript file
Beep Make a beeping sound. Make sure your volume is up and you have hardware connected.
Get all network interface names Returns a list of all network interfaces of the current machine
Enable network interface Enables a network interface by its name.
Disable network interface Disables a network interface by its name.
Get default printer Returns the name of the printer selected as default
Set default printer Set the default printer.
Remove printer Removes a printer by its name
Get service status Returns the status of a service on the machine
Start a service Starts a Windows service
Stop a service Stops a Windows service
Set window to foreground Sets a window to foreground by its title.
Get foreground window title Retrieve the title of the current foreground window
Close window Closes a window by its title
Maximize window Maximizes a window by its title
Restore window Restore a window by its title
Minimize window Minimizes a window by its title
Resize window Resize a window by its title
Hide window Hides a window from the user desktop by using it's title
Terminal ‌‌
Run SSH command Runs a command over SSH (Secure Shell)
SNMP ‌‌
SNMP Get Retrieves data from an SNMP agent using SNMP (Simple Network Management Protocol)
Active Directory ‌‌
AD interface Interface to Windows Active Directory through ADSI. Connects to the AD domain to which the machine is joined by default.
Get AD object by name Interface to Windows Active Directory through ADSI
Utilities ‌‌
Get user home path Returns the current user's home path
Get desktop path Returns the current user's desktop path
Get downloads path Returns the current user's default download path
Open file Opens file with default programs
Set wallpaper Set Windows desktop wallpaper with the the specified image
Download file from a URL Download file from a URL
System ‌‌
Rename a file This activity will rename a file. If the the desired name already exists in the folder file will not be renamed. Make sure to add the exstention to specify filetype.
Move a file If the new location already contains a file with the same name.
Remove a file Remove a file
Check if file exists This function checks whether the file with the given path exists.
Wait until a file exists. Note that this activity is blocking and will keep the system waiting.
List to .txt Writes a list to a text (.txt) file.Every element of the entered list is written on a new line of the text file.
Read list from .txt file This activity reads the content of a .txt file to a list and returns that list.Every new line from the .txt file becomes a new element of the list. The activity willnot work if the entered path is not attached to a .txt file.
Read .txt file This activity reads a .txt file and returns the content
Append to .txt Append a text line to a file and creates the file if it does not exist yet.
Make text file Initialize text file
Read .txt file with newlines to list Read a text file to a Python list-object
Copy a file Copies a file from one place to another.If the new location already contains a file with the same name, a random 4 character uid is added to the name.
Get file extension Get extension of a file
Print Send file to default printer to priner. This activity sends a file to the printer. Make sure to have a default printer set up.
PDF ‌‌
Text from PDF Extracts the text from a PDF. This activity reads text from a pdf file. Can only read PDF files that contain a text layer.
Merge PDF Merges multiple PDFs into a single file
Extract page from PDF Extracts a particular range of a PDF to a separate file.
Extract images from PDF Save a specific page from a PDF as an image
Watermark a PDF Watermark a PDF
System Monitoring ‌‌
CPU load Get average CPU load for all cores.
Count CPU Get the number of CPU's in the current system.
CPU frequency Get frequency at which CPU currently operates.
CPU Stats Get CPU statistics
Memory statistics Get memory statistics
Disk stats Get disk statistics of main disk
Partition info Get disk partition info
Boot time Get most recent boot time
Uptime Get uptime since last boot
Image Processing ‌‌
Show image Displays an image specified by the path variable on the default imaging program.
Rotate image Rotate an image
Resize image Resizes the image specified by the path variable.
Get image width Get with of image
Get image height Get height of image
Crop image Crops the image specified by path to a region determined by the box variable.
Mirror image horizontally Mirrors an image with a given path horizontally from left to right.
Mirror image vertically Mirrors an image with a given path vertically from top to bottom.
Process ‌‌
Windows run Use Windows Run to boot a processNote this uses keyboard inputs which means this process can be disrupted by interfering inputs
Run process Use subprocess to open a windows process
Check if process is running Check if process is running. Validates if given process name (name) is currently running on the system.
Get running processes Get names of unique processes currently running on the system.
Kill process Kills a process forcefully
Optical Character Recognition (OCR) ‌‌
Get text with OCR This activity extracts all text from the current screen or an image if a path is specified.
Find text on screen with OCR This activity finds position (coordinates) of specified text on the current screen using OCR.
Click on text with OCR This activity clicks on position (coordinates) of specified text on the current screen using OCR.
Double click on text with OCR This activity double clicks on position (coordinates) of specified text on the current screen using OCR.
Right click on text with OCR This activity Right clicks on position (coordinates) of specified text on the current screen using OCR.
UiPath ‌‌
Execute a UiPath process This activity allows you to execute a process designed with the UiPath Studio. All console output from the Write Line activity will be printed as output.
AutoIt ‌‌
Execute a AutoIt script This activity allows you to run an AutoIt script. If you use the ConsoleWrite function, the output will be presented to you.
Alternative frameworks ‌‌
Execute a Robot Framework test case This activity allows you to run a Robot Framework test case. Console output of the test case will be printed.
Run a Blue Prism process This activity allows you to run a Blue Prism process.
Run an Automation Anywhere task This activity allows you to run an Automation Anywhere task.
General ‌‌
Raise exception Raises an exception
SAP GUI ‌‌
Quit SAP GUI Quits the SAP GUI completely and forcibly.
Log in to SAP GUI Logs in to an SAP system on SAP GUI.
Click on a SAP GUI element Clicks on an identifier in the SAP GUI.
Get text from a SAP GUI element Retrieves the text from a SAP GUI element.
Set text of a SAP GUI element Sets the text of a SAP GUI element.
Highlights a SAP GUI element Temporarily highlights a SAP GUI element
Portal ‌‌
Create a new job in the Automagica Portal This activity creates a new job in the Automagica Portal for a given process. The bot performing this activity needs to be in the same team as the process it creates a job for.
Get a credential from the Automagica Portal This activity retrieves a credential from the Automagica Portal.
Vision ‌‌
Check if element is visible on screen This activity can be used to check if a certain element is visible on the screen.Note that this uses Automagica Portal and uses some advanced an fuzzy matching algorithms for finding identical elements.
Wait for an element to appear Wait for an element that is defined the recorder
Wait Vanish This activity allows the bot to wait for an element to vanish.
Read Text with Automagica Wand This activity allows the bot to detect and read the text of an element by using the Automagica Portal API with a provided sample ID.
‌‌

Licensing

Copyright and licensing

All source code and other files in this repository, unless stated otherwise, are copyright of Netcall plc.

Commercial license

For more information on licensing, trials and commercial use see this page