Skip to content

A browser add-on/extension for Chrome and Firefox that enables you to hide content that you don't want to see on the web

License

Notifications You must be signed in to change notification settings

andornaut/filter-bubble

Repository files navigation

Filter Bubble

Filter Bubble is a browser add-on/extension for Chrome and Firefox that enables you to hide content that you don't want to see on the web.

How it works

  1. Create a list of "topics" that you want to hide or remove from specific websites
  2. Configure rules for these websites by specifying CSS selectors that target the HTML elements of the content blocks or feed items that might contain any of the targeted topics
  3. If a targeted topic appears in a targeted HTML element on a targeted website, then it'll be hidden or removed from view

n.b. Only a handful of websites are configured out of the box, and you'll need to know how to target HTML elements using CSS selectors in order to configure additional websites!

filter-out topics

website-specific query selectors

Developing

Getting Started

  1. Install node > v10.19.0
  2. Install npm > v6.14.4
  3. npm install
  4. npm run web-ext

Developing for Android

Follow the Extension Workshop guide:

  • Enable Android "Developer Options"

  • Remote Debugging via USB in Firefox for Android

  • Connect your device to your computer via USB

  • Install Android Platform Tools

  • Enable "Remote Debugging via USB" from Firefox Android -> Settings -> Developer Tools

  • Create /etc/udev/rules.d/50-android-usb.rules with the following content:

    SUBSYSTEM=="usb", ATTR{idVendor}=="18d1", MODE="0666", GROUP="plugdev"

    Replace the value for idVendor with the one from dmesg, eg:

    New USB device found, idVendor=18d1, idProduct=4ee7, bcdDevice= 5.15
sudo apt install adb android-sdk-platform-tools-common

# You may need to restart the adb server if you have a previous manual installation
sudo adb kill-server
sudo adb start-server

adb devices

Your device will now prompt you to authorize the computer. Once authorized, continue with the instructions for web-ext:

device="$(adb devices  2>&1| awk '/./{device=$1} END{print device}')"
echo Device \"${device}\"

./node_modules/.bin/web-ext run --target=firefox-android --android-device=${device}

# If you have multiple Firefox versions installed, then you can disambiguate using the `--firefox-apk` flag.
./node_modules/.bin/web-ext run \
    --target=firefox-android \
    --android-device=${device} \
    --firefox-apk=org.mozilla.firefox

Alternatively, you can run: npm run web-ext-android-firefox

Publishing

npm run package-production
ls web-ext-artifacts/

About

A browser add-on/extension for Chrome and Firefox that enables you to hide content that you don't want to see on the web

Topics

Resources

License

Stars

Watchers

Forks