code.delx.au - webdl/blob - README.md

   1 # WebDL #
   2
   3 WebDL is a set of Python scripts to grab video from online Free To Air Australian channels.
   4
   5
   6 ## Installation
   7
   8     git clone https://bitbucket.org/delx/webdl
   9     cd webdl
  10     virtualenv --python python3 .virtualenv
  11     . .virtualenv/bin/activate
  12     pip install -r requirements.txt
  13     ./grabber.py
  14
  15
  16 ## Interactive usage (grabber.py)
  17
  18 You can run WebDL interactively to browse categories and episode lists and download TV episodes.
  19
  20 ```
  21 $ ./grabber.py
  22  1) ABC iView
  23  2) SBS
  24  0) Back
  25 Choose> 1
  26  1) ABC 4 Kids
  27  2) Arts & Culture
  28  3) Comedy
  29  4) Documentary
  30 <snipped>
  31 Choose> 4
  32  1) ABC Open Series 2012
  33  2) Art Of Germany
  34  3) Baby Beauty Queens
  35  4) Catalyst Series 13
  36 <snipped>
  37 Choose> 4
  38  1) Catalyst Series 13 Episode 15
  39  2) Catalyst Series 13 Episode 16
  40  0) Back
  41 Choose> 1
  42 RTMPDump v2.3
  43 (c) 2010 Andrej Stepanchuk, Howard Chu, The Flvstreamer Team; license: GPL
  44 Connecting ...
  45 INFO: Connected...
  46 Starting download at: 0.000 kB
  47 ```
  48
  49 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.
  50
  51
  52
  53 ## Cron scripted usage (autograbber.py)
  54
  55 I have a shell script which looks something like this, I run it daily from crontab.
  56
  57 ```
  58 # m    h  dom mon dow   command
  59   0    1   *   *   *     ./autograbber.py /path/to/video-dir/ /path/to/patterns.txt
  60 ```
  61
  62 The patterns.txt file should contain shell-style globs, something like:
  63
  64 ```
  65 ABC iView/*/QI*/*
  66 SBS/Programs/Documentary/*/*
  67 ```
  68
  69 The above will download all episodes of QI from ABC as well as every SBS documentary. 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.
  70
  71
  72 ## Bug reports
  73
  74 Please raise issues on the [Bitbucket project](https://bitbucket.org/delx/webdl/issues?status=new&status=open).