Tutorial

This tutorial will show you what LocalCDN does, how you can use it and what it offers you.

Install

LocalCDN is a browser extension and is primarily developed for Mozilla's Firefox browser. Although the extension is also available for Chromium-based browsers (Thanks to Emanuel Bennici), but there are a few features that a Chromium-based browser doesn't support. (More informations)

You can Download this extension for Firefox here and for Chromium-based browser here (Please note: The Chrome version is not always up to date). Alternatively, you can download the source code and use it by using the browser's developer mode (Developer mode of Firefox or Chromium).

Usage

LocalCDN is already preconfigured. You can customize it to your personal preferences in the extension's settings. In some cases websites are broken:

  • If a webserver forbids to load a script from a different source, LocalCDN cannot replace anything. This is a security feature that is designed to prevent evil things. This is called SOP/CORS problem and cannot be disabled.
    Tutorial - SOP/CORS problem
  • A web page can specify in the HTML source code that the browser compares the requested resource and the actually delivered one (Subresource Integrity) or restricts the sources (CORS). If there are any differences, the script won't be loaded. In this case you can activate the HTML filter (second switch). LocalCDN read the HTML source code and remove these attributes. Errors can occur if the web page does not use a UTF-8 character set. (More informations)
    Tutorial - Enable filter HTML source code Tutorial - Encoding problem
  • If a website uses a JavaScript library that LocalCDN doesn't know and you have "Block requests for missing resources" enabled, the website may also seem broken. You can enable logging to see what resource is and open an issue at Codeberg. The resource will be integrated as soon as possible.
    Tutorial - How to logging

Synchronisation / Firefox Sync

LocalCDN stores the configuration in the local storage area by default. If you use Firefox Sync or your own sync server, a lot of your settings can be synchronized with all your devices. This saves time and reduces complications because you don't have to make the same settings manually on all devices. Please note that there may be problems with your own sync server. Feel free to open a ticket on Codeberg to share your experience with others.

Have I forgotten something?

A short email or an issue on Codeberg is all you need.

Source Code @Codeberg Contact Testing Utilities
Mastodon icon Lemmy icon