|doc||2014-03-05||huhamhire||[b71edd] update documentation to 1.9.8 second edition|
|gui||2014-01-22||huhamhire||[464e8e] update doc and build script|
|res||2014-01-24||huhamhire||[b3fde3] fix build script for mac|
|tui||2014-03-17||huhamhire||[59e7b5] Connect LoggerView with signals|
|util||2014-01-24||huhamhire||[7e60b4] fix make hosts for current system issue|
|.gitattributes||2014-01-19||huhamhire||[e72d53] Moved outside documentation into repo|
|.gitignore||2014-01-19||huhamhire||[e72d53] Moved outside documentation into repo|
|LICENSE||2013-07-26||huhamhire||[1b637c] Add README and LICENSE|
|README.rst||2014-01-22||huhamhire||[e2be4d] fix code page problem for tui on windows|
|__version__.py||2014-03-04||huhamhire||[87d931] update to 1.9.8 second edition|
|_build.py||2014-01-24||huhamhire||[b3fde3] fix build script for mac|
|hoststool.py||2014-05-05||Alek Slater||[0dc43a] allowed both text and gui clients to check for ...|
|network.conf||2014-03-03||huhamhire||[efc1de] update network.conf|
Since the governments of some countries are using technical methods blocking internet access to some websites and web service providers which includes some world famous sites like Google, YouTube, twitter, Facebook, and Wikipedia etc., we designed this tiny utility in order to help people getting through the Internet blockade.
Hosts Setup Utility provides basic tools to manage the hosts file on current operating systems. It also provides both support for Graphical Desktop environment with Graphical User Interface (GUI) and CLI environment with Text-based User Interface (TUI).
Users could use these tool to modify the hosts to visit specified websites or services blocked by ISP/government. Functions which help users to backup/restore hosts files are also provided.
Hosts Setup Utility is designed by huhamhire-hosts team. For further information, please visit our website.
Developers could find our project documentation by visiting https://hosts.huhamhire.com/document/.
This documentation contains descriptions of modules and functions which are used in the current version of Hosts Setup Utility. These documents also provides some optional methods for developers to help improve this tool.
Licensed under the GNU General Public License, version 3. You should have received a copy of the GNU General Public License along with this program. If not, see http://www.gnu.org/licenses/.
Here are the system requirements needed for using Hosts Setup Utility.
System requirements to run Hosts Setup Utility on Graphical Desktop are listed here:
Microsoft Windows 2000 or newer for Windows users.
Mac OS X 10.6 or newer for Macintosh users.
Linux/X11 desktop with Python 2 and PyQt4 for Linux/X11 users.
Internet access is required for retrieving the latest hosts data file.
On some linux distributions, pre-built packages of PyQt4 can be found in software repositories. For example, you can install PyQt4 on a debian distribution simplly using:
apt-get install python-qt4
More requirements are needed for developers:
Any devices with Python 2 and Python Standard Library INSTALLED could run Hosts Setup Utility in TUI mode from a 80x24 terminal. In addition to this, TUI mode could also be operated via SSH on remote devices/machines/servers. All you need is a system with Python 2 installed.
Since Hosts Setup Utility supports both Graphical Desktop environment with Graphical User Interface (GUI) and CLI/terminal environment with Text-based User Interface (TUI), users could the way they would like to launch this tool.
However, GUI mode is highly recommended because several features like backup/restore hosts file are still not supported in TUI mode currently.
Windows(x86/x64): Run hoststool.exe from the binary excutables package to get started.
- "Run as Administrator" is needed for operations to change the hosts file on Windows Vista or newer.
Mac OS X: Run HostsUtl application from the binary excutables package to get started.
- Because of the locale problem with py2app, the automatic language selection may not work correctly on Mac OS with binary executable files. You can just choose the language on your on choice.
Linux/X11(Source code): Run command "python hoststool.py" to get started.
- All platforms with Python and the PyQt4 could use this method to run with the source code.
- A desktop environment with PyQt4 and python is needed only for Linux/X11 users to start a GUI Session.
Python Source Code:
Python Source Code is very easy to be started through any terminals on any operating systems.
Users are allowed to add customized hosts list as an independent module to make a hosts file. All you need to do is create a simple text file named custom.hosts in the working directory, and put your own hosts entries into this file. Then you would find a Customized Hosts option in the function list.
- Non-ASCII characters are not recommended to be put into the customized hosts file.