Skip to main content

Viewing CHM files in Linux (With installation instructions for Ubuntu )

CHM or Microsoft compiled HTML Help is a format developed by Microsoft for online help . Most of the documentation in Windows platform is in chm file format , also these days most of the ebooks available on the internet are either available in the chm file format or pdf file format .

Now most of the distributions do not ship tools and libraries for viewing chm files by default since it is a proprietary format used by Microsoft Products , So if you want to read a ebooks which are in chm file format you have to install third party tools and libraries . In this short tutorial i try to describe how to install some of the tools for viewing CHM files on your Ubuntu desktop :

1. Gnochm

Gnochm is a gnome based chm viewer that has the following features : -

* Support for external ms-its links
* Full text search support
* Bookmarks
* Configurable support for HTTP links
* Integrated with GNOME2
* Support for multiple languages
* Support to open multiple files at once

To install gnochm issue the following command in the terminal window (assuming you have your repositories in order , if not read this article and set your repositories right )

sudo apt-get install gnochm

After installation gnochm should be installed properly , which you can even launch by typing in "gnochm" in the terminal window .


2. kchmviewer
If you are one of those who likes using KDE desktop environment you might like using a tool that uses KDE library instead of gnome one , and integrates better with KDE desktop .

A nice chm viewer for KDE desktop is kchm viewer :

Here is a text about kchmviewer taken from it's package file :

KchmViewer is a chm (MS HTML help file format) viewer, written in C++.
Unlike most existing CHM viewers for Unix, it uses Trolltech Qt widget
library, and does not depend on KDE or Gnome. However, it may be compiled
with full KDE support, including KDE widgets and KIO/KHTML.

The main advantage of KchmViewer is non-English language support. Unlike
others, KchmViewer in most cases correctly detects help file encoding,
correctly shows tables of context of Russian, Korean, Chinese and Japanese
help files, and correctly searches in non-English help files (search for
MBCS languages - ja/ko/ch is still in progress).

Completely safe and harmless. Does not support JavaScript in any way,
optionally warns you before opening an external web page, or switching to
another help file. Shows an appropriate image for every TOC entry.

KchmViewer Has complete chm index support, including multiple index entries,
cross-links and parent/child entries in index as well as Persistent bookmarks
support. Correctly detects and shows encoding of any valid chm file.

to install kchmviewer type in the following command in the terminal window :

sudo apt-get install kchmviewer

and after above step is completed you can launch kchmviewer by typing in kchmviewer in the terminal window

kchmviewer displaying a chm file
3. xCHM

XCHM is a chm file viewer , that is not bound to any desktop environment and could be used even in window manager like fvwm or xfce .

Here is text taken about xCHM from it's package file :

"xCHM is a viewer for Compiled HTML Help (CHM) files. It, can show the contents
tree if one is available, print the current page and do the usual history
stunts. It allows you to change fonts and search for text in all the pages of
the file, or in the pages' titles."

xCHM does not support JavaScript in books."
to install xchm issue the following command in the terminal window :

sudo apt-get install xchm

and then you can launch xchm by typing in xchm in the terminal window .

xCHM in action

4. Mozilla Firefox add-on to display chm files

Mozilla Firefox is a powerful platform and it can be extended to do a number of cool things by installing different plug ins and one really useful addon is a CHM viewer .

To install CHM reader addon go to the following site and click on install button , procedure after that is quite self explanatory owing to extremely easy interface of Mozilla Firefox .

After clicking install button you will find a dialog box like this just click the "Install Now" button in this dialog box

After installing you can easily open chm files from Mozilla Firefox , In the File submenu you will find a option of opening chm files .
File Menu in Firefox showing new option to open CHM file

Firefox rendering a CHM file

5. Okular

