NoAds FileUnpacker 0.1.1 Help

About this program
This is NoAds FileUnpacker 0.1.0. It lets you unpack files packed with TM FilePacker without installing Agava TM Agent or any other unwanted software on your system.

It is free/open source software distributed under a modified BSD License. You may download the source code from the program's website if you have not received it.

Author: Fedor Uvarov.
Website: http://noadsunpacker.sourceforge.net

This program also contains software distributed by L2FProd.com under Apache License 2.0. You may find more about this software in the NOTICE file in the program's distribution. If you received this program as a JAR file, unpack it as a ZIP file and the NOTICE file will be there.

I'm quite sorry that the code is... well... not really clean. This is because I don't have much time to work on it now and I was afraid that if it had not been released soon, it would have never been. I'll refactor it as soon as possible.

License to use the program
Copyright 2010 Fedor Uvarov. All rights reserved.

Redistribution and use in source and binary forms, with or without modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice, this list of conditions and the following disclaimer in the documentation and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY FEDOR UVAROV ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL FEDOR UVAROV OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Supported formats
Version 0.1.0 of NoAds FileUnpacker supports .tmfp archives and self-extracting .tmfp archives created with TM FilePacker. The most recent version of TM FilePacker at the time was 2.1.7.216.

Very important section
As stated above in the license, you are using this program at your own risk. TM FilePacker archive format is secret and proprietary, so it's possible that the archives may be unpacked incorrectly.

These are things that have not been done yet:

It is you who must make sure that all legal obligations to unpack an archive are fulfilled and that you have all neccessary permissions. We cannot check whether or not the archive has to be paid for before unpacking.
TMFP format has not yet been fully deciphered,, although I have not yet come across an archive that could not be unpacked with NoAds FileUnpacker.
We cannot verify checksums for uncompressed TMFP archives (TMFP archives that were created without turning the option "Use compression" on. You will get a warning when you unpack such an archive. If it contains another archive (like RAR or ZIP or 7z), a software installer or another data which provides its own means of checking integrity, don't worry. Otherwise consider checking the integrity somehow to make sure the archive is not corrupt. But the size of uncompressed files is always checked.
If your archive is corrupt, you may get generic error messages. See "Troubleshooting" section for details.
File attributes are not preserved. But this is in most cases not a problem, since the contents are always fully unpacked. We already know where they are stored and will implement their support in next versions.
.SPT archives are not supported yet. We will work on it ASAP.

And the most important thing: if your archive is not unpacked correctly, it may well be a problem with NoAds, not of the archive. Please try unpacking it with TM FilePacker or, if it is it a self-extracting archive, running it (don't forget to take the neccessary precautions). If it unpacks correctly, please contact us (see "Troubleshooting"). If it doesn't, well, then it's corrupt.

How to use the program
Well, using the graphical interface is quite easy. Just choose the file you want to unpack, choose the directory you want to unpack it to and it will be unpacked there. If any files in the target directory have the same names as files in the archive, they will be overwritten without prompt.

To unpack a multipart archive, select the first part (usually with extension .tmfp or .exe) as the file to unpack. Other parts will be found automatically. Please note that they must be in the same directory as the first part, choosing other parts manually is not supported yet.

If the file is not unpacked or you get an error, see "Troubleshooting".

You can also use NoAds FileUnpacker from the command line. To get help on options, run it with argument "--help". E.g.:

noadsunpacker --help

or

java -jar noadsunpacker.jar --help

Troubleshooting
If you see an error screen which says "An error occured! More details below", this can be due to the following reasons:

Your archive is corrupt. You will most likely get a ZipException in this case. Unfortunately, NoAds FileUnpacker still cannot distinguish between its own errors and problems with the archive.
An I/O error happened (for example, the file is no longer accessible, not enough free space to write the output, network drive disconnected, hard drive failure etc. You will get an IOException here. But IOException may also happen due to a bug.
You are running out of memory or other resources. In this case you'll get an OutOfMemoryException or something like this.
TM FilePacker developers have created a new format that is not recognised by this version of NoAds. To verify it, try downloading TM FilePacker or, if it is a self-extracting file, running it (you may want to use a virtual machine to avoid installing unwanted software on your system) and unpack the archive "normally". If it unpacks correctly, well, this is the new archive format. In this case please go to our website, find the "Report a bug" section and send this archive to us.
It's a bug. If you think it's a bug report it to us through our website.

If the program just suddenly quits, it's always a bug (unless it is a problem with your Java Virtual Machine). Please report it.