Installation Steps
Step 1: Choose Your Browser
Shadow DOM Liberation works with all modern browsers. Select your browser below:
2 Install a Userscript Manager
You'll need a userscript manager to run Shadow DOM Liberation. We recommend:
⚠️ Important for Safari Users
Safari requires additional setup. You'll need to install the Userscripts app from the Mac App Store.
3 Install Shadow DOM Liberation
Click the button below to install the userscript:
Or install manually by copying this URL:
https://raw.githubusercontent.com/dcondrey/shadow-dom-liberation/main/shadow-dom-liberation.user.js
4 Verify Installation
After installation, verify that Shadow DOM Liberation is working:
- Look for the userscript manager icon in your browser toolbar
- Click it and check that "Shadow DOM Liberation" appears in the list
- Visit our demo page to test functionality
- The status indicator should show "Shadow DOM Liberation is active ✓"
5 Configuration (Optional)
Shadow DOM Liberation works out of the box, but you can customize its behavior:
Exclude Specific Sites
To disable the script on certain sites:
- Click your userscript manager icon
- Go to Dashboard → Shadow DOM Liberation → Settings
- Add URLs to the exclude list
Update Settings
The script updates automatically by default. To change update frequency:
- Open your userscript manager dashboard
- Find Shadow DOM Liberation
- Adjust update interval in settings
Troubleshooting
Some sites use advanced protection methods. Try:
- Refreshing the page
- Checking if the script is enabled for that site
- Reporting the issue on our GitHub page
Make sure:
- Your userscript manager is enabled
- You clicked "Install" when prompted
- The script URL ends with .user.js
- Try installing from the raw GitHub URL
Shadow DOM Liberation is designed to be lightweight. If you experience issues:
- Check if other scripts are conflicting
- Try disabling on sites where it's not needed
- Report performance issues with site details
Need Help?
If you're having trouble with installation or usage: