Take Control of YouTube Hotkeys

Stop accidental keyboard shortcuts. Block distracting hotkeys while keeping the ones you need with fine-grained control.

🧩 Browser Extension 📜 Userscript View on GitHub

Why You'll Love It

⚙️

Fine-Grained Control

Individually toggle each hotkey. Enable only what you need, disable everything else.

🎯

Smart Detection

Won't block keys while you're typing in search, comments, or chat. Intelligent input detection.

💾

Persistent Settings

Your preferences are saved locally. No accounts, no cloud storage, no privacy concerns.

🎨

Beautiful UI

Modern settings modal integrated seamlessly into YouTube's player interface.

⚡

Zero Performance Impact

Lightweight and optimized. Minimal memory footprint. Lightning-fast response.

🧩

Two Install Options

Install as a native browser extension (Chrome, Firefox, Edge) or as a userscript via Tampermonkey — your choice.

Available Hotkeys

0 - 9

Numbers

Jump to timeline percentage

SPACE

Spacebar

Play/Pause

↑ ↓ ← →

Arrow Keys

Navigation in comments/timeline

CTRL + ←

Control + Left

Previous chapter

CTRL + →

Control + Right

Next chapter

F

F Key

Fullscreen toggle

M

M Key

Mute/Unmute

SHIFT + < or >

Shift + Less / Greater

Playback speed control

. ,

Period/Comma

Frame-by-frame navigation

📚 Our Codebase

Clean, well-organized, and production-ready code built with modern JavaScript and best practices

📜

Userscript Core

The heart of the extension. Handles all keyboard event detection, settings management, and modal UI.

693
Lines
31+
Hotkeys
v5.0.0
Latest
⚙️

Settings Engine

Robust settings persistence using GM_getValue/GM_setValue with intelligent merge logic and defaults.

31
Toggles
100%
Persistent
Auto
Save
⚡

Event Handler

Triple-event listener system (keydown/keypress/keyup) with intelligent hotkey detection and blocking.

3
Events
158
Lines
4+
Detections
🎨

Modal UI System

Professional settings modal with expandable sections, smooth animations, and real-time feedback.

121
Lines
11+20
Options
Responsive
Design
🔘

Button Injection

Smart DOM injection with multi-selector fallbacks, SPA event detection, and exponential backoff retry.

5+
Selectors
Auto
Retry
100%
Reliable
🎭

Professional Styling

Embedded CSS with YouTube-matched dark theme, smooth transitions, and accessibility features.

500+
CSS Lines
Dark
Theme
A11y
Ready
📊

Code Statistics & Features

📝

Total Lines of Code

693 lines of well-organized, commented code

🎯

Hotkey Coverage

31 independent keyboard shortcuts supported

⚡

Performance

Optimized event handling with minimal overhead

🔒

Security

No data collection, fully open-source on GitHub

🌐

Compatibility

Works with Tampermonkey, Greasemonkey, Violentmonkey

📦

Package Management

npm scripts + automated version management

✅

Testing & Validation

All features tested, verified for edge cases

📚

Documentation

Comprehensive guides, API docs, inline comments

👨‍💻 Want to Contribute or Review the Code?

The entire codebase is open-source and available on GitHub. We welcome contributions, bug reports, and feature requests!

View on GitHub →

Live Settings Demo

Hotkey Settings
Disable Numbers (0–9)
Disable Spacebar
Disable Arrow Keys
Disable Ctrl + Left
Disable Ctrl + Right
Disable "F" (Fullscreen)
Disable "M" (Mute)
Disable Speed (Shift+<>)
Disable Frame Skip (./,)
Disable Play/Pause (K)
Disable Theatre Mode (T)
Disable Captions (C)

Quick Installation

Native extension — no userscript manager needed. Works on Chrome, Firefox, and Edge.

Chrome Chrome / Edge Download ZIP Firefox Firefox Download ZIP

🔜 Store submissions for Chrome Web Store, Firefox AMO, and Edge Add-ons are in progress.

Manual Sideload Steps

1

Download ZIP

Get the latest release from GitHub Releases

2

Load Unpacked

Chrome/Edge: chrome://extensions → Developer Mode → Load unpacked.
Firefox: about:debugging → Load Temporary Add-on

3

Go to YouTube

The extension activates automatically on all YouTube pages

4

Configure

Click the toolbar icon or press Alt+Shift+H to open settings

Runs via a userscript manager. Works in any browser that supports Tampermonkey, Greasemonkey, or Violentmonkey.

Greasy Fork Install from Greasy Fork
1

Install Manager

Get Tampermonkey, Greasemonkey, or Violentmonkey from your browser's extension store

2

Click Install

Use the Greasy Fork button above or the direct GitHub link

3

Go to YouTube

Visit youtube.com and look for the keyboard icon ⌨️ in the player controls

4

Configure

Click the icon to open settings and customize your hotkeys

Supported Browsers

Chrome
Firefox
Edge
And Others..
Supported Userscript Managers
GreasyFork Logo
GreasyFork
Tampermonkey Tampermonkey
Tampermonkey
Greasemonkey
Violentmonkey

Frequently Asked Questions

What's a userscript? ▼
A userscript is a small JavaScript program that runs on websites to customize their behavior. Think of it as a lightweight browser extension. You need a userscript manager (like Tampermonkey) to run them.
Is this safe? ▼
Absolutely! The script is open-source on GitHub, so anyone can review the code. It only modifies YouTube's behavior on your machine and doesn't send any data anywhere. All settings are stored locally in your browser.
Will this work with dark mode? ▼
Yes! The settings modal is designed to match YouTube's dark interface perfectly. It works seamlessly whether YouTube is in light or dark mode.
Can I use this on mobile? ▼
Most mobile browsers don't support userscript managers yet. However, you can use it on mobile browsers like Firefox for Android which has userscript support through Tampermonkey.
My settings disappeared! ▼
Settings are stored in your browser's local storage. If you clear your browser data or cookies, settings may be lost. Try disabling any privacy/tracking prevention settings for YouTube.
Can I contribute or report bugs? ▼
Absolutely! Visit the GitHub Issues page to report bugs or suggest features. Pull requests are welcome!
How often is it updated? ▼
Actively maintained — updates are released when bugs are fixed or new features are added. Greasy Fork userscript installs check for updates daily automatically. Extension users will receive updates via the browser store once submissions are approved.
Extension vs userscript — which is better? ▼
Both have identical hotkey-blocking functionality. The browser extension requires no extra software and opens settings with Alt+Shift+H. The userscript needs a manager like Tampermonkey but benefits from automatic daily updates via Greasy Fork. Choose whichever fits your workflow.