Skip to content

Latest commit

 

History

History
118 lines (87 loc) · 5.05 KB

README.md

File metadata and controls

118 lines (87 loc) · 5.05 KB

SwitchyOmega

Manage and switch between multiple proxies quickly & easily.

Translation status

Chromium Extension

The project is available as a Chromium Extension.

You can try it on Chrome Web Store, or grab a packaged extension file for offline installation on the Releases page.

Please report issues on the issue tracker.

Development status

PAC generator

This project contains a PAC generating module called omega-pac, which handles the profiles model and compile profiles into PAC scripts. This module is standalone and can be published to npm when the documentation is ready.

Options manager

The folder omega-target contains browser-independent logic for managing the options and applying profiles. Every public method is well documented in the comments. Functions related to browser are not included, and shall be implemented in subclasses of the omega-target classes.

omega-web is a web-based configuration interface for various options and profiles. The interface works great with omega-target as the back-end.

omega-web alone is incomplete and requires a file named omega_target_web.js containing an angular module omegaTarget. The module contains browser-dependent code to communicate with omega-target back-end, and other code retrieving browser-related state and information. See the omega-target-chromium-extension/omega_target_web.coffee file for an example of such module.

Targets

The omega-target-* folders should contain environment-dependent code such as browser API calls.

Each target folder should contain an extended OmegaTarget object, which contains subclasses of the abstract base classes like Options. The classes contains implementation of the abstract methods, and can override other methods at will.

A target can copy the files in omega-web into its build to provide a web-based configuration interface. If so, the target must provide the omega_target_web.js file as described in the Options manager section.

Additionally, each target can contain other files and resources required for the target, such as background pages and extension manifests.

For now, only one target has been implemented: The Chromium Extension target. This target allows the project to be used as a Chromium extension in most Chromium-based browsers.

However, the project architecture allows more targets to be added in the future. The first step would be adapting more browsers including Firefox. I don't have time for that now. Feel free to open a pull request if you want to help.

Translation

Translation is hosted on Weblate. If you want to help improve the translated text or start translation for your language, please follow the link of the picture below.

本项目翻译由Weblate托管。如果您希望帮助改进翻译,或将本项目翻译成一种新的语言,请 点击下方图片链接进入翻译。

Translation status

Building the project

SwitchyOmega has migrated to use npm and grunt for building. Please note that npm 2.x is required for this project.

To build the project:

# Install node and npm first (make sure npm --version > 2.0), then:

sudo npm install -g grunt-cli bower
# In the project folder:
cd omega-build
npm run deps # This runs npm install in every module.
npm run dev # This runs npm link to aid local development.
# Note: the previous command may require sudo in some environments.
# The modules are now working. We can build now:
grunt
# After building, a folder will be generated:
cd .. # Return to project root.
ls omega-chromium-extension/build/
# The folder above can be loaded as an unpacked extension in Chromium now.

To enable grunt watch, run grunt watch once in the omega-build directory. This will effectively run grunt watch in every module in this project.

License

GPLv3

SwitchyOmega is licensed under GNU General Public License Version 3 or later.

SwitchyOmega is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

SwitchyOmega is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

You should have received a copy of the GNU General Public License along with SwitchyOmega. If not, see http://www.gnu.org/licenses/.