xdelta UI Version 1.1 KaioShin 31.05.09 Introduction ------------ xdelta is a binary patching program written by Josh McDonald, implementing the VCDIFF delta compression standard. This little front-end was written in order to make xdelta more foolproof to use for users who dislike to or don't know how to use the command-line. This front-end was primarily written to be used by the romhacking community to apply translations and other hacks to ROMs or other binary files. xdelta itself can be used for tons of applications of course and so should be this front-end. I did only test it with romhacking related tasks though. Requirements ------------ The program was written in C#, and therefore needs the .NET framework to function. Google for it if you don't have it already. To be more specific it was compiled with the .NET 2.0 framework. Why xdelta? ----------- The romhacking community has been struggling with the need for a suitable next-generation patching format for years now. One of the possible alternatives for a widely accepted standard is xdelta. It has many unique features that make it superior to formats like PPF or UPS. Reasons to use xdelta: - No filesize limitations - Efficient handling of rebuilt filesystems and relocated data structures (This causes MASSIVE patch sizes on formats such as IPS or UPS) - Protection against patching the wrong files xdelta is currently the only patching standard that can handle rebuilt filesystems! How to Use ---------- The GUI should be pretty self-explanatory. If xdelta throws an error it'll be displayed to you. Refer to the xdelta documentation at http://xdelta.org/ for possible solutions in case the error message isn't making sense to you. The most likely cause in the event of an error is that you picked a wrong file. Note that you have to patch the same file with which the patch creator created his patch from. Refer to the patch documentation to find out what file that is. The distribution package comes bundled with xdelta version 3.0u (Windows 32bit). If there is a new release of xdelta just replace xdelta.exe with a binary of the new version and it should be fine. Note for Vista users: When you first use the front-end Vista will throw a warning asking you to confirm that the front-end may launch xdelta. This is a protection so that no harmful programs can call malware behind your back. You can safely accept the message and tell Vista not to bother you again about it in the future. You can associate patch files with the front-end. That way they'll be automatically opened by double clicking on patches. I recommend to associate *.xdelta files with the application and save all your patches as *.xdelta files. To do this, just double click on a xdelta file and tell windows to make xdeltaUI the default to open the file. Acknowledgement and Contact --------------------------- Don't forget that xdelta itself was written by Josh McDonald. I (KaioShin) just wrote a GUI to make it easier to use. All credits for the program should go to the original author. I didn't ask for explicit permission to bundle a binary of xdelta with this front-end, I assume it falls under fair-use. I'm not making any money of this program and I don't take any kind of donations for it. If anyone who is directly involved with xdelta has a problem with this please contact me and I'll distribute the front-end seperately. If you find an error in the GUI (and not in xdelta itself!) you can contact me about it and I'll try and fix it. You can reach me through a private message on the message board on www.romhacking.net. Changelog --------- 19.02.09 Initial Release 31.05.09 v1.1 - Patch files can now be associated to the patcher so they'll be automatically selected at startup. Thanks to Dragonsbrethren for the suggestion.