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

Copyright and License

© Vinyzu
GNU LGPL

All Cursory versions are retroactively dual-licensed under LGPLv3-or-later and GPLv3-or-later.

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