{"id":28655981,"url":"https://github.com/sarperavci/human_mouse","last_synced_at":"2025-06-13T08:09:39.041Z","repository":{"id":271922360,"uuid":"915003833","full_name":"sarperavci/human_mouse","owner":"sarperavci","description":"🎯 Ultra-realistic human mouse movements using bezier curves and spline interpolation. Natural cursor automation.","archived":false,"fork":false,"pushed_at":"2025-05-01T01:20:18.000Z","size":12,"stargazers_count":30,"open_issues_count":0,"forks_count":5,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-06-04T02:58:05.214Z","etag":null,"topics":["automation","bezier-curves","human-mouse","mouse","mousemove","web-automation"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sarperavci.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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,"zenodo":null}},"created_at":"2025-01-10T18:56:40.000Z","updated_at":"2025-05-31T20:45:06.000Z","dependencies_parsed_at":"2025-05-01T02:25:02.370Z","dependency_job_id":"5ebadd4f-6f86-4a01-ad69-5b5d9c82d6d1","html_url":"https://github.com/sarperavci/human_mouse","commit_stats":null,"previous_names":["sarperavci/human_mouse"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/sarperavci/human_mouse","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarperavci%2Fhuman_mouse","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarperavci%2Fhuman_mouse/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarperavci%2Fhuman_mouse/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarperavci%2Fhuman_mouse/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sarperavci","download_url":"https://codeload.github.com/sarperavci/human_mouse/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sarperavci%2Fhuman_mouse/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259606977,"owners_count":22883562,"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":["automation","bezier-curves","human-mouse","mouse","mousemove","web-automation"],"created_at":"2025-06-13T08:09:32.175Z","updated_at":"2025-06-13T08:09:39.021Z","avatar_url":"https://github.com/sarperavci.png","language":"Python","readme":"# Human Mouse 🖱️\n\n🎯 Human-like mouse movements powered by bezier curves and spline interpolation. Ultra-realistic cursor automation.\n\n[![PyPI version](https://badge.fury.io/py/human-mouse.svg)](https://badge.fury.io/py/human-mouse)\n[![Python 3.10+](https://img.shields.io/badge/python-3.10+-blue.svg)](https://www.python.org/downloads/)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Overview\n\nHuman Mouse is a sophisticated Python package that generates ultra-realistic mouse movements by implementing advanced mathematical algorithms. It uses a combination of bezier curves and spline interpolation to create smooth, natural-looking cursor trajectories that closely mimic human behavior.\n\n## Installation\n\n```bash\npip install human-mouse\n```\n\n## Core Functions \u0026 Examples\n\n### Basic Movement\n\nMove cursor to specific coordinates with natural trajectory\n\n```python\nmouse = MouseController()\nmouse.move(500, 300)  # Move to coordinates\nmouse.move(800, 600, speed_factor=0.5)  # Move faster\n```\n\n### Random Movement\n\nMove to a random screen position using human-like patterns\n\n```python\nmouse.move_random()  # Move to random position\nmouse.move_random(speed_factor=2.0)  # Slower random movement\n```\n\n### Click Operations\n    \nExecute a single click\n\n```python\nmouse.perform_click(500, 300)  # Move and click\n```\n\nNatural double click\n```python\nmouse.perform_double_click(500, 300)  # Move and double click\n```\n\nRight-click action\n```python\nmouse.perform_context_click(500, 300)  # Move and right click\n```\n\n### Movement Patterns\n\nEnable zigzag movements for more natural patterns\n```python\nzigzag_mouse = MouseController(always_zigzag=True)\nzigzag_mouse.move(500, 300)\n```\n\n### Virtual Display Support\n\nLinux virtual display support\n```python\nvirtual_mouse = MouseController(is_virtual=True)\nvirtual_mouse.move(500, 300)\n```\n\n## Advanced Features\n\n### Movement Patterns\n- Bezier curve interpolation for smooth trajectories\n- Spline-based path generation\n- Randomized movement variance\n- Natural acceleration/deceleration\n- Configurable zigzag patterns\n\n### Platform Support\n- Windows: Full native support\n- macOS: Full native support\n- Linux: Supports both native and virtual displays\n\n## Complete Example\n\n```python\nfrom human_mouse import MouseController\nimport time\n\n# Initialize controller\nmouse = MouseController(always_zigzag=True)\n\n# Perform series of actions\nmouse.move(500, 300)  # Move to position\ntime.sleep(0.5)  # Wait briefly\nmouse.perform_click()  # Click\ntime.sleep(0.5)  # Wait briefly\nmouse.move_random()  # Move to random position\nmouse.perform_double_click()  # Double click\n```\n\n## Technical Requirements\n\n- Python 3.10+\n- Dependencies:\n  - numpy\n  - pyautogui\n  - scipy\n  - python-xlib (optional, for Linux virtual display)\n\n## Contributing\n\nWe welcome contributions! Please feel free to submit pull requests.\n\n## License\n\nMIT License - see the LICENSE file for details.\n\n## Support\n\n- Issues: [GitHub Issues](https://github.com/sarperavci/human_mouse/issues)\n\n## Random Move Demo\n\nhttps://github.com/user-attachments/assets/fa5b900b-01c3-4312-819c-1f558005b54e","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsarperavci%2Fhuman_mouse","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsarperavci%2Fhuman_mouse","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsarperavci%2Fhuman_mouse/lists"}