Cursory (TypeScript Version)

Original Library by Vinyzu for Python

Generate 100% human-realistic Mouse Trajectories with Timings.

Installation

npm install cursory

Basic Usage

import { generateTrajectory, Point } from 'cursory';

const targetStart: Point = [100, 100];
const targetEnd: Point = [500, 500];

const { points, timings } = generateTrajectory(targetStart, targetEnd);

console.log('Points:', points);
console.log('Timings:', timings);

API

generateTrajectory(targetStart, targetEnd, frequency?, frequencyRandomizer?)

Generate a realistic mouse trajectory from start to end points.

Parameters:

• targetStart: Point - Starting point of the trajectory
• targetEnd: Point - Ending point of the trajectory
• frequency?: number - Number of samples per second (hz). Defaults to 60
• frequencyRandomizer?: number - Max jitter in ms to apply to each sample time. Defaults to 1

Returns:

{
  points: Point[];  // List of points representing the trajectory
  timings: number[]; // List of timings (in ms) corresponding to each point
}

Types

type Point = [number, number];

interface TrajectoryResult {
  points: Point[];
  timings: number[];
}

Examples

See the examples directory for usage examples with various browser automation tools.