# Chipmunk Log Analyzer & Viewer

A macOS desktop tool for inspecting log files and traces, collecting live logs, and searching or charting data.

> This is the Markdown version of the Chipmunk Log Analyzer & Viewer page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/chipmunk>

- **Latest version**: `4.3.0`
- **Developer**: esrlabs.com
- **Homepage**: <https://github.com/esrlabs/chipmunk/>
- **Categories**: [Developer Tools](https://opennavo.com/categories/developer-tools)
- **Install**: `brew install --cask chipmunk`
- **30-day installs**: 6
- **Homebrew**: Available; the app updates itself
- **Download URL**: <https://github.com/esrlabs/chipmunk/releases/download/4.3.0/chipmunk@4.3.0-darwin-arm64-portable.tgz>
- **SHA-256**: `b3323285d314574365e3803f1c22791c4e60c6ca911965bebe3ce13619d6a123`

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "app": [
        "chipmunk.app"
      ],
      "target": "/Applications/chipmunk.app"
    },
    "phase": "install",
    "sources": [
      "chipmunk.app"
    ],
    "target": "/Applications/chipmunk.app",
    "type": "app"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": [
            "~/.chipmunk",
            "~/Library/Application Support/Chipmunk"
          ]
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Chipmunk is a desktop log viewer and analysis tool for macOS. It can open log files and inspect automotive and network traces, including DLT and SomeIp. The Homebrew cask installs the `chipmunk.app` application.

- Collect logs from TCP, UDP, a serial port, or the output of a command or program; incoming output can be analyzed as it arrives.
- Create, save, and reuse filter sets. Search results update as new data is added, including data from live sources.
- Define regular expressions to capture metrics and display them in charts that update with incoming content.
- Inspect DLT traces, including traces within pcap or pcapng captures and embedded attachments. The application can display media and text from supported trace content or export them to disk.

Install with `brew install --cask chipmunk`, then open Chipmunk from your Applications folder. The cask installs a macOS application and declares a macOS dependency. The project describes handling files of any size, but actual use still depends on available disk space. This is a log-analysis application, not a command-line-only tool.

