]> code.delx.au - webdl/blobdiff - README.md
Fixed iView downloads
[webdl] / README.md
index 1dd4945853714ca3ce7bea7de82174c74a60607d..ac6de8224e8f0f6e33ee7d66200e4a3e1f5f12b4 100644 (file)
--- a/README.md
+++ b/README.md
@@ -5,6 +5,11 @@ WebDL is a set of Python scripts to grab video from online Free To Air Australia
 
 ## News
 
+### 2018-02-24
+
+* Support for Streamlink in addition to Livestreamer.
+* Currently working with iView, SBS and Channel 10.
+
 ### 2017-02-24
 * Now requires Python3, use the `python2` branch if you need the old version.
 * Recommended installation is now with `virtualenv` and `pip` to install dependencies.
@@ -12,6 +17,16 @@ WebDL is a set of Python scripts to grab video from online Free To Air Australia
 * `autograbber.py` can write to multiple directories, previous command line args are still supported.
 
 
+## Updating to the latest version
+
+You must use [git](https://git-scm.com) to keep up to date. The `autograbber-cron.sh` script is how I do this. If you'd like to manually update just run these commands.
+
+```
+cd webdl
+git pull --ff-only
+```
+
+
 ## Installation using pip
 
 Install the following packages using your package manager:
@@ -37,16 +52,21 @@ Whenever you want to run WebDL you must source the `.virtualenv/bin/activate` sc
 
 ## Installation on Debian/Ubuntu
 
+Clone the WebDL repository:
+```
+git clone https://bitbucket.org/delx/webdl
+cd 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:
 
-Install Livestreamer and PyCrypto. Ubuntu packages this as Python 2:
-```
-apt-get install livestreamer python-crypto
-```
+- `apt-get install streamlink`
+- `apt-get install livestreamer python-crypto`
 
 
 Install ffmpeg:
@@ -107,6 +127,13 @@ 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.