LocalCDN-Firefox-Chrome-Brave/README.md

90 lines
4.3 KiB
Markdown
Raw Normal View History

2020-05-21 06:13:42 +02:00
# LocalCDN
2020-05-30 11:00:25 +02:00
A web browser extension (and a fork of Decentraleyes) that emulates Content Delivery Networks to improve your online privacy. It intercepts traffic, finds supported resources locally, and injects them into the environment. All of this happens automatically, so no prior configuration is required. Feel free to use the following [testing utility](https://localcdn.de/test/) to find out if you are properly protected. For more information, please read this [basic introduction from Decentraleyes](https://git.synz.io/Synzvato/decentraleyes/wikis/Simple-Introduction) or our [Wiki pages](https://codeberg.org/nobody/LocalCDN/wiki).
2020-02-27 13:45:29 +01:00
2020-03-01 10:01:49 +01:00
## Differences between LocalCDN and Decentraleyes
LocalCDN based on Decentraleyes. It includes more frameworks and more CDNs:
2020-05-12 06:50:34 +02:00
* **NEW: Removed integrity checks of embedded script and style elements** :tada: :tada: :tada:
* Font Awesome
2020-03-01 10:01:49 +01:00
* jQuery up to 3.4.1
* Bootstrap CSS (Delivered by StackPath, NetDNA and MaxCDN)
* Bootstrap JavaScript (Delivered by StackPath, NetDNA and MaxCDN)
* AngularJS, AngularJS-Animate, AngularJS-Sanitize, AngularJS-Cookies and AngularJS-Touch
2020-03-12 10:42:22 +01:00
* Prepared rules for uBlock/uMatrix
2020-03-01 10:01:49 +01:00
2020-02-27 17:48:10 +01:00
> **Note:** LocalCDN is no silver bullet, but it does prevent a lot of websites from making you send these kinds of requests. Ultimately, you can make LocalCDN block requests for any missing CDN resources, too.
2020-02-27 13:45:29 +01:00
2020-05-21 06:13:42 +02:00
2020-05-16 18:18:25 +02:00
## What is the different of LocalCDN in comparison to other CDN emulators?
2020-05-31 20:21:28 +02:00
![The Replacement of Libraries](screenshots/replacement.png?raw=true "The Replacement of Libraries")
2020-05-16 18:18:25 +02:00
2020-05-16 18:56:41 +02:00
**Advantages of LocalCDN:**
:thumbsup: more frameworks/libraries
:thumbsup: smaller size than other extensions
:thumbsup: remove crossorigin and integrity attributes of script and stylesheet tags to increase replacements
:thumbsup: doesn't matter which version a website requested
2020-05-21 06:13:42 +02:00
2020-03-01 10:01:49 +01:00
## We need you!
2020-05-31 20:21:28 +02:00
![We Need You!](pages/images/we-need-you.png?raw=true "We Need You!")
2020-03-01 10:01:49 +01:00
The whole Internet is full of different frameworks and CDNs that negatively affect your privacy. If you find a website that embeds another unsupported version of a framework, please report that website.
2020-03-12 10:42:22 +01:00
### :warning: **Important** :warning:
2020-05-21 06:13:42 +02:00
In some cases, it isn't possible to use our framework because the website sets up a strong "Same Origin Policy" (SOP). Please read [Broken JavaScript or CSS on some websites](https://codeberg.org/nobody/LocalCDN/wiki/Broken-JavaScript-or-CSS-on-some-websites) before opening an issue.
2020-03-12 10:42:22 +01:00
2020-03-01 10:01:49 +01:00
On behalf of everyone: Thank you!
2020-05-21 06:13:42 +02:00
2020-03-09 07:10:35 +01:00
## Screenshots
2020-03-14 18:02:08 +01:00
### Light
2020-05-31 20:21:28 +02:00
![Light Theme](screenshots/screenshot_light.png?raw=true "Light Theme")
2020-03-14 18:02:08 +01:00
### Dark
2020-05-31 20:21:28 +02:00
![Dark Theme](screenshots/screenshot_dark.png?raw=true "Dark Theme")
2020-03-14 18:02:08 +01:00
2020-05-31 20:21:28 +02:00
### Rule generator for uBlock/uMatrix (after an update)
![Rule generator after an update](screenshots/screenshot_after_update.png?raw=true "Rule generator after an update")
2020-05-21 06:13:42 +02:00
2020-05-31 20:21:28 +02:00
### Rule generator for uBlock/uMatrix (settings page)
![Rule generator on settings page](screenshots/screenshot_settings.png?raw=true "Rule generator on settings page")
2020-03-09 07:10:35 +01:00
2020-02-27 13:45:29 +01:00
## Contributing Code
2020-02-27 17:48:10 +01:00
Suggestions in the form of **Issues**, and contributions in the form of **Merge Requests**, are highly welcome.
2020-02-27 13:45:29 +01:00
2020-05-21 06:13:42 +02:00
## Installation
2020-02-27 13:45:29 +01:00
2020-03-07 07:29:22 +01:00
* Mozilla Firefox *(63 or higher)*: [get it on addons.mozilla.org](https://addons.mozilla.org/en-US/firefox/addon/localcdn-fork-of-decentraleyes/)
2020-05-21 06:13:42 +02:00
* Chromium based browser: [Chrome Web Store (by Emanuel Bennici)](https://chrome.google.com/webstore/detail/localcdn-fork-from-decent/njdfdhgcmkocbgbhcioffdbicglldapd)
2020-02-27 13:45:29 +01:00
2020-05-21 06:13:42 +02:00
#### Running the Code as temporary extension
2020-02-27 13:45:29 +01:00
Please read this [developer guide](https://developer.mozilla.org/en-US/Add-ons/WebExtensions/Your_first_WebExtension#Trying_it_out) for information on how to run the extension from source.
2020-02-27 17:48:10 +01:00
> **Important:** All tagged commits are signed with GPG. It's likely best to ignore unsigned commits, unless you really know what you're doing. Please send an email if you have any questions or security concerns.
2020-02-27 13:45:29 +01:00
2020-05-12 06:50:34 +02:00
## Contact
2020-05-16 18:56:41 +02:00
Just open an issue with your question or write an [email](https://localcdn.de/contact/) (PGP possible!).
2020-05-12 06:50:34 +02:00
2020-04-12 06:38:52 +02:00
## Donations
2020-05-21 06:13:42 +02:00
LocalCDN is free and open-source. If you like LocalCDN you can support continued development by making a donation. Any help would be greatly appreciated! Every way to donate can be found on the [website](https://localcdn.de/donate/). At the moment donations are possible with SEPA bank transfer.
2020-04-12 06:38:52 +02:00
2020-02-27 13:45:29 +01:00
## License
[MPL-2.0](https://www.mozilla.org/MPL/2.0).