How to Contribute
We welcome contributions from the community to help improve BlackWeb and expand its coverage of malicious domains.Submission Process
Changes must be proposed via Issues. Pull Requests are not accepted.
Contributing New Lists
If you know of public blocklists that are not currently included in BlackWeb, you can help by:-
Verify the List Quality
- Ensure the list is publicly accessible
- Confirm it contains relevant blocked domains (malware, phishing, ads, trackers, etc.)
- Check that it’s actively maintained
-
Submit via GitHub Issues
- Go to the BlackWeb Issues page
- Create a new issue with the title: “New Blocklist Suggestion: [List Name]”
- Include the following information:
- URL of the blocklist
- Description of what domains it covers
- Maintainer information (if available)
- Update frequency (if known)
-
Wait for Review
- The project maintainers will review your submission
- They may request additional information
- If approved, the list will be added in the next update
Reporting Issues
If you encounter problems with BlackWeb, please report them via GitHub Issues:- False Positives: If legitimate domains are being blocked
- Technical Issues: Problems with installation or usage
- Documentation: Errors or unclear instructions
Acknowledgments
We thank all those who have contributed to this project by:- Suggesting new blocklist sources
- Reporting issues and improvements
- Testing and providing feedback
- Supporting the project
Special Thanks
Special thanks to: Jhonatan Sneider for his valuable contributions to the project.Community Guidelines
When contributing, please:- Be respectful and professional
- Provide clear and detailed information
- Follow the submission process outlined above
- Be patient during the review process
What We’re Looking For
Ideal contributions include:Quality Blocklists
Well-maintained public blocklists with clear categorization
Bug Reports
Detailed reports of technical issues with reproduction steps
Documentation
Suggestions for improving clarity and usability
Use Cases
Real-world deployment experiences and feedback
Support the Project
If you find BlackWeb useful and want to support its continued development, consider sponsoring the project:
Your support helps maintain and improve BlackWeb for the entire community.