X-Git-Url: https://code.delx.au/webdl/blobdiff_plain/8c7af9b11c23430c4b756ee608cb4f1fbc9a97d2..027b8b4760a2a629bcba7b2ecdbcc3f0e03650fc:/README.md

diff --git a/README.md b/README.md
index 321608e..f358705 100644
--- a/README.md
+++ b/README.md
@@ -2,37 +2,83 @@
 
 WebDL is a set of Python scripts to grab video from online Free To Air Australian channels.
 
-## Requirements
 
-* [Livestreamer](http://docs.livestreamer.io/install.html)
-* python3-pycrypto -- Livestreamer needs this for some videos
-* [rtmpdump](https://rtmpdump.mplayerhq.hu)
-* python 2.7 (webdl doesn't work with python3 yet)
-* python2-lxml (for python2)
-* ffmpeg / libav-tools
+## Installation
 
-## Instructions
+Install the following packages using your package manager:
 
-### Arch Linux
-    pacman -S livestreamer python-crypto python2-lxml rtmpdump ffmpeg
+* Python 3.2+
+* ffmpeg or libav-tools
 
-### Ubuntu
-    apt-get install livestreamer python3-crypto python-lxml rtmpdump libav-tools
+Clone the WebDL repository:
+```
+git clone https://bitbucket.org/delx/webdl
+cd webdl
+```
 
-### Mac OS X
+Set up a Python virtualenv and use pip to install the other dependencies:
+```
+virtualenv --python python3 .virtualenv
+. .virtualenv/bin/activate
+pip install -r requirements.txt
+```
 
-Warning, this is untested!
+## Interactive usage (grabber.py)
 
-    brew install python3 python rtmpdump ffmpeg
-    pip3 install livestreamer pycrypto
-    pip install lxml
+You can run WebDL interactively to browse categories and episode lists and download TV episodes.
 
-### Then get WebDL itself
-    hg clone https://bitbucket.org/delx/webdl
-    cd webdl
-    ./grabber.py
+```
+$ ./grabber.py
+ 1) ABC iView
+ 2) SBS
+ 0) Back
+Choose> 1
+ 1) ABC 4 Kids
+ 2) Arts & Culture
+ 3) Comedy
+ 4) Documentary
+<snipped>
+Choose> 4
+ 1) ABC Open Series 2012
+ 2) Art Of Germany
+ 3) Baby Beauty Queens
+ 4) Catalyst Series 13
+<snipped>
+Choose> 4
+ 1) Catalyst Series 13 Episode 15
+ 2) Catalyst Series 13 Episode 16
+ 0) Back
+Choose> 1
+RTMPDump v2.3
+(c) 2010 Andrej Stepanchuk, Howard Chu, The Flvstreamer Team; license: GPL
+Connecting ...
+INFO: Connected...
+Starting download at: 0.000 kB
+```
+
+The bolded parts are what you type. Note that you can go back on any screen by typing “0”. At the list of episodes you can download a single episode by typing one number, or multiple episodes by typing several numbers separated by spaces.
+
+
+
+## Cron scripted usage (autograbber.py)
+
+You can schedule a regular download of your favourite shows.
+
+```
+# m    h  dom mon dow   command
+  0    1   *   *   *     ./autograbber.py /videos/ABC4Kids /videos/Insight
+```
+
+Each of these directories should contain a `.patterns.txt` with shell-style globs:
+
+```
+ABC iView/By Channel/ABC4Kids/*/*
+SBS/Channel/SBS1/Insight*
+```
+
+Whenever an episode is downloaded it is recorded into `.downloaded_auto.txt`. Even if you move the files somewhere else they will not be redownloaded.
 
 
 ## Bug reports
 
-Log an issue on the [Bitbucket project](https://bitbucket.org/delx/webdl/issues?status=new&status=open)
+Please raise issues on the [Bitbucket project](https://bitbucket.org/delx/webdl/issues?status=new&status=open).