{"id":13463734,"url":"https://github.com/alganzory/HaramBlur","last_synced_at":"2025-03-25T09:31:09.920Z","repository":{"id":198965706,"uuid":"695250589","full_name":"alganzory/HaramBlur","owner":"alganzory","description":"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.","archived":false,"fork":false,"pushed_at":"2024-08-12T06:36:21.000Z","size":98100,"stargazers_count":835,"open_issues_count":34,"forks_count":54,"subscribers_count":21,"default_branch":"main","last_synced_at":"2025-03-19T12:17:25.874Z","etag":null,"topics":["browser-extension","chrome-extension","detection","face-detection","face-recognition","filter","gender-classification","islamic","nsfw-detection","nsfwjs","nudity-detection"],"latest_commit_sha":null,"homepage":"https://haramblur.com","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"agpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/alganzory.png","metadata":{"files":{"readme":"README.MD","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":["alganzory"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":["https://www.buymeacoffee.com/alganzory"]}},"created_at":"2023-09-22T17:28:25.000Z","updated_at":"2025-03-17T02:42:46.000Z","dependencies_parsed_at":"2023-10-14T18:47:20.439Z","dependency_job_id":"c96e00ee-8a9b-4d56-8177-6b0ac335a191","html_url":"https://github.com/alganzory/HaramBlur","commit_stats":null,"previous_names":["alganzory/humanblur","alganzory/haramblur"],"tags_count":8,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alganzory%2FHaramBlur","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alganzory%2FHaramBlur/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alganzory%2FHaramBlur/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/alganzory%2FHaramBlur/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/alganzory","download_url":"https://codeload.github.com/alganzory/HaramBlur/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":245435086,"owners_count":20614826,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["browser-extension","chrome-extension","detection","face-detection","face-recognition","filter","gender-classification","islamic","nsfw-detection","nsfwjs","nudity-detection"],"created_at":"2024-07-31T14:00:27.618Z","updated_at":"2025-03-25T09:31:04.909Z","avatar_url":"https://github.com/alganzory.png","language":"JavaScript","funding_links":["https://github.com/sponsors/alganzory","https://www.buymeacoffee.com/alganzory"],"categories":["Projects","Other (122 projects)"],"sub_categories":["Browser Extensions","JavaScript"],"readme":"# HaramBlur Extension\n\nHaramBlur is a browser extension that allows you to navigate the web with respect for your Islamic values, privacy and reduce browsing distractions.\n\nHaramBlur 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.\n\nYou 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 😄\n\n![HaramBlur Demo](demos/demo1.png)\n\n## Features\n\n-   Works on images and videos that contain unwanted or impermissible content\n-   Works on most (if not all) websites and social media platforms\n-   Configurable detection settings to tailor your browsing experience\n-   Interactive pop-up for easy on/off toggling\n-   Customizable hover to unblur feature\n-   Decent speed and accuracy (continously improved)\n\n## How it Works\n\nHaramBlur 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.\n\n# Installation Guide\n\n## Option 1: Using the Plugin from the extensions store\n\n1. 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/)\n\n2. Follow the installation instructions on the page.\n\n## Option 2: Compiling it On Your Own\n\nIf you want to compile the extension on your own, follow these steps:\n\n### Step 1: Clone the Repository\n\nClone the HaramBlur repository to your local machine:\n\n#### Chromium\n\n```bash\ngit clone https://github.com/alganzory/HaramBlur.git\n```\n\n### Firefox\n\n```bash\ngit clone -b firefox-main --single-branch https://github.com/alganzory/HaramBlur.git\n```\n\n### Step 2: Install Dependencies\n\nNavigate to the project directory and install the necessary dependencies:\n\n```bash\nnpm install\n```\n\n### Step 3: Code Your Magic\n\nMake the necessary modifications or enhancements to the code.\n\n### Step 4: Build the Extension\n\n-   Build the extension by running:\n    ```bash\n    npm run build\n    ```\n\n### Step 5: Generate a Release (Optional)\n\nGenerate a release zip file to be uploaded to the browser/store:\n\n```bash\nnpm run release\n```\n\n### Load the extension in Chromium browsers\n\n-   Go to `chrome://extensions/`.\n-   Enable \"Developer mode\".\n-   Click \"Load unpacked\" and select the project folder.\n\n### Load the extension in Firefox\n\n-   Go to `about:addons`\n-   Press the gear icon.\n-   Click \"Install Add-on from file\"\n-   Select the zip file that you generated in Step 5.\n\n## Improvements\n\nHere are some planned improvements that could be made to HaramBlur:\n\n-   Support for more browsers\n-   Improve the speed of detection\n-   Improve the accuracy of NSFW detection to reduce false positives and negatives\n-   Make the extension more Shariah-compliant by adding additional privacy controls and customization options\n\n## Open Source\n\nHaramBlur 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.\n\n## Like the project?\n\nIf 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! 😊\n\nDon't forget us from your Du'a! 🤲\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falganzory%2FHaramBlur","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Falganzory%2FHaramBlur","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Falganzory%2FHaramBlur/lists"}