Introduction¶

AutoCore¶

Automate Core Actions

Documentation Status

A Python library that combines GUI automation, headless browser control and common actions into a single library.

With a single import, we get everything we need to automate repetitive tasks on Windows and Linux, no juggling multiple libraries or complex setup.

Security & Privacy¶

AutoCore runs entirely on your local machine. No data is sent to any external server at any point.

This makes it suitable for:

On-premise deployments with strict data security policies.
Automation involving sensitive or confidential data.
Compliance-sensitive industries like finance, healthcare and legal.

Platform Support¶

Supported: Windows, Linux
Not Supported: macOS

Functions¶

Function	Description
`browser(url)`	Open Chrome browser and navigate to URL
`click(...)`	Click on image, text, coordinates, color or web element
`click_right(...)`	Right-click on image, text, coordinates, color or web element
`copy(...)`	Copy text from active window, clipboard, coordinates or web element
`csv_to_xlsx(...)`	Convert CSV file to XLSX
`date()`	Current day of month (1-31)
`day()`	Current day of week (monday, tuesday, …)
`drag(...)`	Drag from source to target
`dropdown_select(...)`	Select item from a dropdown
`erase(...)`	Clear text from input fields
`find_browser(...)`	Find text in browser using Ctrl+F
`find_key(data, key)`	Recursively find all values of a key in nested data
`find_str(...)`	Extract substring between two markers
`hour()`	Current hour (0-23)
`inspect()`	GUI tool to inspect pixel position and color (Windows only)
`log_setup(title)`	Setup logging with terminal color status
`minute()`	Current minute (0-59)
`month()`	Current month (1-12)
`press(...)`	Press keyboard keys
`read(...)`	Read text from screen or browser via OCR or extract text from files
`run(target)`	Run a file or application
`say(text)`	Speak text using offline Text-to-Speech
`screenshot(...)`	Take a screenshot of full screen or region
`scroll(...)`	Scroll up, down, to top or to bottom
`second()`	Current second (0-59)
`wait(...)`	Wait with countdown, wait for element or wait for color
`wait_download(...)`	Monitor downloads folder for completion or fetch via URL
`window(...)`	List, focus, close, minimize, maximize, resize or move windows
`write(...)`	Type text in active window or web element
`year()`	Current year
`zoom(...)`	Zoom in/out by steps or set zoom percentage

File Formats Supported by `read()`¶

Category	Formats
Documents	PDF, DOCX, PPTX, ODT, RTF
Tabular	CSV, TSV, XLSX, SQLite
Structured	JSON, YAML, XML, INI/CFG
Text	TXT, LOG, MD
Web	HTML
Email	EML, MSG
eBooks	EPUB
Scripts	SH, BAT, PY

Quick Example¶

from autocore import *
log_setup("demo")

# Open login page in visible browser
dr = browser('https://practice.expandtesting.com/login')

# Open login page in headless browser
# dr = browser('https://practice.expandtesting.com/login', True)

# Scroll to the login form
find_browser(dr, 'secure area')
scroll(dr, 1)

# Login with test credentials
write(dr, 'id', 'username', 'practice')
write(dr, 'id', 'password', 'SuperSecretPassword!')
wait(2)
click(dr, 'id', 'submit-login')
wait(5)
# doing logout
click(dr, 'text', 'Logout')
wait(2)
print("Logout done.")
# showing blank page before moving to next website
dr.get("about:blank")
#====================================================
# Navigate to secure file download page
dr.get('https://practice.expandtesting.com/download')

# Scroll to bottom to make the link visible
scroll(dr, 'bottom')

# Click to download the test file
click(dr, 'text', 'some-file.json')

# Wait for download to finish with timeout of 2 mins
file_location = wait_download(120)

# Announce completion time with voice
say(f"File downloaded at {hour()} hours and {minute()} minutes")

# Closing the browser
dr.quit()
print("Content of downloaded file is : ", read(file_location))
print('bye bye')