BitTorrent Client in Go
Pull request Compare This branch is 1 commit behind jtakkala:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.
controller.go For readability use &T{} in place of new() Mar 25, 2015
controller_test.go Update copyright, THANKS, and README Sep 5, 2014
main.go Eliminate tomb package completely and use quit channels Jul 21, 2014
peer.go Use defaults and keyed fields for net.TCPAddr Mar 25, 2015
piece.go formatted with go fmt Dec 5, 2013
server.go Use defaults and keyed fields for net.TCPAddr Mar 25, 2015
stats.go Re-factor stats, eliminate sync package, +comments Sep 7, 2014


Tulva is BitTorrent client written entirely in Go as a project for Hacker School fall 2013. It's currently a work in progress. We aim for correctness and protocol completeness: designing an optimal download strategy, implementing both upload and download, multiple tracker support, and the resumption of interrupted downloads. The authors are Jari Takkala and Brian Dignan. The name Tulva comes from the Finnish word for flood.



  • Parse torrent file
  • Verifies partially downloaded files on restart
  • Connects to tracker and retrieves a list of peers
  • Periodically reconnects to tracker every X interval
  • Connects to peers returned by the tracker
  • Initalizes a server process and accepts connections from peers
  • Completes peer handshake
  • Controller logic and tests 90% complete
  • Initialize local bitfield
  • Send bitfield to peers
  • Peer wire protocol
  • Verify received pieces and write to disk
  • Read pieces from disk and write to peer
  • Signal handler for CTRL-C and to initiate clean shutdown
  • UDP tracker support thanks to Rob Bassi


  • Handle multiple trackers and backup trackers
  • Track torrent and peer statistics and report back to tracker
  • Distributed Hash Table (DHT) support
  • Web interface for managing torrents
  • Support multiple simultaneous torrents


Tulva is licensed under the 2-clause BSD license. See LICENSE for more information.