-
Notifications
You must be signed in to change notification settings - Fork 516
Description
On a fresh installation of Tampermonkey, the dashboard displays the banner:
“Developer mode is required. Please enable developer mode in chrome://extensions.”
However, enabling Chrome’s Developer Mode does not resolve the warning.
The actual missing permission is Chrome’s “Allow user scripts” toggle under the Tampermonkey extension entry — but Tampermonkey does not mention this at all.
This occurs consistently on first install and also when Tampermonkey is installed via Chrome Sync on another device.
Steps to Reproduce
Install Tampermonkey in a fresh Chrome profile OR allow Chrome Sync to auto-install it on a second device.
Open the Tampermonkey Dashboard.
A banner appears:
“Developer mode is required. Please enable developer mode in chrome://extensions.”
Go to chrome://extensions and enable Developer Mode.
Return to Tampermonkey — the warning remains.
Only after navigating to the Tampermonkey extension entry and enabling “Allow user scripts” does the warning disappear and scripts start injecting.
Expected Behavior
Tampermonkey should:
Detect when “Allow user scripts” is disabled,
Inform the user that this permission is required, or
Update the banner to mention the missing permission explicitly.
Actual Behavior
Tampermonkey shows a misleading banner about Chrome Developer Mode, which is already enabled.
It never mentions the crucial “Allow user scripts” permission.
As a result, users believe Developer Mode isn't working and think Tampermonkey is broken.
User scripts silently fail to inject until the user discovers this toggle manually.
Impact
Users cannot run any user scripts.
The message causes confusion because the wrong setting is referenced.
This affects every fresh install and machines receiving Tampermonkey via Chrome Sync.
Suggested Fix
Amend the banner to:
“Please enable Chrome’s ‘Allow user scripts’ permission for Tampermonkey in chrome://extensions.”
Or auto-detect and show a more specific error when that permission is disabled.
Environment
Chrome version: Version 142.0.7444.175 (Official Build) (64-bit)
OS: Windonws11 and OS X
Tampermonkey version: 5.4.1
Installed normally or via Chrome Sync: Both