📐 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:

1. 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.
2. 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.
3. Add Noise: The Trajectory is jittered and knotted, to alter positions slightly to avoid fingerprinting by hash-fingerprinting.
4. Regenerating with Timings: The Trajectory is regenerated using the Trajectory Frequency, with some noise added to the timings to avoid.
5. Re-Add Noise: The Trajectory is jittered and knotted, to alter positions slightly to avoid fingerprinting by hash-fingerprinting.
6. 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

© Vinyzu
GNU GPL

(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.