102 lines
3.1 KiB
Markdown
102 lines
3.1 KiB
Markdown
# 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`
|
|
|
|
By default, the downloaded files are put in a directory with the title
|
|
of the feed, and files are named based on the title of the item in the
|
|
feed. This can be changed using the --template option.
|
|
|
|
Existing files are not overwritten by this command. If "some feed/foo.mp3"
|
|
already exists, it will instead write to "some feed/2\_foo.mp3"
|
|
(or 3, 4, etc). Sometimes a feed will change an item's url,
|
|
resulting in the new url being downloaded to such a filename.
|
|
|
|
# OPTIONS
|
|
|
|
* `--force`
|
|
|
|
Force downloading items it's seen before.
|
|
|
|
* `--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.
|
|
|
|
* `--template`
|
|
|
|
Controls where the files are stored.
|
|
|
|
The default template is '${feedtitle}/${itemtitle}${extension}'
|
|
|
|
The available variables in the template include these that
|
|
are information about the feed: feedtitle, feedauthor
|
|
|
|
And these that are information about individual items in the feed:
|
|
itemtitle, itemauthor, itemsummary, itemdescription, itemrights,
|
|
itemid.
|
|
|
|
Also, title is itemtitle but falls back to feedtitle if the item has no
|
|
title, and author is itemauthor but falls back to feedauthor.
|
|
|
|
(All of the above are also added as metadata when annex.genmetadata is
|
|
set.)
|
|
|
|
The extension variable is the extension of the file in the feed,
|
|
or sometimes ".m" if no extension can be determined.
|
|
|
|
The template also has some variables for when an item was published.
|
|
|
|
itempubyear (YYYY), itempubmonth (MM), itempubday (DD), itempubhour (HH),
|
|
itempubminute (MM), itempubsecond (SS),
|
|
itempubdate (YYYY-MM-DD or if the feed's date cannot be parsed, the raw
|
|
value from the feed).
|
|
|
|
(These use the UTC time zone, not the local time zone.)
|
|
|
|
# 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.
|