Skip to content

v0.7.0 - Real-time TUI Monitor (2025-12-27)

What Changed?

This release introduces a simplified real-time TUI monitor for OSECHI detector data. The monitor displays detector hit patterns, BME280 sensor readings, and event streams in a terminal user interface built with Textual. The implementation replaces the previous complex version with a cleaner, more maintainable design.

What's New

Main Feature: Real-time TUI Monitor

What it does: A terminal-based monitor that displays detector events in real-time, showing which detector layers (top, mid, bottom) were hit, along with BME280 environmental sensor data (temperature, humidity, pressure).

How to use it:

# Read from piped input
uv run kazunoko generate ... | uv run examples/monitor.py

# Watch a directory for new event files
uv run examples/monitor.py --watch /path/to/data/directory

Keyboard shortcuts:

  • q or Ctrl+C - Quit the application
  • r - Reset statistics
  • c - Clear screen
  • u - Manually refresh display

Display features:

  • Event Display: Detector hit visualization with BME280 sensor readings
  • Statistics: Total event count and current file name
  • Event Stream: Last 10 JSONL events received
  • Status Bar: Current mode and event count

Installation

Quick Start

# Get the release
git checkout v0.7.0

# Setup
task env:setup

# Run CLI
uv run kazunoko --help

What's Different from the Last Version?

✅ Added

  • Real-time TUI monitor (examples/monitor.py) with Textual framework
  • EventDisplayPanel showing detector hit patterns with colored indicators
  • BME280 sensor data display (temperature, humidity, pressure)
  • Uptime display in detector visualization
  • Manual refresh keybinding (u)
  • Comprehensive module and class docstrings

🔧 Changed

  • Renamed StdinMonitor to PipeMonitor for clarity
  • Renamed TestApp to DataMonitorApp
  • Simplified monitor architecture with cleaner separation of concerns
  • Removed test_textual.py after migration to monitor.py

Is It Safe to Upgrade?

Backward Compatible: Yes

  • This release adds a new example script; existing CLI commands and library APIs are unchanged
  • Users of the previous monitor.py will see improved functionality and cleaner code

Tests Passed

  • ✅ Builds without errors
  • ✅ Monitor runs in pipe mode
  • ✅ Monitor runs in directory watch mode
  • ✅ Keyboard shortcuts work correctly

Release Details

  • Date: 2025-12-27
  • Version: v0.7.0
  • Files Changed: 2 (examples/monitor.py, removed examples/test_textual.py)

Next Steps

  • Add more visualization options for detector data
  • Consider adding data export functionality from the TUI