summaryrefslogtreecommitdiff
path: root/README
blob: 0c96f05bac2e85c9d8f8d73fb0fb92c60d3554fb (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
GetHT - The Free Hinduism Today Digital Edition Downloader

-Summary
The nice people at Hinduism Today have recently begun freely distributing
their magazine in pdf format, so that anybody may read a copy for free.

However, rather than provide links to the PDF files on their website,
they ask users to download their software which then downloads and opens
the PDFs itself.

This unfortunately means those who are not using a Mac or Windows PC are
unable to download the new issues.

This program is written to change all that.

-License
GetHT is released under the GPLv3, see the file COPYING for details.
Basically this means that you are free to study the program, modify it,
and redistribute it however you see fit, provided you extend the same
freedom to others by releasing derivatives with the same license.

-Dependancies
libxml2 2.0.0+
libcurl 7.7.2+

-Install
make && make install

-Proxy Support
GetHT supports HTTP, SOCKS4 & SOCKS5 proxys (though they haven't been
thoroughly tested - let me know if there are any problems).
Environmental variables (e.g. http_proxy) are used, but may be overridden
with the following lines in the config.ini file. Any lines which are not
needed (for example the authentication lines) should just be omitted.
The format of the options is:
  proxy_type <type_of_proxy> (http, socks4 or socks5)
  proxy_address <address>
  proxy_port <port>
  proxy_auth <proxy_auth_method> (none, basic, digest or ntlm)
  proxy_user <proxy_username>
  proxy_pass <proxy_password>

-Bugs / Problems
This software is very new, so there will undoubtedly be some bugs lingering,
or parts of the program which don't work as expected.
If you encounter problems, there are several ways to get help:
 Mailing List    : http://lists.nongnu.org/mailman/listinfo/getht-general
 Bug Tracker     : http://savannah.nongnu.org/bugs/?func=additem&group=getht