PluginCreate.fr

---

= Create Plugin =

<wiki:toc />

== Description ==

This plugin allows for the creation of new .torrent files from a file or directory full of files.

== Usage ==

To use this plugin, click the "Create a torrent" icon: [http://rutorrent.googlecode.com/svn/wiki/images/icon08create.png]

This should open the "Create new Torrent" window as shown below:

[http://rutorrent.googlecode.com/svn/wiki/images/PluginCreate/createbase.png]

Next, add a file source _(note: the [Plugin_getdir getdir] plugin will make this a much easier process)

[http://rutorrent.googlecode.com/svn/wiki/images/PluginCreate/createselectsource.png]

Next, fill in the tracker information (note: for public trackers, you may wish to enter more than one tracker here)

[http://rutorrent.googlecode.com/svn/wiki/images/PluginCreate/createtracker.png]

Optional: Select a "piece size"

[http://rutorrent.googlecode.com/svn/wiki/images/PluginCreate/createpiecesize.png]

Optional: Fill in the checkboxed

Start seeding this will add the torrent to the download list immediately upon creation

Private Torrent select this if you are uploading to a private tracker

[http://rutorrent.googlecode.com/svn/wiki/images/PluginCreate/createcheckboxes.png]

Click "Create ..." This will open the "Create Console window", here you can see the progress, any status information and errors that occur:

[http://rutorrent.googlecode.com/svn/wiki/images/PluginCreate/createrunning.png]

When everything is finished and you see "Done." in the status window, you have the option to download the .torrent file directly from rutorrent by clicking the "Save" button:

[http://rutorrent.googlecode.com/svn/wiki/images/PluginCreate/createsave.png]

== Configuration ==

This plugin has a few config options. Prior to 3.0, "create plugin" in it's default state couldn't handle large torrents. If you are on a 64 bit os, this is no longer the case.

You can still use several external programs to create torrents with this plugin. Currently the plugin supports:

[http://www.transmissionbt.com/ transmissioncli] This is the cli install of transmission, originally added because createtorrent was horribly slow on BSD systems

createtorrent A linux command line tool for creating torrents

[http://mktorrent.sourceforge.net/ mktorrent] * A light weight, VERY SMALL command line torrent tool for bsd/linux *

[http://claudiusmaximus.goto10.org/cm/torrent.html buildtorrent] *Yet another lightweight command line tool for creating torrents *

The default config file looks like this:

{{{

}}}

This should be pretty easy to understand, but some people still get this wrong. If you are using an external program, pick the correct option, and change useExternal accordingly, so for example, for mktorrent, you'd change THIS:

{{{ $useExternal = false; }}}

TO THIS:

{{{ $useExternal = 'mktorrent'; }}}

and, of course, add the proper PATH in the location provided, so keeping with our previous example, lets say mktorrent is located at /usr/local/bin/mktorrent, you'd change this:

{{{ $pathToCreatetorrent = ''; }}}

to this: {{{ $pathToCreatetorrent = '/usr/local/bin/mktorrent'; }}}