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 ## Requirements
   6
   7 * [Livestreamer](http://docs.livestreamer.io/install.html)
   8 * python 2.7 or 3.2+
   9 * pycrypto -- Livestreamer needs this for some videos
  10 * python-lxml
  11 * ffmpeg / libav-tools
  12
  13 ## Installation
  14
  15 ### Arch Linux
  16     pacman -S livestreamer python-crypto python-lxml ffmpeg
  17
  18 ### Ubuntu
  19     apt-get install livestreamer python-crypto python-lxml libav-tools
  20
  21 ### Mac OS X
  22
  23 Warning, this is untested!
  24
  25     brew install python3 ffmpeg
  26     pip3 install livestreamer pycrypto lxml
  27
  28 ### Then get WebDL itself
  29     hg clone https://bitbucket.org/delx/webdl
  30     cd webdl
  31     python3 ./grabber.py
  32
  33
  34 ## Interactive usage (grabber.py)
  35
  36 You can run WebDL interactively to browse categories and episode lists and download TV episodes.
  37
  38 ```
  39 $ ./grabber.py
  40  1) ABC iView
  41  2) SBS
  42  0) Back
  43 Choose> 1
  44  1) ABC 4 Kids
  45  2) Arts & Culture
  46  3) Comedy
  47  4) Documentary
  48 <snipped>
  49 Choose> 4
  50  1) ABC Open Series 2012
  51  2) Art Of Germany
  52  3) Baby Beauty Queens
  53  4) Catalyst Series 13
  54 <snipped>
  55 Choose> 4
  56  1) Catalyst Series 13 Episode 15
  57  2) Catalyst Series 13 Episode 16
  58  0) Back
  59 Choose> 1
  60 RTMPDump v2.3
  61 (c) 2010 Andrej Stepanchuk, Howard Chu, The Flvstreamer Team; license: GPL
  62 Connecting ...
  63 INFO: Connected...
  64 Starting download at: 0.000 kB
  65 ```
  66
  67 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.
  68
  69
  70
  71 ## Cron scripted usage (autograbber.py)
  72
  73 I have a shell script which looks something like this, I run it daily from crontab.
  74
  75 ```
  76 # m    h  dom mon dow   command
  77   0    1   *   *   *     ./autograbber.py /path/to/video-dir/ /path/to/patterns.txt
  78 ```
  79
  80 The patterns.txt file should contain shell-style globs, something like:
  81
  82 ```
  83 ABC iView/*/QI*/*
  84 SBS/Programs/Documentary/*/*
  85 ```
  86
  87 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.
  88
  89
  90 ## Bug reports
  91
  92 Log an issue on the [Bitbucket project](https://bitbucket.org/delx/webdl/issues?status=new&status=open)