https://testflight.apple.com/join/1t5HfEGS
Tip
WebShield is a wide-spectrum content blocker, akin to uBlock Origin, specifically for Safari.
Important
Note: WebShield is currently in a beta stage of maturity. Features and documentation are subject to change as we continue to develop and improve the project.
WebShield can block ads, trackers, cookie notices, and more. You can also import custom filter lists. WebShield supports Safari's Content Blocking API as well as scriptlets & extended css for more advanced, targeted blocking.
These requirements are tentative and due to change. I will try to support older OSes as much as I can.
- macOS 14 or later
- iOS 17 or later
- visionOS 1.3 or later
- Download & install WebShield from TestFlight
- (macOS) Open Safari and navigate to Settings > Extensions; (iOS) Open Settings > Safari > Extensions
- Enable all "WebShield" extensions
- (macOS) Go to Websites (in Safai Settings) > "WebShield Advanced"
- (macOS) Change "For other websites" to "Allow"
- (iOS) Go to "WebShield Advanced" (in Settings > Safari > Extensions)
- (iOS) Change "All Websites" to "Allow"
An App Store release will happen when we reach a stable level of maturity.
For developers and advanced users who want to build from source:
- Clone the repository:
git clone https://github.com/WebShieldApp/WebShield.git
- Open the project in Xcode and build the app for your platform.
- Follow platform-specific steps for enabling the extension in Safari.
Note: Detailed installation instructions will be added once the project reaches a stable release.
There will be documentation on usage soon.
We welcome contributions to WebShield! Here's how you can help:
- Bug Reports & Feature Requests: Use the GitHub Issues to report bugs or request features.
- Code Contributions: Fork the repository, create a feature branch, and submit a pull request.
- Documentation Improvements: Found a typo or have better wording suggestions? Feel free to submit a PR!
For detailed guidelines, please see our CONTRIBUTING.md file for details on how to get started.
This project is licensed under the GNU GPLv3 License - see the LICENSE file for details.
If you need help or have any questions, you can reach out through:
WebShield draws inspiration from privacy and performance-focused projects like uBlock Origin. This project wouldn't be possible without the dedication of filter list maintainers who work tirelessly to keep the web clean. I'm deeply grateful to stand on the shoulders of these projects and their contributors. Special thanks to AdGuard, whose tools — particularly SafariConverterLib and Scriptlets/ExtendedCSS — have been instrumental to WebShield's development. I'd also like to thank @0xCube for our ongoing collaboration and the valuable connection between our projects.
If you would like to thank me for building WebShield here are a few links:
Happy browsing! 🛡️