https://github.com/joelanders/joetorrent

Toy BitTorrent client.
https://github.com/joelanders/joetorrent

Last synced: about 2 months ago
JSON representation

Toy BitTorrent client.

• Host: GitHub
• URL: https://github.com/joelanders/joetorrent
• Owner: joelanders
• License: gpl-3.0
• Created: 2013-10-19T23:18:33.000Z (almost 11 years ago)
• Default Branch: master
• Last Pushed: 2014-09-26T16:16:42.000Z (almost 10 years ago)
• Last Synced: 2024-02-13T02:15:59.732Z (7 months ago)
• Language: Ruby
• Homepage:
• Size: 332 KB
• Stars: 2
• Watchers: 3
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
#joetorrent

work-in-progress bittorrent client

Here's an overview of what it does so far:

````ruby

# load piece information from torrent file.

mi = Metainfo.from_file 'boa.torrent'

# do a tracker announce to get list of peers for this file.

mi.tracker.announce

# ignore that list of peers for now (because I can't get a socket to

# connect to a remote peer...NAT issues?) and connect to my local

# instance of Transmission, which is seeding boa.torrent

pr = Peer.new '127.0.0.1', 51413, mi

# open the tube

pr.connect_socket

# hi, I speak BitTorrent, my name is... and I'm looking for...

pr.do_handshake

# here are the pieces I have (none)

pr.socket.write Message.bitfield([], mi.num_pieces)

# right now, this logs messages and responds to keepalives

pr.start_event_loop

# wait a tick and check the messages...

# first message is the received handshake.

# second message is a bitfield with the pieces that the Transmission

#   client has. 0x05 is the message ID, and the rest is 1s because

#   the Transmission client has every piece.

# third message (0x01) is unchoke, indicating that the Transmission

#   client is ready to send me data.

pr.recd_messages

=> [[2013-10-26 16:42:08 -0700,

     "\x13BitTorrent protocol\x00\x00\x00\x00\x00\x10\x00\x05BCz\x1A\xC2\xB9fz\xBD\x85xt\xD01v\xD1\xFA\xB6t\xF6-TR2820-9dx8c364jfe8"],

    [2013-10-26 16:42:09 -0700, "\x05\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\xFF\x80"],

    [2013-10-26 16:42:15 -0700, "\x01"]]

    

# please send me the data starting at piece 0, index 0, and going

#   on for 16 bytes. (normally this would be 2**14 bytes)

pr.socket.write Message.request 0, 0, 2**4 

# check our messages again, and see that we got the data!

# "\a" is 0x07, which is the message id for a piece.

# the next 8 zero bytes are the piece # and index.

# after that is the beginning of the PDF we were looking for!

pr.recd_messages.last

=> [2013-10-26 16:42:56 -0700,

    "\a\x00\x00\x00\x00\x00\x00\x00\x00%PDF-1.3\n%\xE7\xF3\xCF\xD3\n2"]

````

Got a bit more protocol going; can lure another client into requesting pieces:

````

[1] pry(main)> puts pr.recd_messages

{:time=>2014-09-17 17:42:36 +0200, :handshake=>"\x13BitTorrent protocol\x00\x00\x00\x00\x00\x10\x00\x05BCz\x1A\xC2\xB9fz\xBD\x85xt\xD01v\xD1\xFA\xB6t\xF6-TR2840-w4ypr1729owj"}

{:time=>2014-09-17 17:42:36 +0200, :msg=>"\x01", :decoded=>:unchoke}

{:time=>2014-09-17 17:42:46 +0200, :msg=>"\x02", :decoded=>:interested}

{:time=>2014-09-17 17:42:46 +0200, :msg=>"\x06\x00\x00\x00H\x00\x00\x00\x00\x00\x00@\x00", :decoded=>{:request=>72, :start=>0, :length=>16384}}

{:time=>2014-09-17 17:42:46 +0200, :msg=>"\x06\x00\x00\x00H\x00\x00@\x00\x00\x00@\x00", :decoded=>{:request=>72, :start=>16384, :length=>16384}}

{:time=>2014-09-17 17:42:46 +0200, :msg=>"\x06\x00\x00\x00H\x00\x00\x80\x00\x00\x00@\x00", :decoded=>{:request=>72, :start=>32768, :length=>16384}}

{:time=>2014-09-17 17:42:46 +0200, :msg=>"\x06\x00\x00\x00H\x00\x00\xC0\x00\x00\x00$\x88", :decoded=>{:request=>72, :start=>49152, :length=>9352}}

````

GPLv3 license because I feel like it.