Repository files navigation

WebDL is a set of Python scripts to grab video from online Free To Air Australian channels.

• Support for Streamlink in addition to Livestreamer.
• Currently working with iView, SBS and Channel 10.

• Now requires Python3, use thepython2 branch if you need the old version.
• Recommended installation is now withvirtualenv andpip to install dependencies.
• Removed some custom logic in favour of therequests andrequests_cache libraries.
• autograbber.py can write to multiple directories, previous command line args are still supported.

You must usegit to keep up to date. Theautograbber-cron.sh script is how I do this. If you'd like to manually update just run these commands.

cd webdlgit pull --ff-only

Install the following packages using your package manager:

• Python 3.2+ (including dev package)
• ffmpeg or libav-tools

Clone the WebDL repository:

git clone https://bitbucket.org/delx/webdlcd webdl

Set up a Python virtualenv and use pip to install the other dependencies:

virtualenv --python python3 .virtualenv. .virtualenv/bin/activatepip install -r requirements.txt

Whenever you want to run WebDL you must source the.virtualenv/bin/activate script from your shell.

Clone the WebDL repository:

git clone https://bitbucket.org/delx/webdlcd webdl

Install Python 3 and needed libraries:

apt-get install python3 python3-lxml python3-requests python3-requests-cache

You must also install Streamlink, or if it unavailable, the older Livestreamer. Depending on the age of your distro you'll need either:

• apt-get install streamlink
• apt-get install livestreamer python-crypto

Install ffmpeg:

apt-get install ffmpeg

You can run WebDL interactively to browse categories and episode lists and download TV episodes.

$ ./grabber.py 1) ABC iView 2) SBS 0) BackChoose> 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) BackChoose> 1RTMPDump v2.3(c) 2010 Andrej Stepanchuk, Howard Chu, The Flvstreamer Team; license: GPLConnecting ...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.

You can schedule a regular download of your favourite shows. This example useschronic frommoreutils.

# m    h  dom mon dow   command  0    1   *   *   *     timeout 6h chronic $HOME/webdl/autograbber-cron.sh /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*

You may optionally created a.excludes.txt file with shell-style globs. This is matched against the episode title and can be used to filter out things you don't want. For example:

*(Mandarin)**(Chinese)*

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.

Please raise issues on theBitbucket project.