Home

Awesome

BitSwarm: Bittorrent library (.net standard) for clients & streaming purposes

[Introduction]

BitSwarm implements Bittorrent Protocol v2 from scratch to achieve best performance and to expose low-level parameters for customization. It uses a custom thread pool and part files (<a href="https://github.com/SuRGeoNix/APF">APF</a>) for fast resume from previous incomplete session.

[Supports]

[Todo]

[Examples]

1. Library Overview

// Step 0: Prepare BitSwarm's Options (Timeouts/Feeders/Logging etc.)

Options opt = new Options();
	//opt.X = Y; check Options.cs for all available options

// Step 1: Create BitSwarm Instance

	// With Default Options
BitSwarm bitSwarm = new BitSwarm();
	// With Custom Options
BitSwarm bitSwarm = new BitSwarm(opt);

// Step 2: Subscribe events

	// Receives torrent data (on torrent file/session will fire directly, on magnetlink/hash will fire on metadata received - notify user with torrent detail and optionally choose which files to include)
bitSwarm.MetadataReceived   += BitSwarm_MetadataReceived; 	// e.Torrent
	// Receives statistics (refresh every 2 seconds - notify user with the current connections/bytes/speed of downloading)
bitSwarm.StatsUpdated       += BitSwarm_StatsUpdated;		// e.Stats
	// Notifies with the new status (notify user with 0: Finished, 1: Stopped, 2: Error)
bitSwarm.StatusChanged      += BitSwarm_StatusChanged;		// e.Status
	// Notifies that is going to stop (user can prevent it from finishing, by including other previously excluded files)
bitSwarm.OnFinishing        += BitSwarm_OnFinishing;		// e.Cancel

// Step 3: Open input (Current BitSwarm's valid inputs Torrent File/Magnet Link/SHA1 Hash/Base32 Hash/Session File)

	// Open Torrent File
bitSwarm.Open("/home/surgeonix/ubuntu.torrent");
	// Open Magnet Link
bitSwarm.Open("magnet:?xt=urn:btih:D1101A2B9D202811A05E8C57C557A20BF974DC8A");
	// Open SHA1 Hash
bitSwarm.Open("D1101A2B9D202811A05E8C57C557A20BF974DC8A");
	// Open Base32 (SHA1) Hash
bitSwarm.Open("RX46NCATYQRS3MCQNSEXVZGCCDNKTASQ");

// Step 4: Start downloading
bitSwarm.Start();

// Step 5: Dispose when you are done
bitSwarm.Dispose();

2. <a href="https://github.com/SuRGeoNix/BitSwarm/blob/master/BitSwarm%20(Console%20Core%20Demo)/Program.cs">BitSwarm</a>: Console Client (.NET Core)

<p align="center"><img src="Images/bitswarm.gif"/></p>

3. <a href="https://github.com/SuRGeoNix/BitSwarm/blob/master/BitSwarm%20(WinForms%20Demo)/frmMain.cs">BitSwarm</a>: GUI Client (.NET Framework Winforms)

<p align="center"><img src="Images/bitswarm_gui.png"/></p>

4. <a href="https://github.com/SuRGeoNix/Flyleaf">Flyleaf</a>: Video Player & Torrent Streamer (.NET Framework Winforms)

<p align="center"><img src="Images/flyleaf.png"/></p>

Remarks

This project has been created for fun and educational reasons. Hopefully, it will help other developers to understand deeper the bittorrent protocol as the documentations and standards are very complicated and messy. I tried to add detailed comments within the code. Don't use it as is, it does not currently implement upload and sharing, which means that it is an arrogant and selfish beggar!

Logs SampleStats Sample 1
<a href="Images/logs1.png"><img src="Images/logs1.png" width="50%" heigt="50%"/></a><a href="Images/stats1.png"><img src="Images/stats1.png" width="50%" heigt="50%"/></a>
Stats Sample 2Stats Sample 3
<a href="Images/stats2.png"><img src="Images/stats2.png" width="50%" heigt="50%"/></a><a href="Images/stats3.png"><img src="Images/stats3.png" width="50%" heigt="50%"/></a>