FedP2P/README.md

89 lines
4.9 KiB
Markdown
Raw Normal View History

2015-03-20 20:18:09 +08:00
# torrent
2020-11-05 15:10:14 +08:00
[![PkgGoDev](https://pkg.go.dev/badge/github.com/anacrolix/torrent)](https://pkg.go.dev/github.com/anacrolix/torrent)
2015-03-20 20:18:09 +08:00
2018-01-28 15:43:16 +08:00
This repository implements BitTorrent-related packages and command-line utilities in Go. The emphasis is on use as a library from other projects. It's been used 24/7 in production by downstream services since late 2014. The implementation was specifically created to explore Go's concurrency capabilities, and to include the ability to stream data directly from the BitTorrent network. To this end it [supports seeking, readaheads and other features](https://godoc.org/github.com/anacrolix/torrent#Reader) exposing torrents and their files with the various Go idiomatic `io` package interfaces. This is also demonstrated through [torrentfs](#torrentfs).
2015-03-20 20:18:09 +08:00
2020-11-09 06:20:05 +08:00
There is [support for protocol encryption, DHT, PEX, uTP, and various extensions](https://godoc.org/github.com/anacrolix/torrent). There are [several data storage backends provided](https://godoc.org/github.com/anacrolix/torrent/storage): blob, file, bolt, mmap, and sqlite, to name a few. You can [write your own](https://godoc.org/github.com/anacrolix/torrent/storage#ClientImpl) to store data for example on S3, or in a database.
2015-07-18 23:12:50 +08:00
2018-01-28 15:43:16 +08:00
Some noteworthy package dependencies that can be used for other purposes include:
* [go-libutp](https://github.com/anacrolix/go-libutp)
* [dht](https://github.com/anacrolix/dht)
* [bencode](https://godoc.org/github.com/anacrolix/torrent/bencode)
* [tracker](https://godoc.org/github.com/anacrolix/torrent/tracker)
2015-03-20 20:18:09 +08:00
## Installation
2021-08-22 13:52:35 +08:00
Install the library package with `go get github.com/anacrolix/torrent`, or the provided cmds with `go install github.com/anacrolix/torrent/cmd/...@latest`.
2015-03-20 20:18:09 +08:00
## Library examples
2015-03-20 20:18:09 +08:00
There are some small [examples](https://godoc.org/github.com/anacrolix/torrent#pkg-examples) in the package documentation.
2015-03-20 20:18:09 +08:00
## Mentions
2021-09-08 11:46:03 +08:00
* [@anacrolix](https://github.com/anacrolix) is interviewed about this repo in [Console 32](https://console.substack.com/p/console-32).
### Downstream projects
2015-10-16 19:07:13 +08:00
There are several web-frontends and Android clients among the known public projects:
* [Torrent.Express](https://torrent.express/)
* [Confluence](https://github.com/anacrolix/confluence)
* [Trickl](https://github.com/arranlomas/Trickl)
2020-11-18 22:49:22 +08:00
* [Elementum](http://elementum.surge.sh/) (up to version 0.0.71)
* [goTorrent](https://github.com/deranjer/goTorrent)
2015-10-16 19:07:13 +08:00
* [Go Peerflix](https://github.com/Sioro-Neoku/go-peerflix)
2020-11-18 22:49:22 +08:00
* [Simple Torrent](https://github.com/boypt/simple-torrent) (fork of [Cloud Torrent](https://github.com/jpillora/cloud-torrent), unmaintained)
2016-12-31 16:07:02 +08:00
* [Android Torrent Client](https://gitlab.com/axet/android-torrent-client)
* [libtorrent](https://gitlab.com/axet/libtorrent)
* [Remote-Torrent](https://github.com/BruceWangNo1/remote-torrent)
2019-04-16 07:47:07 +08:00
* [ANT-Downloader](https://github.com/anatasluo/ant)
2020-03-21 03:16:32 +08:00
* [Go-PeersToHTTP](https://github.com/WinPooh32/peerstohttp)
* [CortexFoundation/torrentfs](https://github.com/CortexFoundation/torrentfs): P2P file system of cortex full node
2021-08-10 09:13:00 +08:00
* [TorrServ](https://github.com/YouROK/TorrServer): Torrent streaming server over http.
2020-03-21 03:16:32 +08:00
## Help
2021-05-04 09:08:59 +08:00
Communication about the project is primarily through [Discussions](https://github.com/anacrolix/torrent/discussions) and the [issue tracker](https://github.com/anacrolix/torrent/issues).
2015-10-16 19:07:13 +08:00
## Command packages
2015-04-01 11:36:38 +08:00
2021-09-08 11:45:25 +08:00
Here I'll describe what some of the packages in `./cmd` do. See [installation](#installation) to make them available.
2015-03-20 20:18:09 +08:00
2015-04-01 11:36:38 +08:00
### torrent
Downloads torrents from the command-line.
2015-03-20 20:18:09 +08:00
2020-11-09 06:20:05 +08:00
$ torrent download 'magnet:?xt=urn:btih:KRWPCX3SJUM4IMM4YF5RPHL6ANPYTQPU'
... lots of jibba jabber ...
downloading "ubuntu-14.04.2-desktop-amd64.iso": 1.0 GB/1.0 GB, 1989/1992 pieces completed (1 partial)
2015-04-01 11:36:38 +08:00
2015/04/01 02:08:20 main.go:137: downloaded ALL the torrents
$ md5sum ubuntu-14.04.2-desktop-amd64.iso
1b305d585b1918f297164add46784116 ubuntu-14.04.2-desktop-amd64.iso
2015-03-20 20:18:09 +08:00
$ echo such amaze
2015-03-21 21:11:45 +08:00
wow
2015-04-01 11:36:38 +08:00
### torrentfs
torrentfs mounts a FUSE filesystem at `-mountDir`. The contents are the torrents described by the torrent files and magnet links at `-metainfoDir`. Data for read requests is fetched only as required from the torrent network, and stored at `-downloadDir`.
2015-04-01 11:36:38 +08:00
$ mkdir mnt torrents
$ torrentfs -mountDir=mnt -metainfoDir=torrents &
2015-04-01 11:36:38 +08:00
$ cd torrents
$ wget http://releases.ubuntu.com/14.04.2/ubuntu-14.04.2-desktop-amd64.iso.torrent
$ cd ..
$ ls mnt
ubuntu-14.04.2-desktop-amd64.iso
$ pv mnt/ubuntu-14.04.2-desktop-amd64.iso | md5sum
996MB 0:04:40 [3.55MB/s] [========================================>] 100%
1b305d585b1918f297164add46784116 -
### torrent-magnet
Creates a magnet link from a torrent file. Note the extracted trackers, display name, and info hash.
$ torrent-magnet < torrents/ubuntu-14.04.2-desktop-amd64.iso.torrent
2020-11-09 06:20:05 +08:00
magnet:?xt=urn:btih:546cf15f724d19c4319cc17b179d7e035f89c1f4&dn=ubuntu-14.04.2-desktop-amd64.iso&tr=http%3A%2F%2Ftorrent.ubuntu.com%3A6969%2Fannounce&tr=http%3A%2F%2Fipv6.torrent.ubuntu.com%3A6969%2Fannounce