cutelog2
cutelog2 is a PyQt6/PySide6 fork of cutelog by Alexander Bus, a graphical log viewer for Python’s standard logging module. It’s unaffiliated with the original project; see the migration PR for what changed and why. It can be targeted with a SocketHandler with no additional setup (see Usage). cutelog2 is cross-platform, although it’s mainly written and optimized for Linux.
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 PyQt6 (or PySide6) from your package manager before installing cutelog2 (package name is probably python3-pyqt6 or python-pyqt6). Or just run pip install pyqt6 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
Requirements
Python 3.10 (or newer)
PyQt6 or PySide6
QtPy
Usage
Start cutelog2
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.
Metadata
Release files for cutelog2 1.0.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| cutelog2-1.0.0.tar.gz | 127.8 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| cutelog2-1.0.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 244.9 kB
Release files / cutelog2-1.0.0.tar.gz
| Download URL | cutelog2-1.0.0.tar.gz |
|---|---|
| Size | 127.8 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
7d1f1e2b3bcee899f8f18e9c8678fbff313127248f370582cca3db17aa217084
|
|
BLAKE2b-256 checksum How to use checksums |
b8aff7edca72d1721f02928dfab3e4b09ba022153f8161d15c26c011eccf0a08
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 1, 2026.
Transparency logRelease files / cutelog2-1.0.0-py3-none-any.whl
| Download URL | cutelog2-1.0.0-py3-none-any.whl |
|---|---|
| Size | 117.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
dd1564f11f1d20bb38c9c78c89d574f5aa5a2a5557393060a712cd4987217813
|
|
BLAKE2b-256 checksum How to use checksums |
1a76d1f5746dd7e69f67be2a58a98b554dcb1de6cc9bb24148460400bc2ba1b4
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 1, 2026.
Transparency log