documentation update for youtube-dl

Code not updated yet.

This commit was sponsored by Thomas Hochstein on Patreon.
This commit is contained in:
Joey Hess 2017-11-28 14:05:58 -04:00
parent d1d04a3c65
commit d6d8f72957
No known key found for this signature in database
GPG key ID: DB12DB0FF05F8F38
8 changed files with 45 additions and 29 deletions

View file

@ -74,8 +74,8 @@ and transferring to your laptop on demand.
## youtube playlists
You can also use `git annex importfeed` on youtube playlists.
It will use quvi to automatically download the videos linked to
by the playlist.
It will use [youtube-dl](https://rg3.github.io/youtube-dl/) to automatically
download the videos linked to by the playlist.
To download a youtube playlist, you need to find the feed associated with that
playlist, and pass it to `git annex importfeed`. There does not seem to be

View file

@ -68,35 +68,31 @@ number takes that many paths from the end.
## videos
<a name=quvi></a>
<a name=videos></a>
There's support for downloading videos from sites like YouTube, Vimeo,
and many more. This relies on [quvi](http://quvi.sourceforge.net/) to find
urls to the actual videos files.
and many more. This relies on [youtube-dl](https://rg3.github.io/youtube-dl/)
to download the videos.
When you have quvi installed, you can just
When you have youtube-dl installed, you can just
`git annex addurl http://youtube.com/foo` and it will detect that
it is a video and download the video content for offline viewing.
Later, in another clone of the repository, you can run `git annex get` on
the file and it will also be downloaded with the help of quvi. This works
the file and it will also be downloaded with youtube-dl. This works
even if the video host has transcoded or otherwise changed the video
in the meantime; the assumption is that these video files are equivalent.
There is an `annex.quvi-options` configuration setting that can be used
There is an `annex.youtube-dl-options` configuration setting that can be used
to pass parameters to quvi. For example, you could set `git config
annex.quvi-options "--format low"` to configure it to download low
quality videos from YouTube.
annex.youtube-dl-options "--format worst"` to configure it to download low
quality videos from YouTube. Note that the youtube-dl configuration files
are not read when git-annex runs youtube-dl, to avoid config settings that
break its integration.
Note that for performance reasons, the url is not checked for redirects,
so some shortened urls will not be detected. You can
either load the short url in a browser to get the full url, or you
can force use of quvi with redirect detection, by prepending "quvi:" to the
url.
To download a youtube playlist, you need to find the feed associated with that
playlist, and pass it to `git annex importfeed`. There does not seem to be
an easy link anywhere to get the feed, but you can construct its url
To download a youtube playlist, you need to find the RSS feed associated with
that playlist, and pass it to `git annex importfeed`. There does not seem to
be an easy link anywhere to get the RSS feed, but you can construct its url
manually. For a playlist like
"https://www.youtube.com/playlist?list=PL4F80C7D2DC8D9B6C", the
feed is "https://www.youtube.com/feeds/videos.xml?playlist_id=PL4F80C7D2DC8D9B6C"