3 files changed, 64 insertions, 6 deletions
diff --git a/network/youtube-dl/youtube-dl.1 b/network/youtube-dl/youtube-dl.1
index f7097ecc02..73ae62c2f7 100644
--- a/network/youtube-dl/youtube-dl.1
+++ b/network/youtube-dl/youtube-dl.1
@@ -861,11 +861,19 @@ videos under \f[C]Movies\f[] directory in your home directory:
 .IP
 .nf
 \f[C]
+#\ Lines\ starting\ with\ #\ are\ comments
+
+#\ Always\ extract\ audio
 \-x
+
+#\ Do\ not\ copy\ the\ mtime
 \-\-no\-mtime
+
+#\ Use\ this\ proxy
 \-\-proxy\ 127.0.0.1:3128
+
+#\ Save\ all\ videos\ under\ Movies\ directory\ in\ your\ home\ directory
 \-o\ ~/Movies/%(title)s.%(ext)s
-#\ Lines\ starting\ with\ #\ are\ comments
 \f[]
 .fi
 .PP
@@ -1442,7 +1450,7 @@ mplayer (http://mplayerhq.hu/) or mpv (https://mpv.io/) to be installed.
 .SS I have downloaded a video but how can I play it?
 .PP
 Once the video is fully downloaded, use any video player, such as
-mpv (https://mpv.io/), vlc (http://www.videolan.org) or
+mpv (https://mpv.io/), vlc (http://www.videolan.org/) or
 mplayer (http://www.mplayerhq.hu/).
 .SS I extracted a video URL with \f[C]\-g\f[], but it does not play on
 another machine / in my webbrowser.
@@ -1587,6 +1595,15 @@ youtube\-dl\ "http://www.youtube.com/watch?v=\-wNyEUrxzFU"
 .PP
 Use the \f[C]\-\-cookies\f[] option, for example
 \f[C]\-\-cookies\ /path/to/cookies/file.txt\f[].
+.PP
+In order to extract cookies from browser use any conforming browser
+extension for exporting cookies.
+For example,
+cookies.txt (https://chrome.google.com/webstore/detail/cookiestxt/njabckikapfpffapmjgojcnbfjonfjfg)
+(for Chrome) or Export
+Cookies (https://addons.mozilla.org/en-US/firefox/addon/export-cookies/)
+(for Firefox).
+.PP
 Note that the cookies file must be in Mozilla/Netscape format and the
 first line of the cookies file must be either
 \f[C]#\ HTTP\ Cookie\ File\f[] or
@@ -1605,6 +1622,47 @@ Another use case is working around
 CAPTCHA (https://en.wikipedia.org/wiki/CAPTCHA) some websites require
 you to solve in particular cases in order to get access (e.g.
 YouTube, CloudFlare).
+.SS How do I stream directly to media player?
+.PP
+You will first need to tell youtube\-dl to stream media to stdout with
+\f[C]\-o\ \-\f[], and also tell your media player to read from stdin (it
+must be capable of this for streaming) and then pipe former to latter.
+For example, streaming to vlc (http://www.videolan.org/) can be achieved
+with:
+.IP
+.nf
+\f[C]
+youtube\-dl\ \-o\ \-\ "http://www.youtube.com/watch?v=BaW_jenozKcj"\ |\ vlc\ \-
+\f[]
+.fi
+.SS How do I download only new videos from a playlist?
+.PP
+Use download\-archive feature.
+With this feature you should initially download the complete playlist
+with \f[C]\-\-download\-archive\ /path/to/download/archive/file.txt\f[]
+that will record identifiers of all the videos in a special file.
+Each subsequent run with the same \f[C]\-\-download\-archive\f[] will
+download only new videos and skip all videos that have been downloaded
+before.
+Note that only successful downloads are recorded in the file.
+.PP
+For example, at first,
+.IP
+.nf
+\f[C]
+youtube\-dl\ \-\-download\-archive\ archive.txt\ "https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re"
+\f[]
+.fi
+.PP
+will download the complete \f[C]PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re\f[]
+playlist and create a file \f[C]archive.txt\f[].
+Each subsequent run will only download new videos if any:
+.IP
+.nf
+\f[C]
+youtube\-dl\ \-\-download\-archive\ archive.txt\ "https://www.youtube.com/playlist?list=PLwiyx1dc3P2JR9N8gQaQN_BCvlSlap7re"
+\f[]
+.fi
 .SS Can you add support for this anime video site, or site which shows
 current movies for free?
 .PP
diff --git a/network/youtube-dl/youtube-dl.SlackBuild b/network/youtube-dl/youtube-dl.SlackBuild
index 61ffa9a7fd..2de5ddd02c 100644
--- a/network/youtube-dl/youtube-dl.SlackBuild
+++ b/network/youtube-dl/youtube-dl.SlackBuild
@@ -24,7 +24,7 @@
 #  ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
 
 PRGNAM=youtube-dl
-VERSION=${VERSION:-2016.08.22}
+VERSION=${VERSION:-2016.08.28}
 BUILD=${BUILD:-1}
 TAG=${TAG:-_SBo}
 
diff --git a/network/youtube-dl/youtube-dl.info b/network/youtube-dl/youtube-dl.info
index 673486b9a5..12073d7559 100644
--- a/network/youtube-dl/youtube-dl.info
+++ b/network/youtube-dl/youtube-dl.info
@@ -1,8 +1,8 @@
 PRGNAM="youtube-dl"
-VERSION="2016.08.22"
+VERSION="2016.08.28"
 HOMEPAGE="https://rg3.github.io/youtube-dl"
-DOWNLOAD="https://github.com/rg3/youtube-dl/archive/2016.08.22.tar.gz"
-MD5SUM="f21ffd510fc40e4f1240df8ba177ecc0"
+DOWNLOAD="https://github.com/rg3/youtube-dl/archive/2016.08.28.tar.gz"
+MD5SUM="1d17f41d916ba595e985fe3b80febf26"
 DOWNLOAD_x86_64=""
 MD5SUM_x86_64=""
 REQUIRES=""