Sources: [Chipmunk project](https://github.com/esrlabs/chipmunk/) · [Project README](https://raw.githubusercontent.com/esrlabs/chipmunk/HEAD/README.md)

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 4.3.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/chipmunk.rb> · Checked 2026-11-22
  - <https://github.com/esrlabs/chipmunk/releases/download/4.3.0/chipmunk@4.3.0-darwin-portable.tgz>
  - SHA-256: `8f23bed186bf3e1da20241007374825dbe420cb2891d0d9da08ea267fdec3b16`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 4.3.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/chipmunk.rb> · Checked 2026-11-22
  - <https://github.com/esrlabs/chipmunk/releases/download/4.3.0/chipmunk@4.3.0-darwin-arm64-portable.tgz>
  - SHA-256: `b3323285d314574365e3803f1c22791c4e60c6ca911965bebe3ce13619d6a123`

## Chipmunk Log Analyzer & Viewer security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/esrlabs/chipmunk> · Open source: Yes — <https://github.com/esrlabs/chipmunk> · Checked 2026-11-13

## Uninstall

- `brew uninstall --cask chipmunk`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask chipmunk`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.chipmunk` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/chipmunk.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.
- Files and folders: `~/Library/Application Support/Chipmunk` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/chipmunk.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 4.4.0 (2026-09-29)

### 4.4.0 (29.09.2026)

**macOS: This release is currently unavailable as a signed macOS package due to issues with the notarisation process. Signing support is expected to be restored in a future release.** Version 4.3.0 remains available as a signed macOS release. Version 4.4.0 can still be built from source and used on macOS.

#### Features

- Added a "Select all" action for the active table's logs or search results, available from the context menu, the command palette, and the `Ctrl/Cmd+A` shortcut.
- Added a `--preset` option to the CLI (now at version 0.3.0), filtering output with a filter preset exported from the GUI so only matching records are written, for files, TCP, and UDP sources alike.

#### Changes

- Export in the search table now follows the same selection scope as copy, exporting only from the search results.
- Improved logs context menu and rendering performance.
- macOS builds are temporarily not signed or notarized.

#### Fixes

- Fixed chart range requests not respecting the cooldown after panning or zooming, causing extra requests to be sent.

#### 4.3.0 (18.09.2026)

##### Features

- Added a dedicated parser for UTF-16 text files (LE/BE, with or without BOM), detected automatically from the file's content.
- Text with other non-UTF-8 encodings is now converted to valid UTF-8 instead of causing hard errors during search.
- Added automatic persisting of the most recently used presets across sessions.
- Added pinning presets to persist them explicitly, regardless of usage limits.
- Added a setting to control how many unpinned presets are persisted automatically.
- Added recursive folder search to the "Select files from folder" commands and drag-and-drop, in both the menu and the command palette.
- Added standard zoom commands to the View menu and command palette.

##### Changes

- Improved text file parsing performance by up to 1.35x (measured on a 1.5 GB file).
- Improved parsing performance for DLT files with heavy attachment use by up to 1.18x.
- Preset actions are now grouped in a menu instead of separate buttons.
- Improved leftover session temp files cleanup using operating system lock-files.

##### Fixes

- Fixed data loss on lines longer than the internal read buffer from process and serial data sources.
- Fixed parsed items losing or splitting data at reader buffer boundaries when a data source stalls.
- Fixed CLI socket sessions repeatedly resending previously sent messages instead of only new ones.
- Fixed exports not writing all records when reading a session to the end.

#### 4.2.0 (18.08.2026)

##### Features

- Added "Find in Search Results" to find matches within the current search results, with the shortcut `Ctrl/Cmd+Shift+F`.
- Added a "Jump to Log" overlay to jump directly to a log line number, with the shortcut `Ctrl/Cmd+G`.
- Added copying selected rows to the clipboard, via context menu or `Ctrl/Cmd+Shift+C`.
- Added a copy action to the log details view.
- Added copy buttons to text and image attachment previews.
- Added copy commands to session tab context menus for file path, process command, and stream address.
- Added applying sidebar filters and chart values as a temporary search by double-clicking them.
- Added support for OS "Open with" calls on Windows and Linux, and passing file paths directly to the CLI.

##### Changes

- Temporary search now overrides persistent filters while the search is active.
- Improved manual selection for logs in logs and search tables.
- Transient notifications are shown for actions like copying, without adding entries to the notifications history.
- Attachments are now delivered to the UI in batches, reducing update overhead.
- Changed the Edit menu to a Session menu, enabled on session tabs only.
- Removed unused session APIs, events, and dependencies left over from the previous Electron-based version.
- Command palette now hides session-only commands on non-session tabs and includes the "Find in Search Results" and "Jump to Log" commands.
- Moved the filters shortcut to `Ctrl/Cmd+Shift+S`.

##### Fixes

- Fixed memory growth in long-running sessions caused by unused progress tracking messages piling up.
- Fixed jumping to the nearest row when search results and bookmarks are both present.

#### 4.1.0 (14.07.2026)

##### Features

- Added a SOME/IP statistics view to session setup, with summaries and counts by service/method ID and message type.
- Added file sorting to multi-file session setup.
- Added drag-and-drop file reordering to multi-file session setup.
- Added drag-and-drop reordering for filters and charts, including moving items between them.
- Added context-menu actions to remove all filters or charts at once.

##### Changes

- Improved application logging reliability.
- Limited notification banners to four lines.
- Changed overlapping filter highlights so the last matching filter determines the color.

##### Fixes

- Fixed Windows installer architecture and installation path issues.
- Fixed Windows release builds showing an extra console window.
- Added the missing Chipmunk executable icon on Windows.
- Fixed release archive naming for better compatibility with archive tools.

#### 4.0.1 (12.06.2026)

#### Changes:

- Improve graphics backend reliability on older devices and some Linux systems.
- Improve unsupported file detection and related notification messages.

#### 4.0.0 (10.06.2026)

**Chipmunk 4.0.0** is the first stable release of the new native version of Chipmunk.

This release replaces the previous Electron-based app with a much lighter and faster native application, reducing the **runtime footprint by more than 4x**.

##### Highlights

- Memory usage reduced from around **500 MB to less than 100 MB.**
- CPU usage for the same workload reduced from around **16% to around 4%.**
- Startup is now almost instant compared to about one second before.
- Chipmunk is now shipped as a single native application binary.
- No more Electron sandboxing or runtime issues.
- The app is much more responsive, with several long-standing UI issues fixed.
- Added a command palette for faster keyboard-driven workflows.
- Improved chart visuals.
- Added installers for all supported operating systems.

This rewrite also gives us a stronger base for future development, helping us deliver requested features and bug fixes faster in upcoming releases.

## Facts and sources

- <https://opennavo.com/apps/chipmunk>
- <https://opennavo.com/apps/chipmunk/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/c/chipmunk.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/chipmunk>
- <https://github.com/esrlabs/chipmunk> · Checked 2026-11-13
