README.md

   1 # torrent
   2
   3 [![Codeship](https://www.codeship.io/projects/a2811d30-b0ce-0132-8983-5e604f7ebe37/status)](https://codeship.com/projects/69674)
   4 [![GoDoc](https://godoc.org/github.com/anacrolix/torrent?status.svg)](https://godoc.org/github.com/anacrolix/torrent)
   5
   6 This repository implements BitTorrent-related packages and command-line utilities in Go.
   7
   8 There is support for protocol encryption, DHT, PEX, uTP, and various extensions. There are several storage backends provided, blob, file, mmap. You can use the provided binaries in `./cmd`, or use `torrent` as a library for your own applications.
   9
  10 ## Installation
  11
  12 Install the library package with `go get github.com/anacrolix/torrent`, or the provided cmds with `go get github.com/anacrolix/torrent/cmd/...`.
  13
  14 ## Library example
  15
  16 There is a small example in the [package documentation](https://godoc.org/github.com/anacrolix/torrent).
  17
  18 ## Torrent utility
  19
  20 There's a provided utility that downloads torrents from the command-line.
  21
  22         $ go get github.com/anacrolix/torrent/cmd/torrent
  23         $ torrent 'magnet:?xt=urn:btih:ZOCMZQIPFFW7OLLMIC5HUB6BPCSDEOQU'
  24     2015/03/20 22:51:41 main.go:96: downloaded ALL the torrents
  25     $ md5sum ubuntu-14.04.1-desktop-amd64.iso
  26     119cb63b48c9a18f31f417f09655efbd  ubuntu-14.04.1-desktop-amd64.iso
  27     $ echo such amaze
  28     wow