git-annex/doc/git-annex-importfeed.mdwn

# NAME

git-annex importfeed - import files from podcast feeds

# SYNOPSIS

git annex importfeed `[url ...]`

# DESCRIPTION

Imports the contents of podcast 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.

When quvi is installed, links in the feed are tested to see if they
are on a video hosting site, and the video is downloaded. This allows
importing e.g., youtube playlists.

To make the import process add metadata to the imported files from the feed,
`git config annex.genmetadata true`

# OPTIONS

* `--force`

  Force downloading items it's seen before.

* `--template`

  Controls where the files are stored.

  The default template is '${feedtitle}/${itemtitle}${extension}'
  
  Other available variables for templates: feedauthor, itemauthor, itemsummary, itemdescription, itemrights, itemid, itempubdate, title, author

* `--relaxed`, `--fast`, `--raw`, `--template`

  These options behave the same as when using [[git-annex-addurl]](1).

# SEE ALSO

[[git-annex]](1)

[[git-annex-addurl]](1)

# AUTHOR

Joey Hess <id@joeyh.name>

Warning: Automatically converted into a man page by mdwn2man. Edit with care.
splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00			`# NAME`

			`git-annex importfeed - import files from podcast feeds`

			`# SYNOPSIS`

			git annex importfeed `[url ...]`

			`# DESCRIPTION`

			`Imports the contents of podcast feeds. Only downloads files whose`
update importfeed man page, including a mention of annex.genmetadata 2015-03-31 17:48:13 +00:00			`content has not already been added to the repository before, so you can`
splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00			`delete, rename, etc the resulting files and repeated runs won't duplicate`
			`them.`

			`When quvi is installed, links in the feed are tested to see if they`
			`are on a video hosting site, and the video is downloaded. This allows`
			`importing e.g., youtube playlists.`

update importfeed man page, including a mention of annex.genmetadata 2015-03-31 17:48:13 +00:00			`To make the import process add metadata to the imported files from the feed,`
			`git config annex.genmetadata true`

splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00			`# OPTIONS`

			* `--force`

doc/*.mdwn: Various typo fixes 2015-05-30 14:54:14 +00:00			`Force downloading items it's seen before.`
splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00
			* `--template`

			`Controls where the files are stored.`

			`The default template is '${feedtitle}/${itemtitle}${extension}'`

			`Other available variables for templates: feedauthor, itemauthor, itemsummary, itemdescription, itemrights, itemid, itempubdate, title, author`

			* `--relaxed`, `--fast`, `--raw`, `--template`

			`These options behave the same as when using [[git-annex-addurl]](1).`

			`# SEE ALSO`

			`[[git-annex]](1)`

expand manpages cross-references significantly i found that most man pages only had references to the main git-annex manpage, which i stillfind pretty huge and hard to navigate through. i tried to sift through all the man pages and add cross-references between relevant pages. my general rule of thumb is that links should be both ways unless one of the pages is a more general page that would become ridiculously huge if all backlinks would be added (git-annex-preferred-content comes to mind). i have also make the links one per line as this is how it was done in the metadata pages so far. i did everything but the plumbing, utility and test commands, although some of those are linked from the other commands so cross-links were added there as well. 2015-05-29 16:12:55 +00:00			`[[git-annex-addurl]](1)`

splitting up the man page Common command man pages all split out and often expanded. A few sections split out into their own pages. Still need to do all the other commands.. 2015-03-23 19:36:10 +00:00			`# AUTHOR`

			`Joey Hess <id@joeyh.name>`

			`Warning: Automatically converted into a man page by mdwn2man. Edit with care.`