kchmviewer is a CHM (Winhelp) files viewer written on Qt/KDE. It can be build as a standalone Qt-based application, or a KDE application. The main point of kchmviewer is compatibility with non-English chm files, including most international charsets.
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
lib Added missing header for dup() on Linux Oct 5, 2016
nsis Installer now is built on Windows Oct 5, 2016
packages Added application/vnd.ms-htmlhelp and EPUB types Nov 3, 2015
po Added German translation by Marcus Muller Nov 3, 2015
src Minor fixes in build (mostly Qt4 32-bit removal from autobuild) Oct 5, 2016
templates - Changed copyright notice and email Nov 23, 2005
tests Fixed settings storage on Qt4/Qt5 Feb 22, 2015
CMakeLists.txt Now we keep the original CMake search path Jul 31, 2016
COPYING License changed to GPLv3 Oct 24, 2009
ChangeLog
DBUS-bindings Added D-BUS support for Qt and KDE builds, the application could now … Dec 2, 2008
FAQ - Fixed mistypes in README and FAQ (thanks Martin 'Cheese' Lee) Apr 24, 2010
FindLibchm.cmake Added KDE4 support. Jun 10, 2008
README Reformatted README Dec 28, 2015
build-release.sh Minor fixes in build (mostly Qt4 32-bit removal from autobuild) Oct 5, 2016
build-win32-mingw.sh Remove the build-in chmlib on Win32, we now support generic 0.40. Nov 4, 2015
build-windows.bat Added a new bat file to build on Windows Oct 5, 2016
kchmviewer.pro Fixed the missed dependency Nov 2, 2014
portable.txt Explanation how to create a portable app Oct 12, 2014

README

1. OVERVIEW

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. It has full KDE4 support.

The main advantage of KchmViewer is extended support for non-English languages. Unlike others, KchmViewer in most cases correctly detects chm file encoding, correctly shows tables of context of Russian, Korean, Chinese and Japanese help files. It also correctly searches text in non-English help files, including Korean, Chinese and Japanese. 

KchmViewer is written by Georgy Yunaev (gyunaev@ulduzsoft.com), and is licensed under GNU GPL license. Please do NOT use this email for bug reporting; see below.


2. FEATURES

- Standalone viewer, depends on Qt4 only. Does not require KDE, GNOME or wxWidgets toolkit.
- Could be optionally built with KDE4 support, using KHTML and KDE dialogs.
- 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. 
- Correctly detects and shows encoding of any valid chm file. 
- Correctly shows non-English chm files, including Cyrillic, Chinese, Japanese and others. 
- Correctly searches in non-English chm files using chm built-in search index. 
- Shows an appropriate image for every TOC entry. 
- Has complete chm index support, including multiple index entries, cross-links and parent/child entries in index. 
- Persistent bookmarks support. Allows to store bookmarks even if "Favorites" window was not enabled for this chm file. Also stores the screen position for every bookmark. You can also edit/delete bookmarks. 
- For any opened chm file, stores the last opened window, search history, bookmark history, font size and so on, so when you open this file again, everything is always on the place. 
- Has easy and powerful search-in-page support. 
- Allows to increase or decrease the font size, so physically handicapped people can read texts easily. 
- Has standard Back/Forward/Home navigation. 
- Can print the opened pages on a standard printer (usually via CUPS). 
- Has complex search query support. You can use search queries like "lazy people" +learn -not.


3. INSTALLATION

Usually kchmviewer is distributed in source code archive, so you need to compile it first. It requires Qt version 4.4 or higher. Note that you need to install qt4-devel and qt4-tools packages (the last one might be included in qt4-devel in your distribution), not just qt package.

Also make sure you have chmlib-devel (some distros have it as libchm-devel) package installed. KDE build will check for its presence, but qmake does not have necessary functionality to do so. If you are getting errors regarding missing chm_lib.h file this means chmlib-devel is not installed.


3.1. Qt-only version

To compile Qt-only version of kchmviewer, follow the procedure:

> tar zxf kchmviewer-<version>.tar.gz
> cd kchmviewer-<version>
> qmake
> make
  
The compiled binary is in bin/kchmviewer. You could copy it somewhere, or use it as-is. It does not require installation.

If QtWebKit module is not found, you will get the following error:

> kchmviewwindow_qtwebkit.h:25:21: error: QWebView: No such file or directory

then you need to install the QtWebKit module.

  
3.2 KDE4 version

To compile the version of kchmviewer with KDE4 support, follow the procedure:

> tar zxf kchmviewer-<version>.tar.gz
> mkdir build
> cd build
> cmake ..
> make
> sudo make install

For KDE version the installation is required, since the KHTML KIO slave cannot be used in place.


4. USAGE
 
Usage of kchmviewer is simple:

 kchmviewer mychmfile.chm

for the rest of command-line options, see kchmviewer --help


5. BUG REPORTING

Please use kchmviewer@ulduzsoft.com for bug reporting. 


6. THANKS

Thanks to:
- Jed Wing, the author of chmlib. This library is used by kchmviewer to access chm content.
- Razvan Cojocaru, the author of xchm. I used some ideas and chm processing code from xchm.
- Peter Volkov for various bug reports and improvement suggestions. 
- All the users, who report bugs, and suggest features. You help making kchmviewer better.

7. LICENSE

kchmviewer is distributed under GNU GPL license version 3.