https://github.com/jingshing-python/auto_mouse_key_tool_py
A tool that can simulate key and mouse action coding with python. It use simple syntax to move mouse and key in the text and find the image position.
https://github.com/jingshing-python/auto_mouse_key_tool_py
autohotkey autotool python script
Last synced: 11 months ago
JSON representation
A tool that can simulate key and mouse action coding with python. It use simple syntax to move mouse and key in the text and find the image position.
- Host: GitHub
- URL: https://github.com/jingshing-python/auto_mouse_key_tool_py
- Owner: JingShing-Python
- License: bsd-3-clause
- Created: 2023-05-15T15:46:24.000Z (over 2 years ago)
- Default Branch: main
- Last Pushed: 2023-05-24T14:02:01.000Z (over 2 years ago)
- Last Synced: 2025-03-09T20:59:46.719Z (11 months ago)
- Topics: autohotkey, autotool, python, script
- Language: Python
- Homepage: https://jingshing.com/auto_tool_ide/
- Size: 179 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
English | [繁體中文](README_TCH.md)
# Auto_mouse_key_tool_py
A tool that can simulate key and mouse action coding with python. It use simple syntax to move mouse and key in the text and find the image position.
~this tool is about 1000+times faster than C. Because C can not control your computer and it will be TLE.~
## [Online IDE](https://jingshing.com/auto_tool_ide/) Now available!
> An [online ide](https://jingshing.com/auto_tool_ide/) help you write the auto tool script.
### preparation
* ```pip install keyboard```
* ```pip install pyautogui```
* ```pip install pillow```
## Instructions
## All syntax
> you can use '#' as comment
> Like ```#loop 10``` it will not run this loop
* keyboard action
* key string
* press key_name
* hold key_name
* release key_name
> all key name can see in below
* mouse action
* move
* move relative(r) dx dy
* move absolute(a) x y
* move image(i) image_path
* click
* click left/right/middle
* click left/right/middle N
* click left/right/middle hold
* click left/right/middle release
* click left/right/middle hold release
* scroll
* scroll up/down
* scroll up/down amount
* sleep
* sleep N
* loop
* loop N
* endloop
* if
* if image file_path
* if mouse px py
* endif
* exit
## Manual for syntax
> you can use '#' as comment
> Like ```#loop 10``` it will not run this loop
* keyboard action
* key string
> this will simulate the keyboard input to key in the string.
* press key_name
> press key once
* hold key_name
> pressed key
* release key_name
> release key
>
> all key name can see in below
* mouse action
* move
> this command can move mouse to specific position
* move relative(r) dx dy
> relative move
* move absolute(a) x y
> move to the absolute position
* move image(i) image_path
> move to the image detect on the screen. If not found it will do nothing
* click
> click the mouse button
* click left/right/middle
> click once
* click left/right/middle N
> click N times
* click left/right/middle hold
> pressed the button
* click left/right/middle release
* click left/right/middle hold release
* scroll
> use mouse scroll
* scroll up/down
> scroll onece
* scroll up/down amount
> scroll the certain amount
* sleep
> this method is for waiting the instruction. To slow down your script.
* sleep N
> wait for N seconds
* loop
> loop is a specific syntax. It has no effect but it can be mixed with other features.
* loop N
> loop N times. if N == -1 it will be infinite loop. It can be break with esc.
* endloop
> after a loop need to put loop end to declare a stop for loop.
* if
* if image file_path
> detect if on the screen detect the image file. It will be true and run the code below.
* if mouse px py
> detect if mouse in px py.
* endif
> after a if statement need to put endif to declare a stop for statement.
* exit
> stop the script
## all key_name available
* a, b, c, ...: individual letter keys
* 1, 2, 3, ...: number keys
* F1, F2, F3, ...: function keys
* space: spacebar
* enter: enter key
* tab: tab key
* shift: Shift key
* ctrl: Ctrl key
* alt: Alt key
* caps lock: Caps Lock key
* esc: Escape key
* backspace: backspace key
* delete: delete key
* home: Home key
* end: End key
* page up: Page Up key
* page down: Page Down key
* left arrow: left arrow key
* right arrow: right arrow key
* up arrow: up arrow key
* down arrow: down arrow key
## Log
### Ver0.1
* Feature:
* GUI
* edit file
* load and save
* run and stop
* Basic Syntax
* loop
* if statement
* press
* move
* sleep
* exit
* Load file
* Save file
### Ver0.2
* [Online IDE](https://jingshing.com/auto_tool_ide/)
* Feature:
* edit: loop end to endloop
* remove input box in gui
## TODO
- [X] if else: to detect image and to do something
- [ ] count
- [ ] not bool
- [ ] record
- [ ] support excel
- [x] gui
- [ ] generate instruction file
- [x] comment
- [ ] run other file
- [ ] jump
- [ ] exec
- [x] ide