Features

• Allows any number of simultaneous connections

• Customizable look of log levels and columns, with presets for each

• Filtering based on level and namespace, as well as filtering by searching

• Search through all records or only through filtered ones

• Display extra fields under the message with Extra mode

• View exception tracebacks or messages in a separate window

• Dark theme (with its own set of colors for levels)

• Pop tabs out of the window, merge records of multiple tabs into one

• Save/load records to/from a file in JSON format

Installation

If you’re using Linux, install PySide6 (or PyQt6) from your package manager before installing cutelog2 (package name is probably python3-pyside6 or python-pyside6). Or just run pip install pyside6 to install it from pip, which is sub-optimal.

$ pip install --upgrade cutelog2

Or install the latest development version from the source:

$ pip install git+https://github.com/eachimei/cutelog2.git

$ pip install cutelog2[pyqt6]

$ QT_API=pyqt6 cutelog2

Usage

1. Start cutelog2

2. Put the following into your code:

import logging
from logging.handlers import SocketHandler

log = logging.getLogger('Root logger')
log.setLevel(1)  # to send all messages to cutelog
socket_handler = SocketHandler('127.0.0.1', 19996)  # default listening address
log.addHandler(socket_handler)
log.info('Hello world!')

Afterwards it’s recommended to designate different loggers for different parts of your program with log_2 = log.getChild(“Child logger”). This will create “log namespaces” which allow you to filter out messages from various subsystems of your program.

Code, issues, changelog

Visit the project’s GitHub page.