NAME

       git-annex-importfeed - import files from podcast feeds

SYNOPSIS

       git annex importfeed [url ...]

DESCRIPTION

       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.

       When youtube-dl is installed, it can be used to download links in the feed.  This allows importing  e.g.,
       YouTube  playlists.   (However,  this  is  disabled  by  default  as  it can be a security risk.  See the
       documentation of annex.security.allowed-ip-addresses in git-annex(1) for details.)

       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
              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)

       git-annex-addurl(1)

AUTHOR

       Joey Hess <id@joeyh.name>

                                                                                         git-annex-importfeed(1)