Getting Started - adamgell/cmtraceopen GitHub Wiki

Getting Started

Download and Install

  1. Go to the Releases page
  2. Download the file for your platform:
    • Windows: .msi installer or standalone .exe
    • macOS: .dmg disk image
    • Linux: .deb package or .AppImage
  3. Run it

That's it. No Node.js, no Rust, no build tools — those are only needed if you want to build from source.

All Windows releases are code-signed. macOS releases are notarized by Apple.

Opening a Log File

There are several ways to open a log:

Drag and Drop

Drag any .log, .lo_, or .txt file onto the CMTrace Open window.

File Menu

Use File > Open File to browse for a single log file, or File > Open Folder to load all logs from a directory.

Source Presets

The toolbar includes presets for common log locations:

  • IME Logs — opens C:\ProgramData\Microsoft\IntuneManagementExtension\Logs\ directly

File Association (Windows)

On Windows, CMTrace Open can register as the default handler for .log and .lo_ files. When prompted on first launch, accept the association to double-click any log file and have it open in CMTrace Open.

You can also set it manually: right-click a .log file > Open with > Choose another app > browse to CMTrace Open.

Basic Navigation

Scrolling

The log view uses virtual scrolling for performance. Scroll normally — it handles 100K+ line files smoothly.

Severity Colors

  • Red — Error
  • Yellow — Warning
  • Default — Informational

Find (Ctrl+F)

Opens the search bar. Type a search term and press Enter or F3 to jump to the next match. Use Shift+F3 for previous match.

Filter

Filter the log view to show only entries matching specific criteria:

  • Message text
  • Component name
  • Thread ID
  • Timestamp range

Filters reduce the visible entries without modifying the file.

Info Pane

Click any log entry to see its full details in the info pane at the bottom of the window, including the complete message text, component, thread, and timestamp.

Next Steps