Code Monkey home page Code Monkey logo

haramblur's Introduction

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 ๐Ÿ˜„

HaramBlur Demo

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 to detect faces and blur them based on the user settings and preferences. It also uses NSFW detection provided by 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 or the Firefox Add-ons Store

  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

git clone https://github.com/alganzory/HaramBlur.git

Firefox

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:

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:
    npm run build

Step 5: Generate a Release (Optional)

Generate a release zip file to be uploaded to the browser/store:

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 โ˜•๏ธ, thank you! ๐Ÿ˜Š

Don't forget us from your Du'a! ๐Ÿคฒ

haramblur's People

Contributors

alganzory avatar anonfaded avatar marwenbk avatar themodmin avatar linuxjava7 avatar msabur avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.