A professional serial terminal with dual ASCII/HEX view, real-time plotting, binary/frame decoding, data converter, and configurable macro buttons. Built with Python and PyQt5.

• Auto-detect serial ports with device name and VID:PID display
• Configurable baud rate (9600 to 921600), data bits, parity, stop bits, flow control
• Visual connection indicator (DB-9 connector icon: green = connected, red = disconnected)
• Live status bar with RX/TX throughput (bytes/sec), totals, and baud rate

• ASCII and HEX views side by side, updated in real-time
• Color-coded: red for received data, blue for sent data
• Resizable splitter between the plot and data views

• Three send modes: ASCII, HEX, BINARY
• Configurable line endings: None, LF, CR, CR+LF
• Command history with Up/Down arrow keys
• 8 macro buttons for quick-send (right-click to edit label and payload)

• 1 to 12 channels with auto-scaling Y-axis
• Configurable scrolling window (10 to 10,000 points)
• Crosshair cursor showing all channel values at the mouse position
• Right-click legend entries to rename channels or change colors
• Right-click plot area for axis settings (auto-range, manual Y-axis limits)
• Clear Plot button to reset all data
• Export plot as PNG image
• Export plot data as CSV with channel name headers

ASCII (default) -- Parses newline-delimited text values for plotting.

Supports labeled values (e.g., temp:23.5,hum:45.2).

Binary Stream -- Decodes continuous raw binary data.

Each sample is channels x sizeof(type) bytes. In this mode, the left panel shows color-coded decoded channel values.

Custom Frame -- Decodes framed binary packets.

Frame structure: [Start Byte(s)] [Optional Size Field] [Payload] [Optional Checksum]

• Real-time conversion between HEX, ASCII, Decimal, and Binary
• 12 conversion combinations
• Input/output with arrow indicator

• All settings saved automatically to AxxTerm_settings.json
• Includes: serial port config, decode mode, plot settings, channel names/colors, macros
• File > Save Settings / Load Settings for explicit save/load to custom files

• Python 3.8+
• PyQt5 >= 5.15
• pyqtgraph >= 0.13
• NumPy >= 1.24

git clone https://github.com/AxxAxx/AxxTerm.git
cd AxxTerm
pip install -r requirements.txt
python AxxTerm.py

No Python installation is needed on the target machine. Build a single portable executable with PyInstaller:

pip install pyinstaller
pyinstaller --onefile --windowed --name AxxTerm --clean AxxTerm.py

This creates dist/AxxTerm.exe. Copy it anywhere and run.

• The .exe resolves config files relative to the executable location, not the temp folder
• First launch creates AxxTerm_settings.json next to the executable when you change any setting
• File size is typically 30-50 MB (includes Python runtime and all dependencies)

AxxTerm_settings.json is auto-created and contains:

{
  "plot": {
    "mode": "ASCII",
    "num_channels": 4,
    "num_points": 100,
    "show_plot": false,
    "delimiter": "Auto",
    "channel_names": {},
    "channel_colors": {},
    "y_auto_scale": true,
    "binary": { "data_type": "float32", "endianness": "little" },
    "frame": { "sync_word": "AA", "size_field": "fixed", "frame_size": 12, "checksum": false }
  },
  "serial": {
    "baud_rate": "115200",
    "data_bits": 3,
    "parity": 0,
    "stop_bits": 0,
    "flow_control": 0
  },
  "macros": [
    { "label": "0x7F", "hex": "7F" }
  ]
}

MIT License. See LICENSE for details.