mirrors/git-annex
2
0
Fork 0
Code Issues Pull requests Projects Releases Packages 1 Wiki Activity Actions

Added bittorrent special remote

Browse source 
addurl behavior change: When downloading an url ending in .torrent,
it will download files from bittorrent, instead of the old behavior
of adding the torrent file to the repository.

Added Recommends on aria2 and bittornado | bittorrent.

This commit was sponsored by Asbjørn Sloth Tønnesen.
This commit is contained in:
Joey Hess 2014-12-16 23:22:46 -04:00
parent 386880a763
commit a7690de016
12 changed files with 404 additions and 7 deletions
Download patch file Download diff file Expand all files Collapse all files

4
doc/git-annex.mdwn
View file

@ -1728,6 +1728,10 @@ Here are all the supported configuration settings.
Options to pass to quvi when using it to find the url to download for a
video.
* `annex.aria-torrent-options`
Options to pass to aria2c when using it to download a torrent.
* `annex.http-headers`
HTTP headers to send when downloading from the web. Multiple lines of

1
doc/special_remotes.mdwn
View file

@ -17,6 +17,7 @@ They cannot be used by other git commands though.
* [[webdav]]
* [[tahoe]]
* [[web]]
* [[bittorrent]]
* [[xmpp]]
* [[hook]]

25
doc/special_remotes/bittorrent.mdwn Normal file
View file

@ -0,0 +1,25 @@
Similar to the [[web]] special remote, git-annex can use BitTorrent as
a source for files that are added to the git-annex repository.
It supports both `.torrent` files, and `magnet:` links. When you run `git
annex addurl` with either of these, it will download the contents of the
torrent and add it to the git annex repository.
See [[tips/using_the_web_as_a_special_remote]] for usage examples.
git-annex uses [aria2](http://aria2.sourceforge.net/) to download torrents.
It also needs the `btshowmetainfo` program, from either
bittornado or the original BitTorrent client.
## notes
Currently git-annex only supports downloading content from a torrent;
it cannot upload or remove content.
Torrent swarms tend to come and go, so git-annex defaults to *not*
trusting the bittorrent special remote.
Multi-file torrents are supported; to handle them, `git annex addurl`
will add a directory containing all the files from the torrent. To
specify a single file from a multi-file torrent, append "#n" to its url;
"#1" is the first file, "#2" is the second, and so on.

12
doc/tips/using_the_web_as_a_special_remote.mdwn
View file

@ -104,6 +104,18 @@ feed is "http://gdata.youtube.com/feeds/api/playlists/PL4F80C7D2DC8D9B6C"
More details about youtube feeds at <http://googlesystem.blogspot.com/2008/01/youtube-feeds.html>
-- `git-annex importfeed` should handle all of them.
## bittorrent
The [[bittorrent_special_remote|special_remotes/bittorrent]] lets git-annex
also download the content of torrent files, and magnet links to torrents.
You can simply pass the url to a torrent to `git annex addurl`
the same as any other url.
You have to have [aria2](http://aria2.sourceforge.net/)
and bittornado (or the original bittorrent) installed for this
to work.
## podcasts
This is done using `git annex importfeed`. See [[downloading podcasts]].