"I needed it. So I made it. It's useless — yet somehow incredibly useful."

— Harsh Vardhan Chopra

---

🤔 Why does this exist?

I was using Snapchat Web and realised it straight-up ignores arrow keys, Page Down, and even the middle mouse button scroll. There's no way to auto-scroll through stories without physically moving your scroll wheel every few seconds.

So I built this. It simulates the mouse wheel at the OS level, which means it works on any website, any browser, any app that blocks normal keyboard input. Set your speed, hit Start, switch to your browser, and forget about it. Move your mouse and it stops automatically.

Is it the most important tool ever built? No.
Will it save you from repetitive strain on Snapchat? Absolutely.

---

✨ Features

• 🖱️ Simulates middle-click wheel scroll — bypasses sites that block arrow keys
• 🛑 Auto-stops when you move your mouse — completely hands-free control
• ⌨️ Global hotkeys — work even when the browser is focused, not this app
• 🎛️ Fully customisable — speed, direction, ticks/sec, stop threshold, start delay
• 💾 Saves your settings — remembers everything across launches
• 💻 Laptop presets — safe hotkey suggestions per laptop model (HP, Dell, Lenovo, ASUS, Acer)
• 🪟 Always-on-top mode — float the window beside your browser
• 🔐 Auto admin request — asks for elevated privileges on launch for reliable hotkeys
• 🌍 Windows + Linux — one codebase, both platforms, no compromise

---

📸 Screenshot

┌─────────────────────────────────────────┐
│ ▌▌▌  AutoScroll              v2.1  [●]  │
│ Made by Harsh Vardhan Chopra | @HVCREALM│
├─────────────────────────────────────────┤
│ ✅ Scrolling  •  move mouse to stop  ▲  │
├─────────────────────────────────────────┤
│ ⌨ Global hotkeys active                 │
│ [Ctrl+F9] Start  [Ctrl+F10] Stop        │
│ [Ctrl+Alt+S] Toggle                     │
├──────────────[ Control ]──[ Hotkeys ]───┤
│ Scroll speed      ████░░░░  3           │
│ Ticks / second    ██████░░  15          │
│ Mouse stop (px)   ███░░░░░  6           │
│ Start delay (sec) ███░░░░░  3           │
│                                         │
│ Direction:  [▲ Up]  [▼ Down]            │
├─────────────────────────────────────────┤
│  [▶  Start]          [■  Stop]          │
└─────────────────────────────────────────┘

---

🚀 Quick Start

Option 1 — Run from source (recommended for developers)

# Clone the repo
git clone https://github.com/HVCREALM/AutoScroll.git
cd AutoScroll

# Install the one dependency
pip install pynput

# Run
python autoscroll.py

Option 2 — Download a pre-built release

Head to Releases and grab:

File	OS	Notes
AutoScroll.exe	Windows 10/11	No Python needed
AutoScroll	Linux (x64)	No Python needed

---

🏗️ Build It Yourself

Windows

:: Double-click this file, or run in cmd:
build_windows.bat

What it does automatically:

1. Checks Python is installed
2. Installs pynput + PyInstaller
3. Builds dist\AutoScroll.exe — single portable file, no install required
4. Embeds UAC admin request into the .exe

Linux

chmod +x build_linux.sh
./build_linux.sh

What it does automatically:

1. Detects your distro (apt / dnf / pacman / zypper)
2. Installs all system dependencies including python3-tk and polkit
3. Builds dist/AutoScroll — single portable binary
4. Creates a .desktop shortcut in your app menu
5. Installs a polkit policy for GUI sudo (no terminal popup)

---

⌨️ Hotkeys

All hotkeys are globally active — they work even when AutoScroll is minimised and your browser is in focus.

Hotkey	Action
Ctrl + F9	Start scrolling (with countdown delay)
Ctrl + F10	Stop scrolling immediately
Ctrl + Alt + S	Toggle start/stop (always works as backup)

All hotkeys are fully customisable from the Hotkeys tab inside the app.
You can pick any modifier + any F-key combination that doesn't conflict with your laptop's function row.

Built-in Laptop Presets

The app ships with presets that map safe hotkeys per laptop model, avoiding conflicts with media keys:

