{"id":20651907,"url":"https://github.com/jingshing-python/auto_mouse_key_tool_py","last_synced_at":"2025-03-09T20:59:49.256Z","repository":{"id":165619449,"uuid":"641016992","full_name":"JingShing-Python/Auto_mouse_key_tool_py","owner":"JingShing-Python","description":"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.","archived":false,"fork":false,"pushed_at":"2023-05-24T14:02:01.000Z","size":183,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-09T20:59:46.719Z","etag":null,"topics":["autohotkey","autotool","python","script"],"latest_commit_sha":null,"homepage":"https://jingshing.com/auto_tool_ide/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-3-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/JingShing-Python.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-15T15:46:24.000Z","updated_at":"2023-08-30T18:27:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"9f8c4d82-96f3-43d3-8463-f16eb9253092","html_url":"https://github.com/JingShing-Python/Auto_mouse_key_tool_py","commit_stats":null,"previous_names":["jingshing-python/auto_mouse_key_tool_py"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JingShing-Python%2FAuto_mouse_key_tool_py","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JingShing-Python%2FAuto_mouse_key_tool_py/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JingShing-Python%2FAuto_mouse_key_tool_py/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/JingShing-Python%2FAuto_mouse_key_tool_py/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/JingShing-Python","download_url":"https://codeload.github.com/JingShing-Python/Auto_mouse_key_tool_py/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":242750785,"owners_count":20179257,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["autohotkey","autotool","python","script"],"created_at":"2024-11-16T17:30:35.709Z","updated_at":"2025-03-09T20:59:49.225Z","avatar_url":"https://github.com/JingShing-Python.png","language":"Python","readme":"English | [繁體中文](README_TCH.md)\n# Auto_mouse_key_tool_py\nA 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.\n\n~this tool is about 1000+times faster than C. Because C can not control your computer and it will be TLE.~\n\n## [Online IDE](https://jingshing.com/auto_tool_ide/) Now available!\n![image_ide](image/online_ide.png)\n\u003e An [online ide](https://jingshing.com/auto_tool_ide/) help you write the auto tool script.\n\n### preparation\n* ```pip install keyboard```\n* ```pip install pyautogui```\n* ```pip install pillow```\n## Instructions\n## All syntax\n\u003e you can use '#' as comment\n\n\u003e Like ```#loop 10``` it will not run this loop\n* keyboard action\n  * key string\n  * press key_name\n  * hold key_name\n  * release key_name\n  \u003e all key name can see in below\n* mouse action\n  * move\n    * move relative(r) dx dy\n    * move absolute(a) x y\n    * move image(i) image_path\n  * click\n    * click left/right/middle\n    * click left/right/middle N\n    * click left/right/middle hold\n    * click left/right/middle release\n    * click left/right/middle hold release\n  * scroll\n    * scroll up/down\n    * scroll up/down amount\n* sleep\n  * sleep N\n* loop\n  * loop N\n  * endloop\n* if\n  * if image file_path\n  * if mouse px py\n  * endif\n* exit\n\n## Manual for syntax\n\u003e you can use '#' as comment\n\n\u003e Like ```#loop 10``` it will not run this loop\n* keyboard action\n  * key string\n  \u003e this will simulate the keyboard input to key in the string.\n  * press key_name\n  \u003e press key once\n  * hold key_name\n  \u003e pressed key\n  * release key_name\n  \u003e release key\n  \u003e \n  \u003e all key name can see in below\n* mouse action\n  * move\n  \u003e this command can move mouse to specific position\n    * move relative(r) dx dy\n    \u003e relative move\n    * move absolute(a) x y\n    \u003e move to the absolute position\n    * move image(i) image_path\n    \u003e move to the image detect on the screen. If not found it will do nothing\n  * click\n  \u003e click the mouse button\n    * click left/right/middle\n    \u003e click once\n    * click left/right/middle N\n    \u003e click N times\n    * click left/right/middle hold\n    \u003e pressed the button\n    * click left/right/middle release\n    * click left/right/middle hold release\n  * scroll\n  \u003e use mouse scroll\n    * scroll up/down\n    \u003e scroll onece\n    * scroll up/down amount\n    \u003e scroll the certain amount\n* sleep\n\u003e this method is for waiting the instruction. To slow down your script.\n  * sleep N\n  \u003e wait for N seconds\n* loop\n\u003e loop is a specific syntax. It has no effect but it can be mixed with other features.\n  * loop N\n  \u003e loop N times. if N == -1 it will be infinite loop. It can be break with esc.\n  * endloop\n  \u003e after a loop need to put loop end to declare a stop for loop.\n* if\n  * if image file_path\n  \u003e detect if on the screen detect the image file. It will be true and run the code below.\n  * if mouse px py\n  \u003e detect if mouse in px py.\n  * endif\n  \u003e after a if statement need to put endif to declare a stop for statement.\n* exit\n\u003e stop the script\n\n## all key_name available\n* a, b, c, ...: individual letter keys\n\n* 1, 2, 3, ...: number keys\n\n* F1, F2, F3, ...: function keys\n\n* space: spacebar\n\n* enter: enter key\n\n* tab: tab key\n\n* shift: Shift key\n\n* ctrl: Ctrl key\n\n* alt: Alt key\n\n* caps lock: Caps Lock key\n\n* esc: Escape key\n\n* backspace: backspace key\n\n* delete: delete key\n\n* home: Home key\n\n* end: End key\n\n* page up: Page Up key\n\n* page down: Page Down key\n\n* left arrow: left arrow key\n\n* right arrow: right arrow key\n\n* up arrow: up arrow key\n\n* down arrow: down arrow key\n\n## Log\n### Ver0.1\n* Feature:\n  * GUI\n    * edit file\n    * load and save\n    * run and stop\n  * Basic Syntax\n    * loop\n    * if statement\n    * press\n    * move\n    * sleep\n    * exit\n  * Load file\n  * Save file\n### Ver0.2\n* [Online IDE](https://jingshing.com/auto_tool_ide/)\n* Feature:\n  * edit: loop end to endloop\n  * remove input box in gui\n\n## TODO\n- [X] if else: to detect image and to do something\n- [ ] count\n- [ ] not bool\n- [ ] record\n- [ ] support excel\n- [x] gui\n- [ ] generate instruction file\n- [x] comment\n- [ ] run other file\n- [ ] jump\n- [ ] exec\n- [x] ide\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjingshing-python%2Fauto_mouse_key_tool_py","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjingshing-python%2Fauto_mouse_key_tool_py","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjingshing-python%2Fauto_mouse_key_tool_py/lists"}