DimSum: Chinese Reading Assistant and Dictionary

Chinese Tools with Something for Everyone

Many people have requested versions of the tools on this website that can be run locally. DimSum is the answer to these requests. I'm currently integrating most of the tools on the website into one package: DimSum. Right now it supports adding pinyin to text files, Rich Text Format files, and web pages.

Please be aware that program is currently only at version and there's still a lot of improvement to be done. The program may run slowly and some characters may appear as boxes. If you have suggestions (or critiques) please visit the DimSum discussion board.

I have created a Mac install package for DimSum. Download the disk image file and copy the DimSum app to your Applications folder. This version should solve problems people have been having running DimSum on Snow Leopard.



If you haven't already installed Java on your system, you can get it from the Sun Java site. If given a choice, be sure to get the JRE version for all/multiple languages.

Important Note: Recent versions of the JRE installer require an additional step to get Chinese support. During installation select Custom installation and make sure "Support for Additional Languages" will be installed to the hard drive.

A quick solution for an existing installation would be to go to "Control Panel", then "Add or Remove Programs", select J2SE Runtime Environment 1.5, then click "Change". Then select "Modify" and then make sure "Support for Additional Languages" will be installed to the hard drive.

Also install Chinese support for your computer if you haven't already done so.

Automatic Install (Windows Only)

Download and run the DimSum setup program. It will create a entry for DimSum under "ChineseTools" on your Start menu.

If another program such as WinRAR or similar compression software comes up when you try to start DimSum, run the jarfix program from www.jonelo.de and then try running DimSum again.

Manual Install

To install the program yourself, download DimSum. On Windows, the easiest thing to do is save it to your desktop. Once the download finishes, there should be a new icon on your desktop called DimSum. You can double click on the icon to start the program.

Note that some browsers will save the DimSum.jar file as DimSum.zip. If this happens to you, just rename it back to DimSum.jar.


DimSum now runs on MacOS X. To install the program yourself, download this DimSum disk image to your desktop. Double click on it to open the new disk image which includes the DimSum application. Drag the DimSum application over to your Applications directory and delete the disk image. You can now double click on the DimSum icon to start the program.

You can also download the plain DimSum jar file and save it to your desktop. Then double-click it to start DimSum.

I now have a Mac mini, so each new DimSum release should have a Mac version.


I have successfully run DimSum on a Linux machine with Java 1.4 installed.

To install and use DimSum, download the DimSum JAR file. To use DimSum you will also need to have some Chinese TrueType fonts installed. To get Chinese fonts working, you can also copy a Chinese Unicode True Type font to the lib/fonts subdirectory where Java is installed.

The simplest way to run DimSum on Linux is go to a command prompt, cd to the directory with the JAR file, make sure java is in your path, and type "java -jar DimSum.jar".

Running the Program

See the (currently out-of-date) DimSum Help page.

Version History

Related Links