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)
AUTHOR
Joey Hess id@joeyh.name
Warning: Automatically converted into a man page by mdwn2man. Edit with care.
I just thought it was surprising behavior, especially when
git-annex addurl --file 123-45.ext $url
preserves the dash in the filename, yet the rss I constructed to add multiple urls, with files, didn't do this.The new
--batch --with-files
options to addurl will eliminate the need to create specially crafted rss files.Thanks! :)
All spaces and punctuation (other than '.') and other wacky stuff are replaced with '_' when git-annex builds a filename from some untrusted source like a feed.
I think it makes sense to do that even for '-', at least if it's at the start of a filename. "--force" is not a filename you want to let a feed inject into your work tree. I could perhaps be convinced to let '-' elsewhere in the filename through unmunged, but simplicity and consistency suggests it's just as good to always munge it.
An example rss item entry:
Using --template '${itemtitle}${extension}'
The resulting filename is 00135929509939_04.jpg (The dash was replaced with an underscore).
I decided to just change all the filenames in each blog repository to use underscores, however, I thought you might want to know about this.