evatechsoft / uBO-WebSocket

A companion extension for Chromium-based browsers to expose websocket connections to uBlock Origin

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

uBO-WebSocket

A companion extension for Chromium-based browsers to expose websocket connections to uBlock Origin.

Installation

You can install manually using your browser's "Load unpacked extension..." feature, or directly from the Chrome store: https://chrome.google.com/webstore/detail/ublock-origin-websocket/pgdnlhfefecpicbbihgmbmffkjpaplco.

Purpose

For Chromium-based browsers, WebSocket connections are not available to the chrome.webRequest API. This companion extension (it's pointless to use it as a standalone) will allow uBlock Origin to become aware of WebSocket connection attempts: they can be filtered, and will be reported in the logger.

Related: Chromium issue 129353.

In fact, any extension which listens to network request through the chrome.webRequest API can gain the ability to see and act on WebSocket connections with this companion extensions.

Currently known to work with uBlock Origin 1.7.2 and above.

The extension has no interactive UI, just an icon in the toolbar to remind it's enabled. Your browser should allow you to hide the icon if it annoys you. Use uBlock Origin's logger if you want to see and possibly filter WebSocket connections.

Sites benefitting from WebSocket filtering

I will add as I stumble on cases (feel free to add to the list through a pull request -- alphabetical order by domain name).

  • opensubtitles.org (ref)
  • thewatchseries.to (ref)
  • adult sites (ref, ref)

About

A companion extension for Chromium-based browsers to expose websocket connections to uBlock Origin

License:GNU General Public License v3.0


Languages

Language:JavaScript 100.0%