h1. Managing Torrents

[[Managing Torrents#Example-1|Example 1]] shows how to add a torrent to the engine and start the download
[[Managing Torrents#Example-2|Example 2]] shows how to hash check a torrent and show a progress indicator

h2. Example 1

<pre><code class="java">
    class MainClass
    {
        ClientEngine engine;
        string savePath;

        // savePath is the directory where downloads will be stored
        public MainClass(string savePath)
        {
            // Create a basic ClientEngine without changing any settings
            this.engine = new ClientEngine(new EngineSettings());
            this.savePath = savePath;
        }

        public void DownloadTorrent(string path)
        {
            // Open the .torrent file
            Torrent torrent = Torrent.Load(path);

            // Create the manager which will download the torrent to savePath
            // using the default settings.
            TorrentManager manager = new TorrentManager(torrent, savePath, new TorrentSettings());

            // Register the manager with the engine
            engine.Register(manager);

            // Begin the download
            manager.Start();
        }
    }
</code></pre>

h2. Example 2

<pre><code class="java">
        public void HashTorrent(TorrentManager manager)
        {
            // Note: The manager must be in the 'Stopped' state
            //in order to perform a hash check.

            manager.PieceHashed += delegate (object o, PieceHashedEventArgs e) {
                int pieceIndex = e.PieceIndex;
                int totalPieces = e.TorrentManager.Torrent.Pieces.Count;
                double progress = (double) pieceIndex / totalPieces * 100.0;
                if (e.HashPassed)
                    Console.WriteLine("Piece {0} of {1} is complete", pieceIndex, totalPieces);
                else
                    Console.WriteLine("Piece {0} of {1} is corrupt or incomplete ", pieceIndex, totalPieces);
                
                // This shows how complete the hashing is.
                Console.WriteLine("Total progress is: {0}%", progress);

                // This shows the percentage completion of the download. This value
                // is updated as the torrent is hashed or new pieces are downloaded
                Console.WriteLine("{0}% of the torrent is complete");
            };

            // If 'true' is passed, the torrent will automatically go to the 'Downloading' or 'Seeding'
            // state once the hash check is finished. Otherwise it will return to the 'Stopped' state.
            manager.HashCheck(false);
        }
</code></pre>

<pre><code class="java">


ClientEngine engine = new ClientEngine(new EngineSettings(downloadsPath, port));

//DHT
DhtListener dhtListner = new UdpListener (new IPEndPoint (IPAddress.Any, port));
DhtEngine dht = new DhtEngine (dhtListner);
engine.RegisterDht(dht);
dhtListner.Start();
//byte array of dht nodes can be null if you have never connect to DHT before today!
engine.DhtEngine.Start(nodes);


torrent = Torrent.Load("test.torrent");
TorrentManager manager = new TorrentManager(torrent, downloadsPath, torrentDefaults);

//FastResume code need a BencodedDictionnary
//If you jsut start the torrent, you have no fast resume
// but if you have download a part of the torrent you can save fast resume data 
//(manager.SaveFastResume()) and restore it later to do a quicker load
manager.LoadFastResume(new FastResume (BEncDictFastResume));

engine.Register(manager);
manager.Start ();

</code>
</pre>