Home

Quick Note:

If you don't have an HTTP proxy at your network that is filtering the websites(ie. you don't have to set your browser to use a proxy), this program is not for you.
Other solutions such as tor(the onion router) can work at your place.
The main advantage of this solution over others is that it does not route your connections through third party servers.

Getting Started:

Getting the executable:

For Windows, you can download the hcover-gui.exe program, it is much easier to use, it detects settings automatically, you just have to add blocked websites into the list and press the Start Button.
Windows Users can also download the cover-win32.zip package which you have to configure manually as stated in the guide.
For Linux, the source code compiles on GCC compiler by this command:
g++ -o cover cover.cpp -lpthread
then run it by:
./cover
Note that the same code also compiles on Microsoft Visual Studio.

Configuring the application:

All the configuration is done through the CONFIG file. . .

1. The first line contains the address of the local proxy that is responsible for the filtering (IE. the proxy you normally have to set your browser to use).
2. The next line contains the port for the proxy.
3. the third line contains an integer that specifies the method of resolving names, if it is 0 the program will resolve names depending on the local DNS server, if it is 1 then you have to specify a public DNS server to use such as Google's 8.8.8.8., so that the third line either looks like:
   0
   or(using open DNS instead of Google's 8.8.8.8)
   1 208.67.222.222
   although using the local DNS server is slightly faster it might not be available.
   if you don't know what all that means leave the third line as it is.
4. The fourth line contains x the number of websites to unblock.
5. then there are x lines each with a blocked domain.
   .
   Configuring other applications:

---

As the program says when started, you have to set your browser (or whatever program) to use the HTTP proxy 127.0.0.1 with port 8081.
In Mozilla Firefox, go to options->Advanced->Network->settings, choose "Manual proxy configuration", fill in the proxy 127.0.0.1 and the port 8081, then check the option to use this proxy for all protocols.
Note that with hcover-gui.exe You can set Mozilla to Use System Proxy Settings

Note:

If you still get the blocked page after following the previous steps, then this program is not able to help you, try posting the LOG in the forum, so that we can think for a workaround in your situation.

This video shows a step by step guide on Windows using hcover-gui.exe:

How this program works:

The main idea behind the program is that most filtering proxies do their job by simply looking at the requested domain in the GET or CONNECT request, this program tries to resolve this domain (only for domains specified in the CONFIG file) into its IP, keeping the Host header, so that websites with virtual hosts will work (like YouTube), then passes the request to the proxy server.
If the proxy is still blocking after using the program, then this program will not work in your situation.

Troubleshooting:

If you get any unexpected errors from the program, you can discuss that, please post your network configuration and the LOG and CONFIG files, so that we can help you.

Hope this helps.