https://github.com/mondeja/hackinguis
Tools to performs human-like user inputs to develop GUI hacking
https://github.com/mondeja/hackinguis
Last synced: 8 months ago
JSON representation
Tools to performs human-like user inputs to develop GUI hacking
- Host: GitHub
- URL: https://github.com/mondeja/hackinguis
- Owner: mondeja
- Created: 2017-11-05T23:58:06.000Z (almost 8 years ago)
- Default Branch: master
- Last Pushed: 2017-11-06T10:10:18.000Z (almost 8 years ago)
- Last Synced: 2025-02-13T20:17:53.649Z (8 months ago)
- Language: Python
- Size: 7.63 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Hackinguis
Hackinguis is a Python library that allows to develop scripts for interact with user graphical interfaces. It is formed by a series of modules that meet the following characteristics:
- Human aspect of behavior.
- Robust, fast and effective.
- Easy to develop.
- Multiplatform.
## Requirements
You need to install [autopy's requirements](https://github.com/msanders/autopy).
## Installation
```
git clone https://github.com/mondeja/hackinguis.git
cd hackinguis
pip install -r requirements.txt
python setup.py install
```
_________________________________________________________
## Documentation
### Human Mouse
```python
from hackinguis import HumanMouse
hm = HumanMouse()
"""
This class has the following optional parameters:
:param mouse_speed: Mouse velocity
(optional, default == 18)
:type mouse_speed: int/float
:param gravity: If the number is larger,
grater uniformity of movement
(optional, default == 60)
:type gravity: inf/float
:param wind: aleatority of movement
(optional, default == 60)
:type wind: int/float
:param target_error: Error in target
objetive (optional, default == 500)
before achieve it without error
:type target_error: int/float
"""
hm.move(, ) # Human-like movement
hm.click(, ) # Human-like movement and click
hm.double_click(, ) # Human-like movement and double click
```
### Virtual mouse
These are the fastest functions tested for working with machine-like mouse behavior ([autopy mouse reference](http://www.autopy.org/documentation/api-reference/mouse.html)).
```python
from autopy_mouse import mouse
mouse.click(, ) # Click without previous movement
mouse.move(, ) # Mouse teleportation
mouse.get_pos() # Get current mouse position
mouse.toggle() # Holds down (True) or releases (False) mouse
mouse.smooth_move(, ) # Mouse movement in a straight line
# ==========================================================
from pymouse import PyMouse
m = PyMouse()
m.scroll(vertical=, # Mouse scroll a number of times,
horizontal=) # parameters are None by default
m.screen_size() # Gets (width, height) of your screen
```