[[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://bt.edwardk.info:6969/announce`||'''This must be first'''||
||`http://bt.edwardk.info:2710/announce`||
||`http://bt.edwardk.info:972/announce`||
||`http://bt.edwardk.info:4040/announce`||
||`http://bt.edwardk.info:676/announce`||
||`http://bt.edwardk.info:6767/announce`||
||`http://bt.edwardk.info:12891/announce`||
||`http://bt.edwardk.info:63124/announce`||
== 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 `80KB` 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)
||File size||||32768||65536||131072||262144||524288||1048576||2097152||4194304||8388608||16777216||
||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.

= Adding Torrents =
 * To add a torrent, upload the torrent file to the FTP you were provided with.
 * 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);
?>

}}}