aboutsummaryrefslogtreecommitdiff
path: root/doc/git-annex-importfeed.mdwn
diff options
context:
space:
mode:
authorGravatar Joey Hess <joeyh@joeyh.name>2017-11-29 17:05:27 -0400
committerGravatar Joey Hess <joeyh@joeyh.name>2017-11-29 17:30:02 -0400
commit09d49fd8ace467463a83ecaf775cbed24f8fa0bd (patch)
tree496e4cc1c903b7ac7678ffe60e31c682985f6009 /doc/git-annex-importfeed.mdwn
parent3b3f7512f6d0b91de21f6fcc4aba8897174bc4a8 (diff)
convert importfeed to youtube-dl
Fully working, including --fast/--relaxed. Note that, while git-annex addurl --relaxed is not going to check youtube-dl, I kept git annex importfeed --relaxed checking it. Thinking is that, let's not break people's importfeed cron jobs, and importfeed does not typically have to check a large number of new items, so it's ok if it's a little bit slower when used with youtube playlist feeds. importfeed's behavior is also improved (?) when a feed has links in it to non-media files. Before, those were skipped. Now, the content of the link is downloaded. This had to be done, because trying to use youtube-dl is slow, and if those were skipped, it would have to check every time importfeed was run. While this behavior change may not be desirable for some feeds, that intersperse links to web pages with enclosures, it will be desirable for other feeds, that have non-enclosure directy links to media files. Remove old quvi modules. This commit was sponsored by Øyvind Andersen Holm.
Diffstat (limited to 'doc/git-annex-importfeed.mdwn')
-rw-r--r--doc/git-annex-importfeed.mdwn19
1 files changed, 18 insertions, 1 deletions
diff --git a/doc/git-annex-importfeed.mdwn b/doc/git-annex-importfeed.mdwn
index 99eec85a4..2f146fbfe 100644
--- a/doc/git-annex-importfeed.mdwn
+++ b/doc/git-annex-importfeed.mdwn
@@ -8,7 +8,7 @@ git annex importfeed `[url ...]`
# DESCRIPTION
-Imports the contents of podcast feeds. Only downloads files whose
+Imports the contents of podcasts and other feeds. Only downloads files whose
content has not already been added to the repository before, so you can
delete, rename, etc the resulting files and repeated runs won't duplicate
them.
@@ -37,6 +37,23 @@ To make the import process add metadata to the imported files from the feed,
These options behave the same as when using [[git-annex-addurl]](1).
+* `--fast`
+
+ Avoid immediately downloading urls. The url is still checked
+ (via HEAD) to verify that it exists, and to get its size if possible.
+
+* `--relaxed`
+
+ Don't immediately download urls, and avoid storing the size of the
+ url's content. This makes git-annex accept whatever content is there
+ at a future point.
+
+* `--raw`
+
+ Prevent special handling of urls by youtube-dl, bittorrent, and other
+ special remotes. This will for example, make importfeed
+ download a .torrent file and not the contents it points to.
+
# SEE ALSO
[[git-annex]](1)