3 WebDL is a set of Python scripts to grab video from online Free To Air Australian channels.
9 * Now requires Python3, use the `python2` branch if you need the old version.
10 * Recommended installation is now with `virtualenv` and `pip` to install dependencies.
11 * Removed some custom logic in favour of the `requests` and `requests_cache` libraries.
12 * `autograbber.py` can write to multiple directories, previous command line args are still supported.
15 ## Installation using pip
17 Install the following packages using your package manager:
19 * Python 3.2+ (including dev package)
20 * ffmpeg or libav-tools
22 Clone the WebDL repository:
24 git clone https://bitbucket.org/delx/webdl
28 Set up a Python virtualenv and use pip to install the other dependencies:
30 virtualenv --python python3 .virtualenv
31 . .virtualenv/bin/activate
32 pip install -r requirements.txt
35 Whenever you want to run WebDL you must source the `.virtualenv/bin/activate` script from your shell.
38 ## Installation on Debian/Ubuntu
40 Install Python 3 and needed libraries:
42 apt-get install python3 python3-lxml python3-requests python3-requests-cache
45 You must also install Streamlink, or if it unavailable, the older Livestreamer. Depending on the age of your distro you'll need either:
47 - `apt-get install streamlink`
48 - `apt-get install livestreamer python-crypto`
53 apt-get install ffmpeg
56 ## Interactive usage (grabber.py)
58 You can run WebDL interactively to browse categories and episode lists and download TV episodes.
72 1) ABC Open Series 2012
78 1) Catalyst Series 13 Episode 15
79 2) Catalyst Series 13 Episode 16
83 (c) 2010 Andrej Stepanchuk, Howard Chu, The Flvstreamer Team; license: GPL
86 Starting download at: 0.000 kB
89 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.
93 ## Cron scripted usage (autograbber.py)
95 You can schedule a regular download of your favourite shows. This example uses `chronic` from `moreutils`.
98 # m h dom mon dow command
99 0 1 * * * timeout 6h chronic $HOME/webdl/autograbber-cron.sh /videos/ABC4Kids /videos/Insight
102 Each of these directories should contain a `.patterns.txt` with shell-style globs:
105 ABC iView/By Channel/ABC4Kids/*/*
106 SBS/Channel/SBS1/Insight*
109 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.
114 Please raise issues on the [Bitbucket project](https://bitbucket.org/delx/webdl/issues?status=new&status=open).