Clicknium-docs
Clicknium is a next-generation GUI automation framework for various types of applications. It offers a simple and streamlined developer experience with high-level APIs for automating GUI applications and intelligent plug-ins. It gives you a fresh approach to creating your automation universe. Browser automation, web and desktop application testing, and site scraping bots are also supported.
Requirements
|
Main version |
| Python |
3.7, 3.8, 3.9, 3.10, 3.11 |
| OS |
Windows 11, 10 recommended, Windows 7 SP1 or above |
Note: Windows 10 is the minimum supported Windows OS for DPI awareness.
Code Editor
Getting Started
Get a sample script showing the automation of the web page and notepad.
Installation
Set Up Clicknium Visual Studio Code Extension
-
Install the Extension (or search Clicknium in Visual Studio Code Extension marketplace).
-
Click CLICKNIUM EXPLORER in Visual Studio Code Activity Bar
-
Follow the welcome page:
- Check the Python environment.
- Install Clicknium Python module, as well as
pip install clicknium
- Select and install the browser extensions, at least including Edge. Enable the extension after the installation.
- Sign in to start for free.
To Reopen Welcome Page: open the Command Palette: Ctrl+Shift+P, input Clicknium:Welcome
To Enable Edge Extension: Open Edge browser, type edge://extensions/ into the address bar and enable Clicknium Recorder extension as below:
Setup Sample Project
- Click
Clicknium: Sample on Welcome Page. Or invoke the Command Palette by pressing Ctrl+Shift+P and inputting Clicknium: Sample`.
- Choose a path to locate the sample project.
The sample.py contains two automation samples, one is Edge web automation, and the other is notepad automation.
import subprocess
from time import sleep
from clicknium import clicknium as cc, locator, ui
def main():
# sample code to demo web automation and desktop application
tab = cc.edge.open("https://www.bing.com/")
tab.find_element(
locator.new_store.sample.bing.search_sb_form_q).set_text('clicknium')
tab.find_element(locator.new_store.sample.bing.svg).click()
sleep(3)
tab.close()
process = subprocess.Popen("notepad")
ui(locator.new_store.sample.notepad.document_15).set_text("clicknium")
sleep(3)
if __name__ == "__main__":
main()
Run the Sample
In Visual Studio Code, open sample.py and press Ctrl+F5 to run the script. It will do:
- Open a search engine page
- Input a keyword and click the search button
- Open a notepad
- Input text to notepad
Next
Learn how to start an automation project from zero.
Welcome to create a Github Issue or join Clicknium Slack if you have any questions.
评论