How to open .CHM files on Windows
To open .CHM files on Windows, double-click the .CHM file to open it in the Windows HTML Help viewer (if associated).
Step-by-step instructions
- Double-click the .CHM file to open it in the Windows HTML Help viewer (if associated).
- If it doesn’t open, right-click the file → Open with → choose a CHM/HTML Help viewer available on your system.
- If the file is blocked or shows missing content, copy it to a local folder (e.g., Documents) and try again.
Recommended software
- VS Code
- Notepad++/TextEdit
- jq (CLI)
Alternative methods
- Open .CHM in a browser-based viewer if desktop apps fail.
- Try opening .CHM on Windows with a secondary app to rule out app-specific issues.
- Convert .CHM only with trusted tools when direct opening is not possible.
Common issues
The .CHM file won’t open (or opens in the wrong app)
File association may be missing or your device may not have a CHM/HTML Help viewer installed.
- On Windows/Linux, use “Open with” to select a CHM-capable viewer and set it as the default if desired.
- On macOS/mobile, use a CHM viewer app if available; otherwise open the file on Windows where support is most common.
Blank pages, missing navigation/search, or links don’t work
Some viewers have partial CHM feature support, so the TOC, index, or certain internal links/scripts may not behave the same as in the Windows HTML Help viewer.
- Try opening the same .CHM file in the Windows HTML Help viewer to confirm whether the file itself is OK.
- If you must use another platform, try a different CHM viewer there (feature support varies by application).
Windows shows a security warning or content is blocked
Windows can restrict CHM content (especially when downloaded) which may prevent scripts or some internal content from loading correctly.
- Move the .CHM to a local folder (not a network share) and try again.
- If you trust the source, use Windows file properties (where available) to unblock, then reopen.
File is corrupted or incomplete
Because CHM is a compiled container, a partial download or truncation can prevent it from opening or cause missing sections.
- Re-download or re-copy the file from the original source.
- Test the file on another machine/viewer to rule out a device-specific viewer problem.
Security note
CHM files can contain active HTML content; treat CHM files from untrusted sources as potentially risky and avoid opening unknown CHM attachments.