📐 Cursory
Cursory - Mouse Trajectory Factory. Generate 100% human-realistic Mouse Trajectories with Timings.
Install it from PyPI
pip install cursory
Basic Usage
from cursory import generate_trajectory
trajectory: list[tuple[float, float]]
timings: list[int]
trajectory, timings = generate_trajectory(target_start=..., target_end=...)
Example Trajectories
| Random Points | Same Points | Points / Velocity |
|---|---|---|
 |
 |
 |
Methodology
Cursory generates Mouse Trajectories following these steps:
- Find a close matching human Trajectory: Cursory has a database of thousands of Trajectories recorded from real humans. It finds the closest matching Trajectory to the target Points with some amount of randomization.
- Morph the Trajectory: The Trajectory is morphed to fit the target Points exactly, while keeping the overall shape as close to the original as possible.
- Add Noise: The Trajectory is jittered and knotted, to alter positions slightly to avoid fingerprinting by hash-fingerprinting.
- Regenerating with Timings: The Trajectory is regenerated using the Trajectory Frequency, with some noise added to the timings to avoid.
- Re-Add Noise: The Trajectory is jittered and knotted, to alter positions slightly to avoid fingerprinting by hash-fingerprinting.
- Morph the Trajectory: The Trajectory is morphed to fit the target Points exactly, while keeping the overall shape to the original as possible.
[!WARNING]
Theoretically, it is possible to detect/fingerprint Mouse Trajectories generated by Cursory. But this would require an amount of compute power which is unfeasible. A greater risk of detection would be bad Trajectories, which is mitigated by the advanced algorithms used by Cursory.
Copyright and License
(Commercial Usage is allowed, but source, license and copyright has to made available. Cursory does not provide and Liability or Warranty)
Thanks to
Pointergeist (For helping me understand Mouse Trajectories better).
sameelarif (For his awesome work on Scribe)
Margit Antal, Norbert Fejer, Krisztian Buza (For their work on SapiMouse)
MIMIC-LOGICS (For their Mouse-Synthesizer)
Disclaimer
This repository is provided for educational purposes only.
No warranties are provided regarding accuracy, completeness, or suitability for any purpose. Use at your own risk—the authors and maintainers assume no liability for any damages, legal issues, or warranty breaches resulting from use, modification, or distribution of this code.
Any misuse or legal violations are the sole responsibility of the user.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file cursory-2.0.0.tar.gz.
File metadata
- Download URL: cursory-2.0.0.tar.gz
- Upload date:
- Size: 668.3 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bcf064948a8297446b8737dad286bdceb92522c7643781f3988c3bc11d058fe0
|
|
| MD5 |
f91e889b013d73225c8dc3d032bce481
|
|
| BLAKE2b-256 |
1fcb4247026545d2a351de0e737df29fabb0831575eb2d7a739d84fa4a2f7ea9
|
Provenance
The following attestation bundles were made for cursory-2.0.0.tar.gz:
Publisher:
publish.yml on Vinyzu/cursory
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cursory-2.0.0.tar.gz -
Subject digest:
bcf064948a8297446b8737dad286bdceb92522c7643781f3988c3bc11d058fe0 - Sigstore transparency entry: 2758848412
- Sigstore integration time:
-
Permalink:
Vinyzu/cursory@f7104d6cb5279e8e3ee397c34e5fa895bfe38908 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Vinyzu
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f7104d6cb5279e8e3ee397c34e5fa895bfe38908 -
Trigger Event:
workflow_dispatch
-
Statement type:
File details
Details for the file cursory-2.0.0-py3-none-any.whl.
File metadata
- Download URL: cursory-2.0.0-py3-none-any.whl
- Upload date:
- Size: 661.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
142013f6bdb5f905b76c24955a167901a12580e87589a8de599d1007f7908e38
|
|
| MD5 |
ed29377081c46ef9ac6945203f393d1b
|
|
| BLAKE2b-256 |
10205da4e2c304aca1f6bf82a6b9bcf8270c342ef51bde0a342467dc9b993da2
|
Provenance
The following attestation bundles were made for cursory-2.0.0-py3-none-any.whl:
Publisher:
publish.yml on Vinyzu/cursory
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
cursory-2.0.0-py3-none-any.whl -
Subject digest:
142013f6bdb5f905b76c24955a167901a12580e87589a8de599d1007f7908e38 - Sigstore transparency entry: 2758848507
- Sigstore integration time:
-
Permalink:
Vinyzu/cursory@f7104d6cb5279e8e3ee397c34e5fa895bfe38908 -
Branch / Tag:
refs/heads/main - Owner: https://github.com/Vinyzu
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@f7104d6cb5279e8e3ee397c34e5fa895bfe38908 -
Trigger Event:
workflow_dispatch
-
Statement type:
