https://github.com/mk2112/shroud
obfuscator for typing, scrolling, and timing behavior on websites
https://github.com/mk2112/shroud
behavioral-patterns javascript privacy-protection privacy-tools tampermonkey-userscript userscript violentmonkey-userscript
Last synced: 6 months ago
JSON representation
obfuscator for typing, scrolling, and timing behavior on websites
- Host: GitHub
- URL: https://github.com/mk2112/shroud
- Owner: MK2112
- License: mit
- Created: 2025-05-14T15:01:09.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-05-14T15:03:43.000Z (8 months ago)
- Last Synced: 2025-05-31T10:49:58.811Z (8 months ago)
- Topics: behavioral-patterns, javascript, privacy-protection, privacy-tools, tampermonkey-userscript, userscript, violentmonkey-userscript
- Language: JavaScript
- Homepage:
- Size: 2.93 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Shroud
A userscript limiting behavioral fingerprinting by obfuscating typing, scrolling, and timing behavior.
By introducing non-uniform jitter and subtle noise, *Shroud* prevents websites from accurately profiling users based on their behavioral patterns, while not compromising on UX.
## Features
- **Randomized Timing Jitter**: Introducing varying intensities of noise to timing functions (`performance.now()`, `Date.now()`, and `Date.prototype.getTime()`) to break predictable patterns
- **Dynamic Jitter Scaling**: Jitter intensity changes over time, making the script's actions harder to detect, denoise or filter
- **Scroll Fingerprinting Protection**: Subtle randomization of scroll positions, mitigating the risk of tracking based on scroll behavior
- **Typing Behavior Obfuscation**: Jitter introduced to typing timings to obscure typing patterns, enhancing privacy without affecting the user experience
## How It Works
The core of this userscript is a dynamic jitter generator, which introduces randomness in e.g. scroll behavior.
This ensures that each action is slightly different, preventing predictable timing patterns.
This would however be susceptible to denoising efforts.
Addressing this, periodically, the jitter is scaled to avoid repetitive patterns that could be recognized and mitigated by tracking systems.
## Limitations
Some websites may rely on precise timings for functionality. While this userscript minimizes perceivable impact, occasional issues may arise.
## License
MIT. See [LICENSE](LICENSE) for details.
This tool is a research project intended to showcase the obfuscation of timing and scrolling behavior.
It is not intended for applied use.