How jose-alba/stealth_mouse works
Stealth Mouse records human mouse gestures, retrieves a matching recorded path for a requested movement, transforms and interpolates it, then dispatches movement and (for native use) clicks. The README also describes interactive target verification and browser automation. Recorder and playback wiring is supported by the sampled source; browser support is documented and partly visible in the player, but its integration is not fully sampled.
Main entry points: player.py Movement player · indexer.py Trajectory lookup · recorder.py Gesture recorder · example.py Target practice UI
Components 13
Gesture capture
- Gesture recorder
src/recorder.py - Trajectory index
data/trajectories_index.npz - Coordinate bank
data/trajectories_points.npz
Trajectory playback
- Move / click API
main.py - Movement player
src/player.py - Trajectory lookup
src/indexer.py - Path transform
src/transformer.py - Spline sampling
src/interpolator.py
Input dispatch
- Native mouse
- Browser page
Visual verification
- Target practice UI
example.py - Desktop display
Other components
- User / caller
Connections 18
- User / caller → Move / click API: requests move/click
- Move / click API → Movement player: calls
- Movement player → Native mouse: reads position
- Movement player → Trajectory lookup: queries candidates
- Trajectory lookup → Trajectory index: loads descriptors
- Trajectory lookup → Coordinate bank: loads points
- Trajectory lookup → Movement player: returns match
- Movement player → Path transform: transforms path
- Movement player → Spline sampling: samples path
- Movement player → Native mouse: dispatches movement/click
- Movement player → Browser page: dispatches async input
- User / caller → Gesture recorder: starts recording
- Native mouse → Gesture recorder: sends events
- Gesture recorder → Trajectory index: writes index
- Gesture recorder → Coordinate bank: writes coordinates
- User / caller → Target practice UI: runs verification
- Target practice UI → Move / click API: calls click
- Target practice UI → Desktop display: draws targets/status