Files
StreamLens/COLUMN_LAYOUT_EXAMPLE.md
noisedestroyers 5c2cb1a4ed Modern TUI with Enhanced Protocol Hierarchy Interface
Major Features:
- Complete modern TUI interface with three focused views
- Enhanced multi-column layout: Source | Proto | Destination | Extended | Frame Type | Metrics
- Simplified navigation with 1/2/3 hotkeys instead of F1/F2/F3
- Protocol hierarchy: Transport (TCP/UDP) → Extended (CH10/PTP) → Frame Types
- Classic TUI preserved with --classic flag

Views Implemented:
1. Flow Analysis View: Enhanced multi-column flow overview with protocol detection
2. Packet Decoder View: Three-panel deep inspection (Flows | Frames | Fields)
3. Statistical Analysis View: Four analysis modes with timing and quality metrics

Technical Improvements:
- Left-aligned text columns with IP:port precision
- Transport protocol separation from extended protocols
- Frame type identification (CH10-Data, TMATS, PTP Sync)
- Cross-view communication with persistent flow selection
- Context-sensitive help and status bars
- Comprehensive error handling with console fallback
2025-07-26 22:46:49 -04:00

2.0 KiB

Modern TUI Column Layout Example

Flow Analysis View (View 1)

The new column layout separates transport and extended protocols for clearer flow analysis:

 #  Source             Proto  Destination        Extended   Frame Type   Pkts  Volume  Timing   Quality
 1  192.168.4.89:1024  UDP    239.1.2.10:8080   CH10       CH10-Data    1452    1.9MB   77.8ms      95%
 2  11.59.19.204:319   UDP    224.0.1.129:319   PTP        PTP Sync      297   26.8KB  378.4ms    Normal
 3  11.59.19.202:4001  UDP    239.0.1.133:4001  -          UDP           113   17.4KB  999.4ms    Normal
 4  192.168.43.111:68  UDP    255.255.255.255:67 -         UDP            46    3.8KB    2.3s     Normal
 5  11.59.19.204:80    OTHER  224.0.0.22:80     -          IGMP            6     360B   13.9s     Normal

Key Improvements

  1. Transport Protocol Clarity: Proto column shows TCP, UDP, ICMP, IGMP, OTHER
  2. Extended Protocol Support: Separate column for specialized protocols (CH10, PTP, IENA, NTP)
  3. Frame Type Detail: Shows the most common frame type for detailed analysis
  4. Distinct Source/Destination: Clear separation with IP:port format
  5. Left-Aligned Text: Source, destination, and protocol columns for better readability
  6. Comprehensive Flow Info: Transport → Extended → Frame type hierarchy

Column Widths

  • Source: 20 characters (left-aligned) - IP:port format
  • Proto: 6 characters (left-aligned) - Transport protocol (UDP, TCP, etc.)
  • Destination: 20 characters (left-aligned) - IP:port format
  • Extended: 10 characters (left-aligned) - Specialized protocol (CH10, PTP, etc.)
  • Frame Type: 12 characters (left-aligned) - Most common frame type
  • Pkts: 6 characters (right-aligned) - Packet count
  • Volume: 8 characters (right-aligned) - Data volume with units
  • Timing: 8 characters (right-aligned) - Average inter-arrival time
  • Quality: 8 characters (right-aligned) - Quality percentage or status

This layout provides clear protocol hierarchy from transport layer through specialized protocols to specific frame types.