News
====
If you had trouble using the previous version (v0.91), then please try this
version.
PLEASE report your success or failure using CTorrentUI, because I guarantee that
no new versions will be released unless I get some feedback, simply because
CTorrentUI works perfectly for me! And so far I have had almost zero feedback.
Introduction
============
CTorrent is a nice Shell (command-line) program for downloading Torrents, but it
can be a pain to use since it doesn't have a GUI. Michael Trebilcock wrote a
GUI for it, called CTGUI, but it only works with the very old & buggy CTorrent
v1.3.2, and it lacks some features.
CTorrentUI is based upon CTGUI, but has been massively re-written (partly so I
could understand it!), and is designed to work with CTorrent v1.4.3 . Since
CTorrent keeps changing it's output format, I cannot guarantee that CTorrentUI
will work with newer versions of CTorrent.
Therefore CTorrent v1.4.3 is included in this archive, but you should also
download the Aminet archive for it's documentation, requirements, credits, etc.
Requirements
============
* AWNPipe is supplied with Amiga OS 3.5+, or it can be downloaded from:
http://web.ukonline.co.uk/awnpipe
* CTorrent v1.4.3 is supplied with this archive, or the latest (possibly
incompatible) version can be found on the Aminet at path comm/tcp/CTorrent.lha
* IxEmul & IxNet v48.2 can be downloaded from:
http://sourceforge.net/project/showfiles.php?group_id=48010&package_id=90649
If you aren't sure which files to download, then try downloading this one:
http://kent.dl.sourceforge.net/sourceforge/amiga/ixemul-000n.lha
Rename ixemul000-notrap.library to ixemul.library and put it in Sys:Libs/
Rename ixnet000.library to ixnet.library and put it in Sys:Libs/
Installation
============
Extract the CTorrentUI archive where-ever you want, but please keep all the
files together. You may wish to put it into a folder called CTorrent.
Double-click on the RememberCTorrentLocation icon. It should report that the
path for CTorrent has been updated. If you ever move the folder containing
CTorrentUI, then you MUST run this program again, or CTorrentUI will not work.
Download CTorrent from the aminet - but do NOT use the program in that archive,
until you have tested CTorrentUI with the supplied version of the CTorrent
program. (Newer versions of CTorrent may be incompatible with CTorrentUI.)
Download any other required files (given above) which you do not have.
Usage - getting it started
==========================
CTorrentUI can either be run by double-clicking it's icon, or it can be run from
the Shell. Using the icon will cause it to ask some questions. Using the Shell
allows you to specify some extra commands, but if you don't give it the torrent
file then it will still ask some questions.
First it will ask you for the torrent file, if none has been supplied using the
"Torrent" Shell parameter.
It will then ask you "Does the torrent contain multiple files?". If you answer
incorrectly, then CTorrentUI may make CTorrent download incorrectly, because of
how CTorrent works. This corresponds to the "MultiFileTorrent/S" Shell
parameter.
It will then ask you "Force download filename to match torrent?". For a torrent
containing a single file, answering yes will cause the downloaded file's name to
match the torrent's name, rather than using the name specified in the torrent.
For a torrent containing multiple files, answering yes will cause the downloaded
files to be stored in the same folder as the torrent (rather than using any
sub-folders specified by the torrent). This corresponds to the
"FileMatchTorrentName/S" Shell parameter.
If you wish to keep seeding, after downloading has completed, then you must use
the Shell parameter "StayAsSeed/S".
If you wish to use a specific port (which you have allowed for in your
firewall), then you must either use the Shell parameter "Port/K/N", or edit the
CTorrentUI file using EditPad or similar. Near the top of the file you will see
this line:
.def Port 2706
You should change this number to the one you want.
If you specify the Shell parameter "NoQuitRequester/S", then it will not open
the special Quit window (see later).
Note that downloaded files will ALWAYS be put within the folder containing the
torrent, although they might be within some sub-folders.
Usage - after it's started
==========================
After a few seconds you should find that the CTorrentUI window appears, followed
by the Quit window. The CTorrentUI window tells you what is going on, and
should be fairly self-explanatory to anyone who has used a Torrent program
before.
The Quit window asks if you want to quit, before downloading has finished.
Answering Yes at any time will stop CTorrent from download, and close
CTorrentUI. Answering No will close the Quit window, preventing you from
quitting CTorrent.
Once CTorrent has finished downloading, the CTorrentUI window will close, BUT
the Quit window will remain open. Please click Yes or No to close it.
If CTorrentUI won't start downloading, because it says "Couldn't open specified
port", then you must either reboot, or restart your TCP/IP stack. This is
because of a bug in CTorrent, where it has previously failed to close the port,
so that it still appears to be in use by another program.
Bugs & the Future
=================
There are no known bugs, but I'm sure that someone will find one!
As already mentioned, CTorrent's output format keeps changing. This means that
CTorrentUI will be unlikely to work with versions other than v1.4.3. It might
be easy to adapt CTorrentUI to work with new versions, BUT:
I only have occasional need for CTorrentUI, and therefore may not be
(immediately) motivated to adapt it to work with newer versions of CTorrent.
So I will be happy to recieve emails about problems with CTorrentUI, but cannot
guarantee that I will actually do anything about them! Whether or not I do
depends on my personal situation at the time...
If I am not willing to (immediately) fix CTorrentUI, then I suggest that you
find someone with ARexx knowledge who WOULD be willing to fix it (perhaps you?).
I would be more than happy to release such a fix as an official part of
CTorrentUI, and give credit.
Contacting the author
=====================
My name is Chris Handley, although CTorrentUI is based upon the work of Michael
Trebilcock. You can get my email address from this page:
http://email.cshandley.co.uk
It is stored as a picture, to prevent spammers from harvesting it. Please be
careful to NOT write my address in a public place, or on a mailing list!
You could also try contacting me via http://amigaworld.net . My user name is
"ChrisH". I am *not* a rabid OS4 fanatic (!), and therefore would not mind
seeing CTorrentUI working on MorphOS, AROS, or whatever (if it doesn't already).
In fact, I don't actually own an OS4 machine yet...
History
=======
For CTGUI by Michael Trebilcock
v0.1 (20-Jun-2004)
Aminet release.
For CTorrentUI by Chris Handley
(29-May-2005)
Debugged & improved, but never released publically:
String concatenation was made fully legal Rexx, so it now works on my machine.
Actually deletes the temp file now!
Puts the downloaded file(s) in the same folder as the torrent.
Sends two Ctrl C signals, to ensure that CTorrent really quits (it's buggy).
v0.9 (23-Jan-2006)
Aminet release. Major improvements, including:
A clearer GUI with more info.
An AmigaDOS script (with icon) that provides a requester for closing CTorrent.
Seriously cleaned-up code, rewrote some sections so that I understand what they
do, and added many comments.
Reworked to handle CTorrent v1.4.3. (aaargh, why does the output format have
to KEEP changing?)
Added several parameters, to allow easier customisation of CTorrentUI's
behaviour.
v0.91 (01-Feb-2006)
Aminet release:
Improved documentation - the first release was rather rushed (sorry).
Now stores CTorrent's path in EnvArc, rather than hard-coding it into the
script! A simple program updates the path.
Cancelling the torrent file requester now works.
v0.92 (20-Mar-2006)
Aminet release:
Christian (CHRKUM) pointed-out a couple of silly mistakes which could have
caused problems for many people. Hopefully I get some feedback now...
|
aminet net>