Laptop	Avoid	Safe keys
HP Victus 15-fb0	F7 (Vol−), F8 (Vol+)	Ctrl+F9 / Ctrl+F10
HP Pavilion / Envy	F6 (Mute), F7 (Vol−), F8 (Vol+)	Ctrl+F9 / Ctrl+F10
Dell XPS / Inspiron	F1 (Mute), F2 (Vol−), F3 (Vol+)	Ctrl+F8 / Ctrl+F9
Lenovo IdeaPad / Legion	F1 (Mute), F5 (Refresh)	Ctrl+F9 / Ctrl+F10
ASUS ROG / TUF	F10 (Mic), F11 (Vol−), F12 (Vol+)	Ctrl+F8 / Ctrl+F9
Acer Nitro / Aspire	F7 (Bright−), F8 (Bright+)	Ctrl+F9 / Ctrl+F10

---

🔐 Admin / Sudo

On launch, the app shows a dialog asking if you want elevated privileges.

┌─────────────────────────────────────────┐
│  AutoScroll — Admin Permission          │
│                                         │
│  AutoScroll works WITHOUT admin rights. │
│                                         │
│  However, global hotkeys work MORE      │
│  RELIABLY with administrator privileges.│
│                                         │
│  Do you want to restart with admin?     │
│  (You can say No — it still works fine) │
│                                         │
│        [ Yes ]        [ No ]            │
└─────────────────────────────────────────┘

Response	Result
Yes	Re-launches with UAC (Windows) or pkexec GUI dialog (Linux)
No	Continues normally — everything still works

No admin is required. It's offered because some systems restrict global keyboard hooks for non-admin processes.

---

⚙️ Settings Reference

Setting	Range	Default	Description
Scroll speed	1 – 20	3	How many scroll units per tick
Ticks / second	3 – 40	15	How often a scroll event fires
Mouse stop (px)	2 – 30	6	Pixels of mouse movement to trigger auto-stop
Start delay (sec)	0 – 10	3	Countdown before scrolling begins (gives you time to switch windows)
Direction	Up / Down	Up	Scroll direction
Window on top	On / Off	On	Keep AutoScroll floating above other windows

Settings are saved automatically to autoscroll_config.json next to the executable on every change and on close.

---

🖥️ Compatibility

OS	Status	Notes
Windows 10	✅ Full support
Windows 11	✅ Full support
Ubuntu 20.04 +	✅ Full support	X11
Debian 11 +	✅ Full support	X11
Fedora 36 +	✅ Full support	X11
Arch Linux	✅ Full support	X11
Linux (Wayland)	⚠️ Partial	Global hotkeys need xdotool
macOS	❌ Not supported	Not tested, not planned

---

📁 Repository Structure

AutoScroll/
├── autoscroll.py        ← Main application
├── build_windows.bat    ← Windows build script (PyInstaller)
├── build_linux.sh       ← Linux build script (PyInstaller)
├── README.md            ← You are here
├── LICENSE              ← MIT
└── autoscroll_config.json  ← Created at runtime (not committed)

---

🤝 Contributing

This project is open source and contributions are welcome — but let me be honest about how I'd prefer things work.

The easiest way to help

Just tell me the problem. Open an Issue describing what's broken or what you'd like. I'll look at it and fix it myself if I have time. That's genuinely more useful than a surprise PR landing in my inbox.

If you really want to submit a PR

I won't reject a good PR, but here's what I ask:

• Open an issue first — describe the problem before writing any code. Let's agree it's worth fixing.
• Keep changes focused. One problem = one PR.
• Don't refactor things that aren't broken.
• Test on at least one platform (Windows or Linux) before submitting.
• Write a clear description of what changed and why.

What I'm interested in

• Bug fixes (especially Linux / Wayland issues)
• New laptop presets (if your model has a different Fn key layout)
• macOS support (if someone wants to build and maintain it — I don't own a Mac)

What I'll probably say no to

• Complete UI rewrites
• Switching to a different GUI framework
• Adding network features or telemetry of any kind

---

📜 License

MIT — do whatever you want, just keep the credit line.

MIT License — Copyright (c) 2025 Harsh Vardhan Chopra (@HVCREALM)

---

👤 Author

Harsh Vardhan Chopra

@HVCREALM

Built this because I needed it. Sharing it because someone else might too.