summaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authorGravatar Stefano <l.stickell@yahoo.it> 2014-03-22 15:14:47 +0100
committerGravatar Walter Purcaro <vuolter@gmail.com> 2014-06-28 02:45:42 +0200
commit36aa7f001329f95ca1eed41a5a6390dfc34e1594 (patch)
treed7a5a5e938180acd6000e84bcc1e983aaa9e755a /README.md
parentAdded .gitignore (diff)
downloadpyload-36aa7f001329f95ca1eed41a5a6390dfc34e1594.tar.xz
Markdown README
Diffstat (limited to 'README.md')
-rw-r--r--README.md84
1 files changed, 84 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 000000000..9ebe0cdaf
--- /dev/null
+++ b/README.md
@@ -0,0 +1,84 @@
+# pyLoad
+
+pyLoad is a free and open source downloader for 1-click-hosting sites
+like rapidshare.com or uploaded.to.
+It supports link decryption as well as all important container formats.
+
+pyLoad is written entirely in Python and is currently under heavy development.
+
+For news, downloads, wiki, forum and further information visit http://pyload.org/
+
+To report bugs, suggest features, ask a question, get the developer version
+or help us out, visit http://github.com/pyload/pyload
+
+Documentation about extending pyLoad can be found at http://docs.pyload.org or join us at #pyload on irc.freenode.net
+
+Dependencies
+------------
+
+You need at least python 2.5 to run pyLoad and all of these required libaries.
+They should be automatically installed when using pip install.
+The prebuilt pyload packages also install these dependencies or have them included, so manuall install
+is only needed when installing pyLoad from source.
+
+### Required
+
+- pycurl a.k.a python-curl
+- jinja2
+- beaker
+- thrift
+- simplejson (for python 2.5)
+
+Some plugins require additional packages, only install these when needed.
+
+### Optional
+
+- pycrypto: RSDF/CCF/DLC support
+- tesseract, python-pil a.k.a python-imaging: Automatic captcha recognition for a small amount of plugins
+- jsengine (spidermonkey, ossp-js, pyv8, rhino): Used for several hoster, ClickNLoad
+- feedparser
+- BeautifulSoup
+- pyOpenSSL: For SSL connection
+
+First start
+-----------
+
+Note: If you installed pyload via package-manager `python pyLoadCore.py` is probably equivalent to `pyLoadCore`
+
+Run::
+
+ python pyLoadCore.py
+
+and follow the instructions of the setup assistent.
+
+For a list of options use::
+
+ python pyLoadCore.py -h
+
+Configuration
+-------------
+
+After finishing the setup assistent pyLoad is ready to use and more configuration can be done via webinterface.
+Additionally you could simply edit the config files located in your pyLoad home dir (defaults to: ~/.pyload)
+with your favorite editor and edit the appropriate options. For a short description of
+the options take a look at http://pyload.org/configuration.
+
+To restart the configure assistent run::
+
+ python pyLoadCore.py -s
+
+### Adding downloads
+
+To start the CLI and connect to a local server, run::
+
+ python pyLoadCli.py -l
+
+for more options refer to::
+
+ python pyLoadCli.py -h
+
+The webinterface can be accessed when pointing your webbrowser to the ip and configured port, defaults to http://localhost:8000
+
+Notes
+-----
+For more information, see http://pyload.org/