if you happen to install kde4 on your desktop , Okular is the new addition to the KDE desktop environment . Okular besides having ability to render pdf , djvu files can also display chm files flawlessly . Besides being based on solid KDE 4 libraries Okular allows one to add notes , highlight text etc . It is one of the most advanced document reader available on linux . To install KDE 4 with Okular read this article about how to install KDE 4 on Ubuntu i had written few weeks back .

Okular in Action :)

Article Written by : Ambuj Varshney (
(C) 2008 , For Linux On Desktop Blog (


  1. Rahul Kulshreshtha11:29 AM

    sudo apt-get install gnochm
    worked on my ubuntu 7.04 fiesty fawn

    Now I can read .chm files. Thank you. One more good thing is also there that "commenting here does not need to create an account" Thanks for this also. Keep every thing as simple as possible

  2. Anonymous8:28 PM

    I apologize in advance if my question sounds "a bit" dumb, but I am new to this.
    I tried to install the kchmviewer and it gave me an error message: "sudo: apt-get: command not found". What should I do?
    Thanks in advance. Saul

  3. Anonymous5:48 AM

    i got the same problem, just to try it i also tried it under "su" that didnt work either a simple get command didnt work either

  4. Anonymous1:13 AM

    With Ubuntu Mint7 Gloria -> Mintinstall -> Gnochm. Perfect!

  5. Anonymous5:41 AM

    I tried chmsee in Ubuntu 10.04. It seem to be a much better choice than xchm. chmsee has got fullscreen mode and zoom. A promising alternative to chmsee.


Post a Comment

Popular posts from this blog

13 Things to do immediately after installing Ubuntu

In this article i describe some of the things to do immediately after installing ubuntu on your machine . Since most of the people reading this would be shifting from Windows to Linux with a system dual booting so i would focus more on making transition easy from Windows to Linux.

Creating Your ultimate Ubuntu 7.10 Desktop

Ubuntu 7.10 Codenamed Gusty Gibbon was released few weeks back with much fanfare ,now Ubuntu for past couple of years has been one of the most popular Desktop Linux distributions . Ubuntu 7.10 includes a number of features , applets and Wizards to simplify desktop Linux experience however because of many licensing restrictions it does not include out of the box support for popular audio/video codecs and many commercial but good applications . Also because of the limitation of trying to accommodate all kind of applications on single CD Ubuntu comes with a limited set of applications .

Now , i often have arguments with my friends who are new to computers that windows is…

Over 16 Small Games For Ubuntu Linux

Over 16 Small Games For Ubuntu Linux

Ubuntu Linux is one of the most popular Linux distribution , it is especially popular among Linux newbies and windows refuges . Now Ubuntu Linux does come with a descent set of applications , still there is a scope for including some more quality applications and especially games . Now in this tutorial i will show you how to install a large number of small , easy and less resource hungry games on Ubuntu Linux with screen-shots of games .

1. Rocks 'n' Diamonds

Rocks 'n' Diamonds is a Boulderd*sh game for X11 with more than just the falling rocks and diamonds of its namesake. The object is still to collect all the diamonds (and emeralds), then get to the exit before time runs out. But your character must make use of bombs, spaceships, and many other elements in order to fill his quota of jewels.

Installation : -

Type the following command in the terminal window


Making Music(Beats) on Linux/Ubuntu with Hydrogen

I am going to review a couple of Music Making Softwares for Linux and am starting with the simplest and one of the best!HYDROGEN. Hydrogen basically is a pattern based drum programming software which in layman terms means, it allows you to make your own beats.And in case you aren't much into music, you might be wondering “what the hell will i do with this piece of software”...well here is a word from my friends who've tried this: “Its pretty fun playing with this software, n even without knowing much, you could actually MAKE SUM MUSIC!!!”

There was this software called Acoustica Beatcraft(for windows) which actually introduced me to this beat making stuff and I was quite interested, but sadly it was too costly for me to buy it. So i was stuck using the trial version of the software and sadly as soon as i got the grip of the software the trial expired, and so my search began for software which would do the stuff for me and luckily i found this amazing piece of software HY…