Managing Torrents¶

Example 1 shows how to add a torrent to the engine and start the download
Example 2 shows how to hash check a torrent and show a progress indicator

Example 1¶

 1     class MainClass
 2     {
 3         ClientEngine engine;
 4         string savePath;
 5 
 6         // savePath is the directory where downloads will be stored
 7         public MainClass(string savePath)
 8         {
 9             // Create a basic ClientEngine without changing any settings
10             this.engine = new ClientEngine(new EngineSettings());
11             this.savePath = savePath;
12         }
13 
14         public void DownloadTorrent(string path)
15         {
16             // Open the .torrent file
17             Torrent torrent = Torrent.Load(path);
18 
19             // Create the manager which will download the torrent to savePath
20             // using the default settings.
21             TorrentManager manager = new TorrentManager(torrent, savePath, new TorrentSettings());
22 
23             // Register the manager with the engine
24             engine.Register(manager);
25 
26             // Begin the download
27             manager.Start();
28         }
29     }

Example 2¶

 1         public void HashTorrent(TorrentManager manager)
 2         {
 3             // Note: The manager must be in the 'Stopped' state
 4             //in order to perform a hash check.
 5 
 6             manager.PieceHashed += delegate (object o, PieceHashedEventArgs e) {
 7                 int pieceIndex = e.PieceIndex;
 8                 int totalPieces = e.TorrentManager.Torrent.Pieces.Count;
 9                 double progress = (double) pieceIndex / totalPieces * 100.0;
10                 if (e.HashPassed)
11                     Console.WriteLine("Piece {0} of {1} is complete", pieceIndex, totalPieces);
12                 else
13                     Console.WriteLine("Piece {0} of {1} is corrupt or incomplete ", pieceIndex, totalPieces);
14 
15                 // This shows how complete the hashing is.
16                 Console.WriteLine("Total progress is: {0}%", progress);
17 
18                 // This shows the percentage completion of the download. This value
19                 // is updated as the torrent is hashed or new pieces are downloaded
20                 Console.WriteLine("{0}% of the torrent is complete");
21             };
22 
23             // If 'true' is passed, the torrent will automatically go to the 'Downloading' or 'Seeding'
24             // state once the hash check is finished. Otherwise it will return to the 'Stopped' state.
25             manager.HashCheck(false);
26         }

 1 
 2 ClientEngine engine = new ClientEngine(new EngineSettings(downloadsPath, port));
 3 
 4 //DHT
 5 DhtListener dhtListner = new UdpListener (new IPEndPoint (IPAddress.Any, port));
 6 DhtEngine dht = new DhtEngine (dhtListner);
 7 engine.RegisterDht(dht);
 8 dhtListner.Start();
 9 //byte array of dht nodes can be null if you have never connect to DHT before today!
10 engine.DhtEngine.Start(nodes);
11 
12 torrent = Torrent.Load("test.torrent");
13 TorrentManager manager = new TorrentManager(torrent, downloadsPath, torrentDefaults);
14 
15 //FastResume code need a BencodedDictionnary
16 //If you jsut start the torrent, you have no fast resume
17 // but if you have download a part of the torrent you can save fast resume data 
18 //(manager.SaveFastResume()) and restore it later to do a quicker load
19 manager.LoadFastResume(new FastResume (BEncDictFastResume));
20 
21 engine.Register(manager);
22 manager.Start ();
23