Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/alganzory/HaramBlur
A Browser extension that enables you to navigate the web with respect for your Islamic values, protect your privacy and reduce browsing distractions by auto detecting and blurring "Haram" content.
https://github.com/alganzory/HaramBlur
browser-extension chrome-extension detection face-detection face-recognition filter gender-classification islamic nsfw-detection nsfwjs nudity-detection
Last synced: 10 days ago
JSON representation
A Browser extension that enables you to navigate the web with respect for your Islamic values, protect your privacy and reduce browsing distractions by auto detecting and blurring "Haram" content.
- Host: GitHub
- URL: https://github.com/alganzory/HaramBlur
- Owner: alganzory
- License: agpl-3.0
- Created: 2023-09-22T17:28:25.000Z (about 1 year ago)
- Default Branch: main
- Last Pushed: 2024-07-11T10:15:17.000Z (4 months ago)
- Last Synced: 2024-08-01T14:02:41.652Z (3 months ago)
- Topics: browser-extension, chrome-extension, detection, face-detection, face-recognition, filter, gender-classification, islamic, nsfw-detection, nsfwjs, nudity-detection
- Language: JavaScript
- Homepage: https://haramblur.com
- Size: 93.6 MB
- Stars: 392
- Watchers: 9
- Forks: 30
- Open Issues: 38
-
Metadata Files:
- Readme: README.MD
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-egypt-opensource - HaramBlur
README
# HaramBlur Extension
HaramBlur is a browser extension that allows you to navigate the web with respect for your Islamic values, privacy and reduce browsing distractions.
HaramBlur utilizes face detection and NSFW content detection and provides controls that allow you to uphold the Islamic gaze protection principle and tailor your online experience by automatically blurring images and videos that contain unwanted or impermissible content.
You can configure the type of detection you want and the amount of blur, the level of strictness, hover to unblur, choose a specific gender to blur, or turn the extension on and off via the interactive pop-up 😄
## Features
- Works on images and videos that contain unwanted or impermissible content
- Works on most (if not all) websites and social media platforms
- Configurable detection settings to tailor your browsing experience
- Interactive pop-up for easy on/off toggling
- Customizable hover to unblur feature
- Decent speed and accuracy (continously improved)
## How it Works
HaramBlur currently used face detection and recognition features provided by [Human library](https://github.com/vladmandic/human) to detect faces and blur them based on the user settings and preferences. It also uses NSFW detection provided by [nsfwjs](https://github.com/infinitered/nsfwjs/) to further improve the accuracy. You can configure the type of detection you want and the amount of blur, hover to unblur, or turn the extension on and off via the interactive pop-up.
# Installation Guide
## Option 1: Using the Plugin from the extensions store
1. Visit the [Haramblur extension on the Chrome Web Store](https://chrome.google.com/webstore/detail/haramblur/pbcoegikffnadpahojjhgdladmmddeji) or the [Firefox Add-ons Store](https://addons.mozilla.org/addon/haramblur/)
2. Follow the installation instructions on the page.
## Option 2: Compiling it On Your Own
If you want to compile the extension on your own, follow these steps:
### Step 1: Clone the Repository
Clone the HaramBlur repository to your local machine:
#### Chromium
```bash
git clone https://github.com/alganzory/HaramBlur.git
```
### Firefox
```bash
git clone -b firefox-main --single-branch https://github.com/alganzory/HaramBlur.git
```
### Step 2: Install Dependencies
Navigate to the project directory and install the necessary dependencies:
```bash
npm install
```
### Step 3: Code Your Magic
Make the necessary modifications or enhancements to the code.
### Step 4: Build the Extension
- Build the extension by running:
```bash
npm run build
```
### Step 5: Generate a Release (Optional)
Generate a release zip file to be uploaded to the browser/store:
```bash
npm run release
```
### Load the extension in Chromium browsers
- Go to `chrome://extensions/`.
- Enable "Developer mode".
- Click "Load unpacked" and select the project folder.
### Load the extension in Firefox
- Go to `about:addons`
- Press the gear icon.
- Click "Install Add-on from file"
- Select the zip file that you generated in Step 5.
## Improvements
Here are some planned improvements that could be made to HaramBlur:
- Support for more browsers
- Improve the speed of detection
- Improve the accuracy of NSFW detection to reduce false positives and negatives
- Make the extension more Shariah-compliant by adding additional privacy controls and customization options
## Open Source
HaramBlur is an open-source project and I really appreciate any contributions. Feel free to open an issue or submit a pull request if you have any suggestions or improvements you would like to see.
## Like the project?
If you like the project, please consider giving it a star ⭐️. If you wanna further support me, [buy me a coffee ☕️](https://www.buymeacoffee.com/alganzory), thank you! 😊
Don't forget us from your Du'a! 🤲