canpeek 0.3.0

A simple CAN bus monitoring tool, with dbc support.

CANpeek

CANpeek is a graphical CAN bus observer and analyzer for Linux and Windows (untested) based on Python and Qt.

🤖 About the Code (aka “AI Slop” Warning)

This project includes code — and this very README — that were generated almost entirely with large language models (LLMs). Yes, the term “AI slop” was insisted upon.

While the app works and provides a full-featured CAN bus GUI, you may find:

• Some awkward structure and bloated chunks of logic
• Repetitive patterns that could use refactoring
• Giant all-in-one files (yes, main.py, we’re looking at you)
• Documentation (including this README) was AI-generated too — so if it sounds polished but slightly overconfident, that’s why.

The goal was rapid prototyping, not pristine architecture. Use it, improve it, rewrite parts of it — all contributions are welcome.

Features

• 🧩 Project-based configuration with filters, DBC files, and persistent decoding options
• 🌐 Multi-interface support: socketcan, pcan, kvaser, vector, and virtual based on python-can
• 📊 Dual View: Real-time Trace View and hierarchical Grouped View with signal expansion
• 📁 Multi-DBC support with signal decoding from cantools
• 🧠 CANopen basic decoder with support for NMT, PDO, SDO, Heartbeat, and more
• 📦 CAN frame transmitter, supporting both raw and signal-based (DBC) messages
• 📜 Log support: Save/load CAN logs in all python-can IO formats

Screenshots

Installation

With pip

pip install canpeek
canpeek

From source

1. Install uv
2. Run uv run canpeek

Usage

1. Connect to a CAN interface:

   • Select backend (socketcan, pcan, kvaser, etc.)
   • Enter the channel (e.g., can0)
   • Click Connect

2. Load DBC files via the "Project Explorer" to decode signals.

3. Create Filters to limit visible traffic.

4. Send CAN messages:

   • Manually from the Transmit tab
   • If the message id is in the DBC, a dedicated panel is available to edit signals values

5. Save / Load CAN logs in simple .log format.

Log Format

# CAN Bus Log File
# Format: timestamp id is_ext dlc data
0.000123 1AB S 8 DE AD BE EF 00 01 02 03

Other tools

CANPeek is designed to be quick & simple, you might find those intersesting:

• cangaroo : rather similar
• SavvyCAN : a much more complete canbus tool