JBinHex

JBinHex is both a library and a command-line tool to decode files in the Apple Macintosh BinHex 4.0 format.

Current version: 0.5

Version history

• 0.5 First released version

Limitations in this version

• This version does not support segmented files such as used on comp.binaries.mac.* newsgroups
• Documentation is limited
• Command line tool has does not check wether the command line parameters are completely correct

Possible future features

• Encoding of BinHex files
• File-based interface that allows to switch between data and resource fork at any moment, instead of the predetermined order that the stream-based interface dictates

Command-line tool

The class name of the command-line tool is org.gjt.convert.binhex.DeBinHex

It accepts the following command line parameters:

• Either -u <url> or -f <file> to specify the source BinHexed file. If neither of those options is present, DeBinHex reads stdin.
• -d to decode the data fork. It will be put in the file with the name that came from the BinHex header.
• -df <filename> to decode the data fork to the named file instead of the name that came from the BinHex header.
• -r to decode the resource fork. It will be put in the file with the name that came from the BinHex header, with the extension ".resource" appended to it.
• -rf <filename> to decode the resource fork to the named file instead of the name that came from the BinHex header.
• Both -d/-df options and -r/-rf may be present at the same time. If none of these options is present, DeBinHex will decode the data fork as if the -d options was specified.
• -h to only show the header of the BinHex file on stdout. The decoding options are ignored.

Javadoc

The Javadoc of the classes is included in the distribution and available online.

Download

Download the complete package including source, javadoc and jarfile with classes (36 Kb).

License

The package is licensed under the GNU General Public License, also known as the GPL license. See file COPYING for details.

References

• Article written by Yves Lempereur, available as Appendix A in rfc1741
• Article titled BinHex 4.0 Definition by Peter N Lewis

Copyright

All files in the package and on this site Copyright 2000 by Erwin Bolwidt, <ejb@klomp.org>

---

This page was last updated at april 8, 2000.