automagica

automagica

 # 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.  ## 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, ...  ## Example Browser working with Excel:  ## Activities An overview of all official Automagica activities: Process | Description ------- | ----------- **Cryptography** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/key-solid.svg" width="20"> [Random key](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_random_key) | Generate random Fernet key. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/lock-solid.svg" width="20"> [Encrypt text](https://automagica.readthedocs.io/activities.html#automagica.activities.encrypt_text_with_key) | Encrypt text with (Fernet) key, <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/lock-open-solid.svg" width="20"> [Decrypt text](https://automagica.readthedocs.io/activities.html#automagica.activities.decrypt_text_with_key) | Dexrypt bytes-like object to string with (Fernet) key <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/lock-solid.svg" width="20"> [Encrypt file](https://automagica.readthedocs.io/activities.html#automagica.activities.encrypt_file_with_key) | Encrypt file with (Fernet) key. Note that file will be unusable unless unlocked with the same key. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/lock-open-solid.svg" width="20"> [Decrypt file](https://automagica.readthedocs.io/activities.html#automagica.activities.decrypt_file_with_key) | Decrypts file with (Fernet) key <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/lock-solid.svg" width="20"> [Key from password](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_key_from_password) | Generate key based on password and salt. If both password and salt are known the key can be regenerated. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/fingerprint-solid.svg" width="20"> [Hash from file](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_hash_from_file) | Generate hash from file <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/fingerprint-solid.svg" width="20"> [Hash from text](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_hash_from_text) | Generate hash from text. Keep in mind that MD5 is not cryptographically secure. **Random** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/dice-solid.svg" width="20"> [Random number](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_random_number) | Random numbers can be integers (not a fractional number) or a float (fractional number). <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/digital-tachograph-solid.svg" width="20"> [Random data](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_random_data) | Generates all kinds of random data. Specifying locale changes format for some options <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/coins-solid.svg" width="20"> [Random boolean](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_random_boolean) | Generates a random boolean (True or False) <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/user-tag-solid.svg" width="20"> [Random name](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_random_name) | Generates a random name. Adding a locale adds a more common name in the specified locale. Provides first name and last name. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/comment-solid.svg" width="20"> [Random words](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_random_words) | Generates a random sentence. Specifying locale changes language and content based on locale. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/map-marker-solid.svg" width="20"> [Random address](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_random_address) | Generates a random address. Specifying locale changes random locations and streetnames based on locale. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/volume-up-solid.svg" width="20"> [Random beep](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_random_beep) | Generates a random beep, only works on Windows <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/calendar-solid.svg" width="20"> [Random date](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_random_date) | Generates a random date. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/calendar-solid.svg" width="20"> [Today's date](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_date_today) | Generates today's date. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/random-solid.svg" width="20"> [Generate unique identifier](https://automagica.readthedocs.io/activities.html#automagica.activities.generate_unique_identifier) | Generates a random UUID4 (universally unique identifier). **Output** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/tv-solid.svg" width="20"> [Display overlay message](https://automagica.readthedocs.io/activities.html#automagica.activities.display_osd_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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/tv-solid.svg" width="20"> [Print message in console](https://automagica.readthedocs.io/activities.html#automagica.activities.print_console) | Print message in console. Can be used to display data in the Automagica Flow console **Browser** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/chrome.svg" width="20"> [Chrome](https://automagica.readthedocs.io/activities.html#automagica.activities.Chrome) | Open Chrome Browser <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/images-solid.svg" width="20"> [Save all images](https://automagica.readthedocs.io/activities.html#automagica.activities.save_all_images) | Save all images on current page in the Browser <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/chrome.svg" width="20"> [Browse to URL](https://automagica.readthedocs.io/activities.html#automagica.activities.browse_to) | Browse to URL. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/align-center-solid.svg" width="20"> [Find elements by text](https://automagica.readthedocs.io/activities.html#automagica.activities.find_elements_by_text) | Find all elements by their text. Text does not need to match exactly, part of text is enough. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Find all links](https://automagica.readthedocs.io/activities.html#automagica.activities.find_all_links) | Find all links on a webpage in the browser <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Find first link on a webpage](https://automagica.readthedocs.io/activities.html#automagica.activities.find_first_link) | Find first link on a webpage <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Get all text on webpage](https://automagica.readthedocs.io/activities.html#automagica.activities.get_text_on_webpage) | Get all the raw body text from current webpage <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/highlighter-solid.svg" width="20"> [Highlight element](https://automagica.readthedocs.io/activities.html#automagica.activities.highlight) | Highlight elements in yellow in the browser <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-close-solid.svg" width="20"> [Exit the browser](https://automagica.readthedocs.io/activities.html#automagica.activities.exit) | Quit the browser by exiting gracefully. One can also use the native 'quit' function <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/times-solid.svg" width="20"> [Find all XPaths](https://automagica.readthedocs.io/activities.html#automagica.activities.by_xpaths) | Find all elements with specified xpath on a webpage in the the browser. Can also use native 'find_elements_by_xpath' <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/times-solid.svg" width="20"> [Find XPath in browser](https://automagica.readthedocs.io/activities.html#automagica.activities.by_xpath) | Find all element with specified xpath on a webpage in the the browser. Can also use native 'find_elements_by_xpath' <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/times-solid.svg" width="20"> [Find class in browser](https://automagica.readthedocs.io/activities.html#automagica.activities.by_class) | Find element with specified class on a webpage in the the browser. Can also use native 'find_element_by_class_name' <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/times-solid.svg" width="20"> [Find class in browser](https://automagica.readthedocs.io/activities.html#automagica.activities.by_classes) | Find all elements with specified class on a webpage in the the browser. Can also use native 'find_elements_by_class_name' function <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/times-solid.svg" width="20"> [Find element in browser based on class and text](https://automagica.readthedocs.io/activities.html#automagica.activities.by_class_and_by_text) | Find all elements with specified class and text on a webpage in the the browser. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/times-solid.svg" width="20"> [Find id in browser](https://automagica.readthedocs.io/activities.html#automagica.activities.by_id) | Find element with specified id on a webpage in the the browser. Can also use native 'find_element_by_id' function <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/times-solid.svg" width="20"> [Switch to iframe in browser](https://automagica.readthedocs.io/activities.html#automagica.activities.switch_to_iframe) | Switch to an iframe in the browser **Credential Management** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/key-solid.svg" width="20"> [Set credential](https://automagica.readthedocs.io/activities.html#automagica.activities.set_credential) | Add a credential which stores credentials locally and securely. All parameters should be Unicode text. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/key-solid.svg" width="20"> [Delete credential](https://automagica.readthedocs.io/activities.html#automagica.activities.delete_credential) | Delete a locally stored credential. All parameters should be Unicode text. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/key-solid.svg" width="20"> [Get credential](https://automagica.readthedocs.io/activities.html#automagica.activities.get_credential) | Get a locally stored redential. All parameters should be Unicode text. **FTP** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-open-solid.svg" width="20"> [Create FTP connection (insecure)](https://automagica.readthedocs.io/activities.html#automagica.activities.FTP) | Can be used to automate activites for FTP <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/download-solid.svg" width="20"> [Download file](https://automagica.readthedocs.io/activities.html#automagica.activities.download_file) | Downloads a file from FTP server. Connection needs to be established first. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/upload-solid.svg" width="20"> [Upload file](https://automagica.readthedocs.io/activities.html#automagica.activities.upload_file) | Upload file to FTP server <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/list-ol-solid.svg" width="20"> [List FTP files](https://automagica.readthedocs.io/activities.html#automagica.activities.enumerate_files) | Generate a list of all the files in the FTP directory <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/list-ol-solid.svg" width="20"> [Check FTP directory](https://automagica.readthedocs.io/activities.html#automagica.activities.directory_exists) | Check if FTP directory exists <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-plus-solid.svg" width="20"> [Create FTP directory](https://automagica.readthedocs.io/activities.html#automagica.activities.create_directory) | Create a FTP directory. Note that sufficient permissions are present **Keyboard** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/keyboard-solid.svg" width="20"> [Press key](https://automagica.readthedocs.io/activities.html#automagica.activities.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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/keyboard-solid.svg" width="20"> [Press key combination](https://automagica.readthedocs.io/activities.html#automagica.activities.press_key_combination) | Press a combination of two or three keys simultaneously. Make sure your keyboard is on US layout (standard QWERTY). <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/keyboard-solid.svg" width="20"> [Type text](https://automagica.readthedocs.io/activities.html#automagica.activities.typing) | 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** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-solid.svg" width="20"> [Get mouse coordinates](https://automagica.readthedocs.io/activities.html#automagica.activities.get_mouse_position) | Get the x and y pixel coordinates of current mouse position. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/search-location-solid.svg" width="20"> [Display mouse position](https://automagica.readthedocs.io/activities.html#automagica.activities.display_mouse_position) | Displays mouse position in an overlay. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-pointer-solid.svg" width="20"> [Mouse click](https://automagica.readthedocs.io/activities.html#automagica.activities.click) | Clicks on an element based on the element ID (vision) <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-pointer-solid.svg" width="20"> [Mouse click coordinates](https://automagica.readthedocs.io/activities.html#automagica.activities.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(). <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-pointer-solid.svg" width="20"> [Double mouse click coordinates](https://automagica.readthedocs.io/activities.html#automagica.activities.double_click_coordinates) | Double clicks on a pixel position determined by x and y coordinates. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-pointer-solid.svg" width="20"> [Double mouse click](https://automagica.readthedocs.io/activities.html#automagica.activities.double_click) | Double clicks on an element based on the element ID (vision) <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-pointer-solid.svg" width="20"> [Right click](https://automagica.readthedocs.io/activities.html#automagica.activities.right_click) | Right clicks on an element based on the element ID (vision) <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-pointer-solid.svg" width="20"> [Right click coordinates](https://automagica.readthedocs.io/activities.html#automagica.activities.right_click_coordinates) | Right clicks on an element based pixel position determined by x and y coordinates. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/arrows-alt-solid.svg" width="20"> [Move mouse](https://automagica.readthedocs.io/activities.html#automagica.activities.move_mouse_to) | Moves te pointer to an element based on the element ID (vision) <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/arrows-alt-solid.svg" width="20"> [Move mouse coordinates](https://automagica.readthedocs.io/activities.html#automagica.activities.move_mouse_to_coordinates) | Moves te pointer to an element based on the pixel position determined by x and y coordinates <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/arrows-alt-solid.svg" width="20"> [Move mouse relative](https://automagica.readthedocs.io/activities.html#automagica.activities.move_mouse_relative) | Moves the mouse an x- and y- distance relative to its current pixel position. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/arrows-alt-solid.svg" width="20"> [Drag mouse](https://automagica.readthedocs.io/activities.html#automagica.activities.drag_mouse_to_coordinates) | Drags mouse to an element based on pixel position determined by x and y coordinates <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/arrows-alt-solid.svg" width="20"> [Drag mouse](https://automagica.readthedocs.io/activities.html#automagica.activities.drag_mouse_to) | Drags mouse to an element based on the element ID (vision) **Image** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/crop-alt-solid.svg" width="20"> [Random screen snippet](https://automagica.readthedocs.io/activities.html#automagica.activities.random_screen_snippet) | Take a random square snippet from the current screen. Mainly for testing and/or development purposes. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/expand-solid.svg" width="20"> [Screenshot](https://automagica.readthedocs.io/activities.html#automagica.activities.take_screenshot) | Take a screenshot of current screen. **Folder Operations** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/search-solid.svg" width="20"> [List files in folder](https://automagica.readthedocs.io/activities.html#automagica.activities.get_files_in_folder) | List all files in a folder (and subfolders) <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-plus-solid.svg" width="20"> [Create folder](https://automagica.readthedocs.io/activities.html#automagica.activities.create_folder) | Creates new folder at the given path. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-solid.svg" width="20"> [Rename folder](https://automagica.readthedocs.io/activities.html#automagica.activities.rename_folder) | Rename a folder <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-open-solid.svg" width="20"> [Open a folder](https://automagica.readthedocs.io/activities.html#automagica.activities.show_folder) | Open a folder with the default explorer. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-solid.svg" width="20"> [Move a folder](https://automagica.readthedocs.io/activities.html#automagica.activities.move_folder) | Moves a folder from one place to another. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-minus-solid.svg" width="20"> [Remove folder](https://automagica.readthedocs.io/activities.html#automagica.activities.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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-minus-solid.svg" width="20"> [Empty folder](https://automagica.readthedocs.io/activities.html#automagica.activities.empty_folder) | Remove all contents from a folderFor the function to work optimal, all files and subfolders in the main targetfolder should be closed. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-solid.svg" width="20"> [Checks if folder exists](https://automagica.readthedocs.io/activities.html#automagica.activities.folder_exists) | Check whether folder exists or not, regardless if folder is empty or not. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/folder-solid.svg" width="20"> [Copy a folder](https://automagica.readthedocs.io/activities.html#automagica.activities.copy_folder) | Copies a folder from one place to another. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/archive-solid.svg" width="20"> [Zip](https://automagica.readthedocs.io/activities.html#automagica.activities.zip_folder) | Zip folder and its contents. Creates a .zip file. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/archive-solid.svg" width="20"> [Unzip](https://automagica.readthedocs.io/activities.html#automagica.activities.unzip) | Unzips a file or folder from a .zip file. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/clock-solid.svg" width="20"> [Return most recent file in directory](https://automagica.readthedocs.io/activities.html#automagica.activities.most_recent_file) | Return most recent file in directory **Delay** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/hourglass-solid.svg" width="20"> [Wait](https://automagica.readthedocs.io/activities.html#automagica.activities.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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/hourglass-solid.svg" width="20"> [Wait for folder](https://automagica.readthedocs.io/activities.html#automagica.activities.wait_folder_exists) | Waits until a folder exists.Note that this activity is blocking and will keep the system waiting. **Word Application** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Start Word Application](https://automagica.readthedocs.io/activities.html#automagica.activities.Word) | For this activity to work, Microsoft Office Word needs to be installed on the system. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Save](https://automagica.readthedocs.io/activities.html#automagica.activities.save) | Save active Word document <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Save As](https://automagica.readthedocs.io/activities.html#automagica.activities.save_as) | Save active Word document to a specific location <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Append text](https://automagica.readthedocs.io/activities.html#automagica.activities.append_text) | Append text at end of Word document. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Replace text](https://automagica.readthedocs.io/activities.html#automagica.activities.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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Read all text](https://automagica.readthedocs.io/activities.html#automagica.activities.read_all_text) | Read all the text from a document <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-pdf-solid.svg" width="20"> [Export to PDF](https://automagica.readthedocs.io/activities.html#automagica.activities.export_to_pdf) | Export the document to PDF <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/html5.svg" width="20"> [Export to HTML](https://automagica.readthedocs.io/activities.html#automagica.activities.export_to_html) | Export to HTML <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/heading-solid.svg" width="20"> [Set footers](https://automagica.readthedocs.io/activities.html#automagica.activities.set_footers) | Set the footers of the document <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/subscript-solid.svg" width="20"> [Set headers](https://automagica.readthedocs.io/activities.html#automagica.activities.set_headers) | Set the headers of the document <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Quit Word](https://automagica.readthedocs.io/activities.html#automagica.activities.quit) | This closes Word, make sure to use 'save' or 'save_as' if you would like to save before quitting. **Word File** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Read and Write Word files](https://automagica.readthedocs.io/activities.html#automagica.activities.WordFile) | These activities can read, write and edit Word (docx) files without the need of having Word installed. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Read all text](https://automagica.readthedocs.io/activities.html#automagica.activities.read_all_text) | Read all the text from the document <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Append text](https://automagica.readthedocs.io/activities.html#automagica.activities.append_text) | Append text at the end of the document <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Save](https://automagica.readthedocs.io/activities.html#automagica.activities.save) | Save document <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Save as](https://automagica.readthedocs.io/activities.html#automagica.activities.save_as) | Save file on specified path <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Set headers](https://automagica.readthedocs.io/activities.html#automagica.activities.set_headers) | Set headers of Word document <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-word-solid.svg" width="20"> [Replace all](https://automagica.readthedocs.io/activities.html#automagica.activities.replace_text) | Replaces all occurences of a placeholder text in the document with a replacement text. **Outlook Application** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Start Outlook Application](https://automagica.readthedocs.io/activities.html#automagica.activities.Outlook) | For this activity to work, Outlook needs to be installed on the system. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Send e-mail](https://automagica.readthedocs.io/activities.html#automagica.activities.send_mail) | Send an e-mail using Outlook <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Retrieve folders](https://automagica.readthedocs.io/activities.html#automagica.activities.get_folders) | Retrieve list of folders from Outlook <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Retrieve e-mails](https://automagica.readthedocs.io/activities.html#automagica.activities.get_mails) | Retrieve list of messages from Outlook <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Delete e-mails](https://automagica.readthedocs.io/activities.html#automagica.activities.delete_mails) | Deletes e-mail messages in a certain folder. Can be specified by searching on subject, body or sender e-mail. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Move e-mails](https://automagica.readthedocs.io/activities.html#automagica.activities.move_mails) | Move e-mail messages in a certain folder. Can be specified by searching on subject, body or sender e-mail. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Save attachments](https://automagica.readthedocs.io/activities.html#automagica.activities.save_attachments) | Save all attachments from certain folder <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Retrieve contacts](https://automagica.readthedocs.io/activities.html#automagica.activities.get_contacts) | Retrieve all contacts <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Add a contact](https://automagica.readthedocs.io/activities.html#automagica.activities.add_contact) | Add a contact to Outlook contacts <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Quit](https://automagica.readthedocs.io/activities.html#automagica.activities.quit) | Close the Outlook application **Excel Application** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Start Excel Application](https://automagica.readthedocs.io/activities.html#automagica.activities.Excel) | For this activity to work, Microsoft Office Excel needs to be installed on the system. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Add worksheet](https://automagica.readthedocs.io/activities.html#automagica.activities.add_worksheet) | Adds a worksheet to the current workbook <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Activate worksheet](https://automagica.readthedocs.io/activities.html#automagica.activities.activate_worksheet) | Activate a worksheet in the current Excel document by name <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Save](https://automagica.readthedocs.io/activities.html#automagica.activities.save) | Save the current workbook. Defaults to homedir <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Save as](https://automagica.readthedocs.io/activities.html#automagica.activities.save_as) | Save the current workbook to a specific path <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Write cell](https://automagica.readthedocs.io/activities.html#automagica.activities.write_cell) | Write to a specific cell in the currently active workbook and active worksheet <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Read cell](https://automagica.readthedocs.io/activities.html#automagica.activities.read_cell) | Read a cell from the currently active workbook and active worksheet <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Write range](https://automagica.readthedocs.io/activities.html#automagica.activities.write_range) | Write to a specific range in the currently active worksheet in the active workbook <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Read range](https://automagica.readthedocs.io/activities.html#automagica.activities.read_range) | Read a range of cells from the currently active worksheet in the active workbook <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Run macro](https://automagica.readthedocs.io/activities.html#automagica.activities.run_macro) | Run a macro by name from the currently active workbook <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Get worksheet names](https://automagica.readthedocs.io/activities.html#automagica.activities.get_worksheet_names) | Get names of all the worksheets in the currently active workbook <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Get table](https://automagica.readthedocs.io/activities.html#automagica.activities.get_table) | Get table data from the currently active worksheet by name of the table <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Activate range](https://automagica.readthedocs.io/activities.html#automagica.activities.activate_range) | Activate a particular range in the currently active workbook <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Activate first empty cell down](https://automagica.readthedocs.io/activities.html#automagica.activities.activate_first_empty_cell_down) | Activates the first empty cell going down <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Activate first empty cell right](https://automagica.readthedocs.io/activities.html#automagica.activities.activate_first_empty_cell_right) | Activates the first empty cell going right <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Activate first empty cell left](https://automagica.readthedocs.io/activities.html#automagica.activities.activate_first_empty_cell_left) | Activates the first empty cell going left <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Activate first empty cell up](https://automagica.readthedocs.io/activities.html#automagica.activities.activate_first_empty_cell_up) | Activates the first empty cell going up <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Write cell formula](https://automagica.readthedocs.io/activities.html#automagica.activities.write_cell_formula) | Write a formula to a particular cell <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Read cell formula](https://automagica.readthedocs.io/activities.html#automagica.activities.read_cell_formula) | Read the formula from a particular cell <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Insert empty row](https://automagica.readthedocs.io/activities.html#automagica.activities.insert_empty_row) | Inserts an empty row to the currently active worksheet <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Insert empty column](https://automagica.readthedocs.io/activities.html#automagica.activities.insert_empty_column) | Inserts an empty column in the currently active worksheet. Existing columns will shift to the right. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Delete row in Excel](https://automagica.readthedocs.io/activities.html#automagica.activities.delete_row) | Deletes a row from the currently active worksheet. Existing data will shift up. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Delete column](https://automagica.readthedocs.io/activities.html#automagica.activities.delete_column) | Delete a column from the currently active worksheet. Existing columns will shift to the left. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Export to PDF](https://automagica.readthedocs.io/activities.html#automagica.activities.export_to_pdf) | Export to PDF <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Insert data as table](https://automagica.readthedocs.io/activities.html#automagica.activities.insert_data_as_table) | Insert list of dictionaries as a table in Excel <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Read worksheet](https://automagica.readthedocs.io/activities.html#automagica.activities.read_worksheet) | Read data from a worksheet as a list of lists <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Quit Excel](https://automagica.readthedocs.io/activities.html#automagica.activities.quit) | This closes Excel, make sure to use 'save' or 'save_as' if you would like to save before quitting. **Excel File** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Read and Write xlsx files.](https://automagica.readthedocs.io/activities.html#automagica.activities.ExcelFile) | This activity can read, write and edit Excel (xlsx) files without the need of having Excel installed. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Export file to dataframe](https://automagica.readthedocs.io/activities.html#automagica.activities.to_dataframe) | Export to pandas dataframe <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Activate worksheet](https://automagica.readthedocs.io/activities.html#automagica.activities.activate_worksheet) | Activate a worksheet. By default the first worksheet is activated. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Save as](https://automagica.readthedocs.io/activities.html#automagica.activities.save_as) | Save file as <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Save as](https://automagica.readthedocs.io/activities.html#automagica.activities.save) | Save file <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Write cell](https://automagica.readthedocs.io/activities.html#automagica.activities.write_cell) | Write a cell based on column and row <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Read cell](https://automagica.readthedocs.io/activities.html#automagica.activities.read_cell) | Read a cell based on column and row <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Add worksheet](https://automagica.readthedocs.io/activities.html#automagica.activities.add_worksheet) | Add a worksheet <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-excel-solid.svg" width="20"> [Get worksheet names](https://automagica.readthedocs.io/activities.html#automagica.activities.get_worksheet_names) | Get worksheet names **PowerPoint Application** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Start PowerPoint Application](https://automagica.readthedocs.io/activities.html#automagica.activities.PowerPoint) | For this activity to work, PowerPoint needs to be installed on the system. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Save PowerPoint](https://automagica.readthedocs.io/activities.html#automagica.activities.save_as) | Save PowerPoint Slidedeck <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Save PowerPoint](https://automagica.readthedocs.io/activities.html#automagica.activities.save) | Save PowerPoint Slidedeck <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Close PowerPoint Application](https://automagica.readthedocs.io/activities.html#automagica.activities.quit) | Close PowerPoint <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Add PowerPoint Slides](https://automagica.readthedocs.io/activities.html#automagica.activities.add_slide) | Adds slides to a presentation <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Slide count](https://automagica.readthedocs.io/activities.html#automagica.activities.number_of_slides) | Returns the number of slides <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Text to slide](https://automagica.readthedocs.io/activities.html#automagica.activities.add_text) | Add text to a slide <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Delete slide](https://automagica.readthedocs.io/activities.html#automagica.activities.delete_slide) | Delete a slide <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Replace all occurences of text in PowerPoint slides](https://automagica.readthedocs.io/activities.html#automagica.activities.replace_text) | Can be used for example to replace arbitrary placeholder value in a PowerPoint. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [PowerPoint to PDF](https://automagica.readthedocs.io/activities.html#automagica.activities.export_to_pdf) | Export PowerPoint presentation to PDF file <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-powerpoint-solid.svg" width="20"> [Slides to images](https://automagica.readthedocs.io/activities.html#automagica.activities.export_slides_to_images) | Export PowerPoint slides to seperate image files **Office 365** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/envelope-solid.svg" width="20"> [Send email Office Outlook 365](https://automagica.readthedocs.io/activities.html#automagica.activities.send_email_with_outlook365) | Send email Office Outlook 365 **Salesforce** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/salesforce.svg" width="20"> [Salesforce API](https://automagica.readthedocs.io/activities.html#automagica.activities.salesforce_api_call) | Activity to make calls to Salesforce REST API. **E-mail (SMTP)** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mail-bulk-solid.svg" width="20"> [Mail with SMTP](https://automagica.readthedocs.io/activities.html#automagica.activities.send_mail_smtp) | This function lets you send emails with an e-mail address. **Windows OS** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/readme.svg" width="20"> [Find window with specific title](https://automagica.readthedocs.io/activities.html#automagica.activities.find_window_title) | Find a specific window based on the name, either a perfect match or a partial match. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/passport-solid.svg" width="20"> [Login to Windows Remote Desktop](https://automagica.readthedocs.io/activities.html#automagica.activities.start_remote_desktop) | Create a RDP and login to Windows Remote Desktop <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/passport-solid.svg" width="20"> [Stop Windows Remote Desktop](https://automagica.readthedocs.io/activities.html#automagica.activities.close_remote_desktop) | Stop Windows Remote Desktop <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/passport-solid.svg" width="20"> [Set Windows password](https://automagica.readthedocs.io/activities.html#automagica.activities.set_user_password) | Sets the password for a Windows user. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/passport-solid.svg" width="20"> [Check Windows password](https://automagica.readthedocs.io/activities.html#automagica.activities.validate_user_password) | Validates a Windows user password if it is correct <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/user-lock-solid.svg" width="20"> [Lock Windows](https://automagica.readthedocs.io/activities.html#automagica.activities.lock_windows) | Locks Windows requiring login to continue. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/user-solid.svg" width="20"> [Check if Windows logged in](https://automagica.readthedocs.io/activities.html#automagica.activities.is_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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/user-solid.svg" width="20"> [Check if Windows is locked](https://automagica.readthedocs.io/activities.html#automagica.activities.is_desktop_locked) | Checks if the current user is locked out and on the lockscreen. Most automations do not work properly when the desktop is locked. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/user-solid.svg" width="20"> [Get Windows username](https://automagica.readthedocs.io/activities.html#automagica.activities.get_username) | Get current logged in user's username <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/clipboard-check-solid.svg" width="20"> [Set clipboard](https://automagica.readthedocs.io/activities.html#automagica.activities.set_to_clipboard) | Set any text to the Windows clipboard. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/clipboard-list-solid.svg" width="20"> [Get clipboard](https://automagica.readthedocs.io/activities.html#automagica.activities.get_from_clipboard) | Get the text currently in the Windows clipboard <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/clipboard-solid.svg" width="20"> [Empty clipboard](https://automagica.readthedocs.io/activities.html#automagica.activities.clear_clipboard) | Empty text from clipboard. Getting clipboard data after this should return in None <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/cogs-solid.svg" width="20"> [Run VBSscript](https://automagica.readthedocs.io/activities.html#automagica.activities.run_vbs_script) | Run a VBScript file <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/volume-up-solid.svg" width="20"> [Beep](https://automagica.readthedocs.io/activities.html#automagica.activities.beep) | Make a beeping sound. Make sure your volume is up and you have hardware connected. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/ethernet-solid.svg" width="20"> [Get all network interface names](https://automagica.readthedocs.io/activities.html#automagica.activities.get_all_network_interface_names) | Returns a list of all network interfaces of the current machine <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/ethernet-solid.svg" width="20"> [Enable network interface](https://automagica.readthedocs.io/activities.html#automagica.activities.enable_network_interface) | Enables a network interface by its name. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/ethernet-solid.svg" width="20"> [Disable network interface](https://automagica.readthedocs.io/activities.html#automagica.activities.disable_network_interface) | Disables a network interface by its name. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/print-solid.svg" width="20"> [Get default printer](https://automagica.readthedocs.io/activities.html#automagica.activities.get_default_printer_name) | Returns the name of the printer selected as default <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/print-solid.svg" width="20"> [Set default printer](https://automagica.readthedocs.io/activities.html#automagica.activities.set_default_printer) | Set the default printer. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/print-solid.svg" width="20"> [Remove printer](https://automagica.readthedocs.io/activities.html#automagica.activities.remove_printer) | Removes a printer by its name <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/cog-solid.svg" width="20"> [Get service status](https://automagica.readthedocs.io/activities.html#automagica.activities.get_service_status) | Returns the status of a service on the machine <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/cog-solid.svg" width="20"> [Start a service](https://automagica.readthedocs.io/activities.html#automagica.activities.start_service) | Starts a Windows service <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/cog-solid.svg" width="20"> [Stop a service](https://automagica.readthedocs.io/activities.html#automagica.activities.stop_service) | Stops a Windows service <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Set window to foreground](https://automagica.readthedocs.io/activities.html#automagica.activities.set_window_to_foreground) | Sets a window to foreground by its title. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Get foreground window title](https://automagica.readthedocs.io/activities.html#automagica.activities.get_foreground_window_title) | Retrieve the title of the current foreground window <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Close window](https://automagica.readthedocs.io/activities.html#automagica.activities.close_window) | Closes a window by its title <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Maximize window](https://automagica.readthedocs.io/activities.html#automagica.activities.maximize_window) | Maximizes a window by its title <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Restore window](https://automagica.readthedocs.io/activities.html#automagica.activities.restore_window) | Restore a window by its title <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Minimize window](https://automagica.readthedocs.io/activities.html#automagica.activities.minimize_window) | Minimizes a window by its title <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Resize window](https://automagica.readthedocs.io/activities.html#automagica.activities.resize_window) | Resize a window by its title <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-restore-solid.svg" width="20"> [Hide window](https://automagica.readthedocs.io/activities.html#automagica.activities.hide_window) | Hides a window from the user desktop by using it's title **Terminal** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/terminal-solid.svg" width="20"> [Run SSH command](https://automagica.readthedocs.io/activities.html#automagica.activities.run_ssh_command) | Runs a command over SSH (Secure Shell) **SNMP** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/ethernet-solid.svg" width="20"> [SNMP Get](https://automagica.readthedocs.io/activities.html#automagica.activities.snmp_get) | Retrieves data from an SNMP agent using SNMP (Simple Network Management Protocol) **Active Directory** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/audio-description-solid.svg" width="20"> [AD interface](https://automagica.readthedocs.io/activities.html#automagica.activities.ActiveDirectory) | Interface to Windows Active Directory through ADSI. Connects to the AD domain to which the machine is joined by default. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/audio-description-solid.svg" width="20"> [Get AD object by name](https://automagica.readthedocs.io/activities.html#automagica.activities.get_object_by_distinguished_name) | Interface to Windows Active Directory through ADSI **Utilities** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/home-solid.svg" width="20"> [Get user home path](https://automagica.readthedocs.io/activities.html#automagica.activities.home_path) | Returns the current user's home path <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/desktop-solid.svg" width="20"> [Get desktop path](https://automagica.readthedocs.io/activities.html#automagica.activities.desktop_path) | Returns the current user's desktop path <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/download-solid.svg" width="20"> [Get downloads path](https://automagica.readthedocs.io/activities.html#automagica.activities.downloads_path) | Returns the current user's default download path <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-solid.svg" width="20"> [Open file](https://automagica.readthedocs.io/activities.html#automagica.activities.open_file) | Opens file with default programs <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/desktop-solid.svg" width="20"> [Set wallpaper](https://automagica.readthedocs.io/activities.html#automagica.activities.set_wallpaper) | Set Windows desktop wallpaper with the the specified image <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/cloud-download-alt-solid.svg" width="20"> [Download file from a URL](https://automagica.readthedocs.io/activities.html#automagica.activities.download_file_from_url) | Download file from a URL **System** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-contract-solid.svg" width="20"> [Rename a file](https://automagica.readthedocs.io/activities.html#automagica.activities.rename_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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-export-solid.svg" width="20"> [Move a file](https://automagica.readthedocs.io/activities.html#automagica.activities.move_file) | If the new location already contains a file with the same name. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/trash-solid.svg" width="20"> [Remove a file](https://automagica.readthedocs.io/activities.html#automagica.activities.remove_file) | Remove a file <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/tasks-solid.svg" width="20"> [Check if file exists](https://automagica.readthedocs.io/activities.html#automagica.activities.file_exists) | This function checks whether the file with the given path exists. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/list-alt-solid.svg" width="20"> [Wait until a file exists.](https://automagica.readthedocs.io/activities.html#automagica.activities.wait_file_exists) | Note that this activity is blocking and will keep the system waiting. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/list-solid.svg" width="20"> [List to .txt](https://automagica.readthedocs.io/activities.html#automagica.activities.write_list_to_file) | Writes a list to a text (.txt) file.Every element of the entered list is written on a new line of the text file. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/th-list-solid.svg" width="20"> [Read list from .txt file](https://automagica.readthedocs.io/activities.html#automagica.activities.read_list_from_txt) | 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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/th-list-solid.svg" width="20"> [Read .txt file](https://automagica.readthedocs.io/activities.html#automagica.activities.read_from_txt) | This activity reads a .txt file and returns the content <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/tasks-solid.svg" width="20"> [Append to .txt](https://automagica.readthedocs.io/activities.html#automagica.activities.append_line) | Append a text line to a file and creates the file if it does not exist yet. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/file-alt-solid.svg" width="20"> [Make text file](https://automagica.readthedocs.io/activities.html#automagica.activities.make_text_file) | Initialize text file <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/copy-solid.svg" width="20"> [Read .txt file with newlines to list](https://automagica.readthedocs.io/activities.html#automagica.activities.read_text_file_to_list) | Read a text file to a Python list-object <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/copy-solid.svg" width="20"> [Copy a file](https://automagica.readthedocs.io/activities.html#automagica.activities.copy_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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/info-solid.svg" width="20"> [Get file extension](https://automagica.readthedocs.io/activities.html#automagica.activities.get_file_extension) | Get extension of a file <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/print-solid.svg" width="20"> [Print](https://automagica.readthedocs.io/activities.html#automagica.activities.send_to_printer) | 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** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/glasses-solid.svg" width="20"> [Text from PDF](https://automagica.readthedocs.io/activities.html#automagica.activities.read_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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/object-ungroup-solid.svg" width="20"> [Merge PDF](https://automagica.readthedocs.io/activities.html#automagica.activities.join_pdf_files) | Merges multiple PDFs into a single file <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/cut-solid.svg" width="20"> [Extract page from PDF](https://automagica.readthedocs.io/activities.html#automagica.activities.extract_page_range_from_pdf) | Extracts a particular range of a PDF to a separate file. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/icons-solid.svg" width="20"> [Extract images from PDF](https://automagica.readthedocs.io/activities.html#automagica.activities.extract_images_from_pdf) | Save a specific page from a PDF as an image <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/stamp-solid.svg" width="20"> [Watermark a PDF](https://automagica.readthedocs.io/activities.html#automagica.activities.apply_watermark_to_pdf) | Watermark a PDF **System Monitoring** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/microchip-solid.svg" width="20"> [CPU load](https://automagica.readthedocs.io/activities.html#automagica.activities.get_cpu_load) | Get average CPU load for all cores. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/calculator-solid.svg" width="20"> [Count CPU](https://automagica.readthedocs.io/activities.html#automagica.activities.get_number_of_cpu) | Get the number of CPU's in the current system. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/wave-square-solid.svg" width="20"> [CPU frequency](https://automagica.readthedocs.io/activities.html#automagica.activities.get_cpu_frequency) | Get frequency at which CPU currently operates. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/server-solid.svg" width="20"> [CPU Stats](https://automagica.readthedocs.io/activities.html#automagica.activities.get_cpu_stats) | Get CPU statistics <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/memory-solid.svg" width="20"> [Memory statistics](https://automagica.readthedocs.io/activities.html#automagica.activities.get_memory_stats) | Get memory statistics <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/save-solid.svg" width="20"> [Disk stats](https://automagica.readthedocs.io/activities.html#automagica.activities.get_disk_stats) | Get disk statistics of main disk <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/save-solid.svg" width="20"> [Partition info](https://automagica.readthedocs.io/activities.html#automagica.activities.get_disk_partitions) | Get disk partition info <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/clock-solid.svg" width="20"> [Boot time](https://automagica.readthedocs.io/activities.html#automagica.activities.get_boot_time) | Get most recent boot time <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/clock-solid.svg" width="20"> [Uptime](https://automagica.readthedocs.io/activities.html#automagica.activities.get_time_since_last_boot) | Get uptime since last boot **Image Processing** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/images-solid.svg" width="20"> [Show image](https://automagica.readthedocs.io/activities.html#automagica.activities.show_image) | Displays an image specified by the path variable on the default imaging program. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/undo-solid.svg" width="20"> [Rotate image](https://automagica.readthedocs.io/activities.html#automagica.activities.rotate_image) | Rotate an image <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/expand-arrows-alt-solid.svg" width="20"> [Resize image](https://automagica.readthedocs.io/activities.html#automagica.activities.resize_image) | Resizes the image specified by the path variable. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/expand-arrows-alt-solid.svg" width="20"> [Get image width](https://automagica.readthedocs.io/activities.html#automagica.activities.get_image_width) | Get with of image <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/arrows-alt-v-solid.svg" width="20"> [Get image height](https://automagica.readthedocs.io/activities.html#automagica.activities.get_image_height) | Get height of image <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/crop-solid.svg" width="20"> [Crop image](https://automagica.readthedocs.io/activities.html#automagica.activities.crop_image) | Crops the image specified by path to a region determined by the box variable. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/caret-up-solid.svg" width="20"> [Mirror image horizontally](https://automagica.readthedocs.io/activities.html#automagica.activities.mirror_image_horizontally) | Mirrors an image with a given path horizontally from left to right. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/caret-right-solid.svg" width="20"> [Mirror image vertically](https://automagica.readthedocs.io/activities.html#automagica.activities.mirror_image_vertically) | Mirrors an image with a given path vertically from top to bottom. **Process** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/cog-solid.svg" width="20"> [Windows run](https://automagica.readthedocs.io/activities.html#automagica.activities.run_manual) | Use Windows Run to boot a processNote this uses keyboard inputs which means this process can be disrupted by interfering inputs <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/play-solid.svg" width="20"> [Run process](https://automagica.readthedocs.io/activities.html#automagica.activities.run) | Use subprocess to open a windows process <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/cogs-solid.svg" width="20"> [Check if process is running](https://automagica.readthedocs.io/activities.html#automagica.activities.is_process_running) | Check if process is running. Validates if given process name (name) is currently running on the system. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/list-solid.svg" width="20"> [Get running processes](https://automagica.readthedocs.io/activities.html#automagica.activities.get_running_processes) | Get names of unique processes currently running on the system. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/window-close-solid.svg" width="20"> [Kill process](https://automagica.readthedocs.io/activities.html#automagica.activities.kill_process) | Kills a process forcefully **Optical Character Recognition (OCR)** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/readme.svg" width="20"> [Get text with OCR](https://automagica.readthedocs.io/activities.html#automagica.activities.extract_text_ocr) | This activity extracts all text from the current screen or an image if a path is specified. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/glasses-solid.svg" width="20"> [Find text on screen with OCR](https://automagica.readthedocs.io/activities.html#automagica.activities.find_text_on_screen_ocr) | This activity finds position (coordinates) of specified text on the current screen using OCR. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-pointer-solid.svg" width="20"> [Click on text with OCR](https://automagica.readthedocs.io/activities.html#automagica.activities.click_on_text_ocr) | This activity clicks on position (coordinates) of specified text on the current screen using OCR. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-pointer-solid.svg" width="20"> [Double click on text with OCR](https://automagica.readthedocs.io/activities.html#automagica.activities.double_click_on_text_ocr) | This activity double clicks on position (coordinates) of specified text on the current screen using OCR. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/mouse-pointer-solid.svg" width="20"> [Right click on text with OCR](https://automagica.readthedocs.io/activities.html#automagica.activities.right_click_on_text_ocr) | This activity Right clicks on position (coordinates) of specified text on the current screen using OCR. **UiPath** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/robot-solid.svg" width="20"> [Execute a UiPath process](https://automagica.readthedocs.io/activities.html#automagica.activities.execute_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** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/robot-solid.svg" width="20"> [Execute a AutoIt script](https://automagica.readthedocs.io/activities.html#automagica.activities.run_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** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/robot-solid.svg" width="20"> [Execute a Robot Framework test case](https://automagica.readthedocs.io/activities.html#automagica.activities.execute_robotframework_test) | This activity allows you to run a Robot Framework test case. Console output of the test case will be printed. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/robot-solid.svg" width="20"> [Run a Blue Prism process](https://automagica.readthedocs.io/activities.html#automagica.activities.run_blueprism_process) | This activity allows you to run a Blue Prism process. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/robot-solid.svg" width="20"> [Run an Automation Anywhere task](https://automagica.readthedocs.io/activities.html#automagica.activities.run_automationanywhere_task) | This activity allows you to run an Automation Anywhere task. **General** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/briefcase-solid.svg" width="20"> [Raise exception](https://automagica.readthedocs.io/activities.html#automagica.activities.raise_exception) | Raises an exception **SAP GUI** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/briefcase-solid.svg" width="20"> [Quit SAP GUI](https://automagica.readthedocs.io/activities.html#automagica.activities.quit) | Quits the SAP GUI completely and forcibly. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/briefcase-solid.svg" width="20"> [Log in to SAP GUI](https://automagica.readthedocs.io/activities.html#automagica.activities.login) | Logs in to an SAP system on SAP GUI. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/briefcase-solid.svg" width="20"> [Click on a SAP GUI element](https://automagica.readthedocs.io/activities.html#automagica.activities.click_sap) | Clicks on an identifier in the SAP GUI. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/briefcase-solid.svg" width="20"> [Get text from a SAP GUI element](https://automagica.readthedocs.io/activities.html#automagica.activities.get_text) | Retrieves the text from a SAP GUI element. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/briefcase-solid.svg" width="20"> [Set text of a SAP GUI element](https://automagica.readthedocs.io/activities.html#automagica.activities.set_text) | Sets the text of a SAP GUI element. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/briefcase-solid.svg" width="20"> [Highlights a SAP GUI element](https://automagica.readthedocs.io/activities.html#automagica.activities.highlight) | Temporarily highlights a SAP GUI element **Portal** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/robot-solid.svg" width="20"> [Create a new job in the Automagica Portal](https://automagica.readthedocs.io/activities.html#automagica.activities.create_new_job_in_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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/key-solid.svg" width="20"> [Get a credential from the Automagica Portal](https://automagica.readthedocs.io/activities.html#automagica.activities.get_credential_from_portal) | This activity retrieves a credential from the Automagica Portal. **Vision** | ‌‌ <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/eye-solid.svg" width="20"> [Check if element is visible on screen](https://automagica.readthedocs.io/activities.html#automagica.activities.is_visible) | 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. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/eye-solid.svg" width="20"> [Wait for an element to appear](https://automagica.readthedocs.io/activities.html#automagica.activities.wait_appear) | Wait for an element that is defined the recorder <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/eye-solid.svg" width="20"> [Wait Vanish](https://automagica.readthedocs.io/activities.html#automagica.activities.wait_vanish) | This activity allows the bot to wait for an element to vanish. <img src="https://cdn.jsdelivr.net/npm/[email protected]/svg/eye-solid.svg" width="20"> [Read Text with Automagica Wand](https://automagica.readthedocs.io/activities.html#automagica.activities.read_text) | 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. |<img width=150/>| ‌‌| ## 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](https://automagica.com/contact/)