[[PageOutline]]
= Creating Torrents =
== Suggested Programs ==
 * [http://azureus.sourceforge.net/ Azureus]
 * [http://www.utorrent.com/ µTorrent]
 * [http://krypt.dyndns.org:81/torrent/maketorrent/ MakeTorrent]
== Announce URLs ==
Announce URLs specify what trackers a torrent will use.
Create a torrent with the following announce URLs
||`http://bt2.edwardk.info:6969/announce`||'''This must be first'''||
||`http://bt2.edwardk.info:2710/announce`||
||`http://bt2.edwardk.info:4040/announce`||

Your torrent should look similar to [http://bt.edwardk.info/trac/raw-attachment/wiki/Instructions/Sample.torrent this].

Each entry should be within the SAME group.

== Piece Size ==
Most torrent creation programs allow automatic selection of piece size, you should use that exists.
If not, then `256KB/2^18` for `175MB` files is a good choice.
For larger torrents, increase the piece size. `2MB/2048KB/2^21` or higher is a must for batch torrents.
'''Torrents larger than `200KB` are not allowed.'''
This is a table that shows approximate torrent size vs piece size. Setting your program to auto will usually be fine.
(Figures in bytes except where noted)
||||Piece size||2^15^||2^16^||2^17^||2^18^||2^19^||2^20^||2^21^||2^21^||2^22^||2^23^||
||||||32,768||65,536||131,072||262,144||524,288||1,048,576||2,097,152||4,194,304||8,388,608||16,777,216||
||File size||||32KB||64KB||128KB||256KB||512KB||1024KB||2048KB||4096KB||8192KB||16384KB||
||1,048,576||1MB||1,140||820||660||580||540||520||520||520||520||520||
||52,428,800||50MB||32,500||16,500||8,500||4,500||2,500||1,500||1,000||750||625||563||
||146,800,640||140MB||90,100||45,300||22,900||11,700||6,100||3,300||1,900||1,200||850||675||
||183,500,800||175MB||112,500||56,500||28,500||14,500||7,500||4,000||2,250||1,375||938||719||
||244,318,208||233MB||149,620||75,060||37,780||19,140||9,820||5,160||2,830||1,665||1,083||791||
||367,001,600||350MB||~~224,500~~||112,500||56,500||28,500||14,500||7,500||4,000||2,250||1,375||938||
||681,574,400||650MB||~~416,500~~||~~208,500~~||104,500||52,500||26,500||13,500||7,000||3,750||2,125||1,313||
||734,003,200||700MB||~~448,500~~||~~224,500~~||112,500||56,500||28,500||14,500||7,500||4,000||2,250||1,375||
||1,468,006,400||1400MB||~~896,500~~||~~448,500~~||~~224,500~~||112,500||56,500||28,500||14,500||7,500||4,000||2,250||
||2,936,012,800||2800MB||~~1,792,500~~||~~896,500~~||~~448,500~~||~~224,500~~||112,500||56,500||28,500||14,500||7,500||4,000||
||4,700,000,000||4482MB||~~2,869,152~~||~~1,434,826~~||~~717,663~~||~~359,082~~||179,791||90,145||45,323||22,911||11,706||6,103||
||8,500,000,000||8106MB||~~5,188,488~~||~~2,594,494~~||~~1,297,497~~||~~648,999~~||~~324,749~~||162,625||81,562||41,031||20,766||10,633||
||Overhead||500 bytes||||||||||||||||||||||
Overhead includes tracker URLs, Description, torrent overhead, etc.

Formula is `(file size / piece size) * 20 + overhead`
= Web Interface =
 * http://bt.edwardk.info/upload/
Log on with your provided FTP user & password. You can add and remove torrents from there.

= Adding Torrents =
 * To add a torrent, upload the torrent file to the FTP you were provided with.
 * Your login info is generally the group name and your password. Host: bt.edwardk.info Port: 5021
 * Torrents will show up only after they have been seeded or used.
 * Torrent filenames '''must use standard ASCII'''. Filenames inside the torrent should be encoded with UTF-8.
 * It will take less than 2 minutes for a torrent to be recognized after it's been uploaded.
= Removing Torrents =
To remove a torrent, delete the torrent file from the FTP you were provided with and check if you can see the torrent in the `/mirrors/` folder. Delete from there if required as well.

= Setting Up Categories =
Below is a sample configuration file.
The easiest way to add a new category is to add:
{{{
$i++; // Start next category
$categories[$i]['heading'] = '<h3>Some new category</h3>';
$categories[$i]['wildcards'] = '*Some new category*';
$categories[$i]['name'] = 'Some new category';
}}}
below the predefined categories.
You can copy and paste this and only change the values. `$i++` will increase the number for you so you don't have to number it yourself.
= Configuration File =
You can edit the configuration file to your preferred options.[[BR]]

See http://php.net/manual/en/language.types.string.php for how strings are to be handled.[[BR]]

See http://php.net/manual/en/function.array.php for how arrays are to be handled.[[BR]]


A text editor with syntax highlighting for PHP files can be very useful, such as [http://notepad-plus.sourceforge.net/ Notepad++].
= Sample Configuration File =
{{{
#!php
<?

define("CHANNELNAME",	'#%chan%');		// The channel name we display
define("NETWORKNAME",	'%network%'); 			//The network name we display
define("IRCSERVER",	'%irc%');		//IRC server name, incase it differs from the name of the network
define("WEBSITEURL",	'%website%'); 	//Website

//Some of the help messages
define("USERTEXT",	'');

define("TEMPLATE",'bt_templates\\main.inc.php');
define("ENTRYTEMPLATE",'bt_templates\\entry.inc.php');

$allowed_announces = array("http://bt.edwardk.info:6969/announce");
						// a list of allowed announce URLs in torrents,
						// modify only if you know what you're doing

/*
	Controls where uncategorized torrents go
	Top = top of the page
	Bottom = bottom of the page
*/
$settings['uncategorized_position'] = 'bottom';

/*
	Sort categories
	TRUE = categories are sorted, with exception of the uncategorized category, it will be sorted by the name value
	FALSE = categories are used in the order specified in this config file
*/
$settings['sort_categories'] = TRUE;


/*
	Show recent torrents
	TRUE = on
	FALSE = off
	number = how many entries to display per column
*/
$settings['recent']['status'] = TRUE;
$settings['recent']['number'] = 5;


/*
	Table of Contents (TOC)
	TRUE = show it
	FALSE = don't show it
	number = how many to show per column
*/
$settings['toc']['status'] = TRUE;
$settings['toc']['number'] = 7;
/*
	Define categories here
		0 is uncategorized torrents
		1 is the recent torrents
		2+ are user defined categories
		heading = allows you to insert HTML before the table for this category, be sure to quote it properly in a PHP variable.
		          be sure to use HTML entities when required!
		wildcards = which filenames are matched to this category, multiple wildcards could be used if it was in an array
                             such as array('*blah*','*yada*');
                             wildcards match the display name of a torrent, not filename!
		name = for sorting categories and TOC
		http://www.php.net/manual/en/language.types.string.php
*/
$i = 0;
$categories[$i]['heading'] = '<h3>Uncategorized</h3>';
$categories[$i]['wildcards'] = '';
$categories[$i]['name'] = 'Uncategorized';

$i++; // Start next category
$categories[$i]['heading'] = '<h3>New Torrents</h3>';
$categories[$i]['wildcards'] = '';
$categories[$i]['name'] = 'New Torrents';


// End of user editable contents'

define("CACHEFILE",'btcache.dat');
define("CACHETIME",120);
?>

}}}