Grappler!

Grappler!

Grappler! is a tool to help with fetching files via bittorrent and newsgroups. Here are a list of features.

Retreive .torrent and .nzb files from emails.
Transfer .torrent and .nzb files to specific folders for your apps to catch.
Watch a specific folder for new .par2 files. When found, Grappler will attempt to verify the files, fix if needed and then extract those files.
Very customizable.

Downloads:

Grappler! connects to your specified email server, with a special account setup for Grappler!
Grappler! downloads any emails it finds and looks for .torrent and .nzb attachments.
Grappler! extracts all .nzb files to a specified nzb directory.
Your news program, such as NewsLeecher, grabs that .nzb file and starts downloading the files it lists.
Grappler! waits for any new par2 files to be placed in the specified watch folder.
Grappler! sees a new par2 file, one downloaded with the latest .nzb file, and starts to verify it.
Grappler! sees that some reparing to the file set is needed so runs par2 to repair the set.
Grappler! unpacks all new file sets that are fully repaired to a specified output folder.
Grappler! deletes the archives and par2 files for any file sets that it successfully unpacked.
Grappler! waits for a specified amount of time and then starts over with #1.

How to use:

Step 1 : Grappler! is a java application that is run via Java. If you don't have Java installed, you can get it here.
Step 2 : UnPack Grappler! to a folder of your choice.
Step 3 : Run Grappler! by double-clicking Grappler!.bat

Options :
-nomail Tells Grappler! to not check for mail.
-gui Shows the UI for configuration.
-debug Put's Grappler! in debug mode. This will spit out a bunch of log messages which can be usefull if a problem arrises.

How to install Grappler! as a service:

Removed - Add a shortcut to your Start menu if you wish to have Grappler! start at startup.

How to uninstall Grappler! as a service

Step 1 : Run UnnstallGrappler!.bat.

FAQ:

How do you setup an Environment Variable in Windows?

Right-Click 'My Computer'
CLick the 'Advanced Tab'
Click the 'Environmental Variables' button
Click the 'New' button under System Variables
Enter the name and full path for the variable
Click 'Ok', 'Ok' and 'Ok'
If you have any command-line windows open, close those and open new ones.

Release History:

v0.47b - March 9, 2007
Fixed: There was a problem running setup in version 0.46.
v0.46b - Feb 19, 2007
Fixed: Problem with email attachment paths.
v0.45b - April 8, 2006
Fixed: Problem with upgrade only download.
Fixed: Problem with email attachments.

v0.44b - April 6, 2006
Updated: Downloading of new version. For some reason, a CR is now added to the url. Possibly because of an update
that Comcast, my isp, did. This new version strips this off if it's there. I tested it and it works, but it means
that you have to download this verison by hand. Sorry for the inconvenience.
v0.43b - April 6, 2006
Added: Support for mixed file sets which contain both archives and non-archive files.

v0.42b - Jan 12, 2006
Fixed: Bug with eMail's that had no content in the body.
Updated: Grappler! now fully processes 1 file set at a time.
Updated: Putting Grappler! to sleep when it's running Par2 or RAR will now kill the both processes if you are
running on Windows 2003 or XP.
Added: Delete Unknown Attachments option.
Added: You can now set the folder you wish unknown attachments to go if you don't wish them to be deleted.
Added: Grappler! now allows for multiple Watch Folders.
Added: Sub-Directory names will be saved and used when extracting. Example:
Watch Folder: c:/downloads/games/archive.rar
Extract Folder: c:/newstuff/
Results: c:/newstuff/games/archive

v0.41b - Nov 26, 2005
Fixed: Major bug with extracting archives. Thanks to Vidar and Andre for finding this so quickly.
Fixed: Downloading of new versions always downloaded version 0.48b.
Added: Small check for bad email addresses. Small hole that people use to send viruses.

v0.40b - Nov 23, 2005
Fixed: Version checking was pretty bad, sorry about this.
Fixed: Copying non-archive files to their own directory. Stupid coder mistake. Thanks to Patrick for catching this one.
Added: Log now states how many blocks are needed to repair an archive.
Added: Added a 'Status' option to the System Tray Icon which displays how many blocks are needed to repair an archive in a dialog window.

v0.39b - Nov 21, 2005
Fixed: When no archives are found and the option 'Extract Using Archive Name' is true, extract all archives to a directory based on the par name.
Fixed: If par2 fails because of a bad path it will say so instead of saying the file needs more pars.
Added: Setup and Open Log options to System Tray Icon.
Added: Tooltips to the System Tray Icon.
Added: Sleep/Wake Up commands to the System Tray Icon.
Added: Notification for new versions of Grappler!

v0.38b - Nov 15th, 2005
Fixed: Repaired archive volumes were not getting deleted.
Fixed: Archives which have .1 added to the suffix were not getting deleted.
Update: If no RAR files are found in a parity fileset, the files are moved to the extraction directory.
Update: Some changes to speed up things.

v0.37b - Nov 11th, 2005 - Fixed a bug which prevented the ability to check mail through GMail, the Google Mail service. Fixed a bug with the sub-directory searching/verifying/etc.. Some other minor fixes and changes. Also added -DEBUG which spits out a ton of log messages to help debug future problems if they arrise. Special thanks to Rino for helping to do some debugging this week.
v0.36b - Oct 19th, 2005 - Added a System Tray Icon which you can quit from. Modified the batch file so it doesn't leave a window open. You can now just add a shortcut to the batch file into the Start menu to start Grappler! at startup.
!Warning! This version has not been tested yet. I'm going out of town for the weekend and thought I'd drop it now. !Warning!
!Warning! You MUST uninstall Grappler first if you have it installed as a Service. The batch file has changed so please modify it to reflect your system !Warning!
v0.35b - Oct 14th, 2005 - Added subfolder search.
v0.34b - Oct 12th, 2005 - Added support for RAR's that start with .001 instead of .rar. Forgot about this type. Also fixed a bug that occurs if verifying, repairing and extracting takes longer than the watch folder delay.
v0.33b - Oct 9th, 2005 - Added support for files with spaces in the names. If you select to delete archives, Grappler! will also now delete junk files like nfo's and sfv's. Added better support for archive names.
v0.32b - Oct 6th, 2005 - Bug fix introduced with last build.
v0.31b - Oct 6th, 2005 - Bug Fixes. Archives and Repair Volume names are now gathered from the results of PAR2. This fixes a problem with odd archive names.
v0.30b - Oct 4th, 2005 - Added a UI for configuration and support for POP3 over SSL, such as with GMail.
v0.24b - Oct 2nd, 2005 - Added support for both Old and New style naming schemes for RAR's.
v0.23b - Oct 1st, 2005 - Fixed a bug with the watch command dying after finding no pars.
v0.22b - Sept 30th, 2005 - Added the -nomail option.
v0.21b - Sept 30th, 2005 - Put in a message and removed the exception that was thrown if you hadn't changed the mail settings.
v0.20b - Releases on Sept, 27th 2005 - This is the first release of Grappler!

For help, suggestions or complaints, please email me at shay@highstyleweb.com.

If you see an exception or wish to report a bug, please send your log file. Remember to first rerun Grappler! with the -debug option.