JCharset - Java Charset package


Latest release:

JCharset 2.1 (151K - includes source code) - What's new?

Previous releases:

JCharset 2.0 (143K - includes source code)

JCharset 1.6 (82K - includes source code)

JCharset 1.5 (71K - includes source code)

JCharset 1.4 (70K - includes source code)

JCharset 1.3 (65K - includes source code)

What is the Java Charset package?

The Java Charset package is an open-source implementation of character sets that were missing from the standard Java platform.

It has been in use in many production systems around the world for over a decade, including products by small start-ups, large open-source service providers, and well-known multinational corporations.

How do I use the Java Charset package?

The Java Charset package is written in pure Java, runs on JDK 1.5 or later, and requires no special installation - just add the jar file to your classpath, or place it in any of the usual extension directories.

It is also available on Maven Central at the artifact coordinates net.freeutils:jcharset:2.1.

The JVM will recognize the supported character sets automatically, and they will be available anywhere character sets are used in the Java platform.

As an example, you can take a look at java.lang.String's constructor and getBytes() method, both of which have an overloaded version that receives a charset name as an argument.

A command-line utility is included which supports converting files between charsets. For help on usage and available options, run it using the command 'java -jar jcharset-2.1.jar -h'.

Note: Some web/mail containers run each application in its own JVM context. In this case check the container documentation for information on where and how to configure the classpath, such as in WEB-INF/lib, shared/lib, jre/lib/ext, etc. You may need to restart the server for changes to take effect. However, if you use Oracle's JRE, it will work only if you put it in the jre/lib/ext extension directory, or in the container's classpath. This is due to a bug in Oracle's JRE implementation (

Which charsets are supported?

What's New?

In version 2.1:

In version 2.0:

In version 1.6:

In version 1.5:

In version 1.4:

In version 1.3:

In version 1.2.1:

In version 1.2:

In version 1.1:

In version 1.0:


The JCharset Package is provided under the GNU General Public License agreement.
For non-GPL commercial licensing please contact the author. If you like it, why not give something back?



You can contact the author via e-mail at:

Please write in with any bugs, suggestions, fixes, contributions, or just to drop a good word and let me know you've found the JCharset Package useful and you'd like it to keep being maintained.

For updates and additional information, you can always visit the website at: