Skip to content
FoxyProxy for Firefox extension beginning with Firefox 57 (Quantum)
JavaScript HTML CSS Python
Branch: master
Clone or download

README.md

FoxyProxy for Firefox

The FoxyProxy extension has been around for almost 15 years as of 2019. It has been rewritten several times and is still maintained by the original developer, Eric H. Jung, with large contributions by others (e.g. erosman, Jesper Hansen, Georg Koppen, and others). As of 2019/2020, erosman is a primary developer.

Originally for Firefox, a Chrome edition was released years ago as well. It does not share the same codebase (yet), so this project is strictly for the Firefox edition. We hope they will share the same codebase sometime in 2020.

Pre-Firefox 57 (Quantum) versions are not maintained here. They are stored in a private git repo which I will release to github when time permits.

Editions

FoxyProxy for Firefox comes in three editions. Two of these editions are in this repository.

Standard

This edition switches requests between proxy servers based on domain/URL patterns or manually selecting a proxy server to use for all requests. This is the default build target for this project.

Basic

This edition sends all requests through a proxy servers manually selected by the user. There is no domain/URL pattern switching like with Standard and Plus. This build target can be selected by TODO.

Plus

No longer maintained since Firefox 57 dropped support for critical APIs. The source code is not in this repo. It had the same features as standard but also enabled switching by internal (LAN) IP address. For example, if your laptop connected to a work/school network and a home network, you could have different switching rules based on your location (providing the internal IP addresses were different, and they almost always are). Many people used this to automatically disable FoxyProxy while at home but enable it while at work or school.

Translations!

FoxyProxy is internationalized! Translate messages.json then make a pull request or email the file to me. Pre-Firefox 57 (Quantum) editions had 33 or 35 languages!

Building

FoxyProxy Standard edition is built by default. To build FoxyProxy Basic edition:

  • change FOXYPROXY_BASIC from false to true in utils.js
  • change browser_specific_settings.id in manifest.json from foxyproxy@eric.h.jung to foxyproxy-basic@eric.h.jung

Building With Grunt

Install grunt, which requires npm and node.

Run grunt in top-level directory. The add-on is packaged into target.zip

Building Without Grunt

Zip the src directory.

Running a development instance

  1. Clone this repository: git clone https://github.com/foxyproxy/firefox-extension.git
  2. In Firefox, navigate to about:debugging#/runtime/this-firefox
  3. Click Load Temporary Add-on
  4. Choose manifest.json in the cloned repository on your local system.

Note some items are cached by Firefox. Please refer to other online documentation for complete development and debugging of add-ons.

Authors

License

This project is licensed under the GPL 2.0 License. Commercial re-licensing may be available on request.

Feature Requests / RoadMap

You can’t perform that action at this time.