chotko

Chotko

A terminal UI for Zabbix 7.x built with Go and BubbleTea.

The name comes from the Russian slang word "чётко" (chotko), meaning "precise" or "on point" - fitting for a monitoring tool.

Features

• View active Zabbix alerts with severity-based color coding
• Acknowledge problems directly from the terminal
• Host status overview (OK, Problem, Unknown, Maintenance)
• Edit host triggers (enable/disable) and macros directly from TUI
• Events history view with problem/recovery tracking
• Graphs tab with time series charts for numeric metrics
• Multiple built-in themes (Nord, Dracula, Gruvbox, Catppuccin, Tokyo Night, Solarized)
• Custom theme support via YAML
• Vim-style keyboard navigation
• Mouse support (click tabs, select items, scroll wheel)
• Filter alerts by severity or text
• Auto-refresh with configurable interval

Installation

go install github.com/harpchad/chotko/cmd/chotko@latest

Or build from source:

git clone https://github.com/harpchad/chotko.git
cd chotko
go build -o chotko ./cmd/chotko

Usage

# Run with interactive setup wizard (first run)
chotko

# Connect with API token (recommended)
chotko -s https://zabbix.example.com -t YOUR_API_TOKEN

# Connect with username/password
chotko -s https://zabbix.example.com -u Admin -p password

# Use a specific theme
chotko --theme dracula

# Show only high severity alerts
chotko --min-severity 4

Configuration

Environment Variables (Recommended)

For security, credentials should be provided via environment variables rather than CLI flags or config files:

# Recommended: Use environment variables
export CHOTKO_TOKEN=your-api-token
chotko -s https://zabbix.example.com

# Or inline for one-time use
CHOTKO_TOKEN=your-api-token chotko -s https://zabbix.example.com

Security note: Avoid using -p/--password flags as they are visible in process listings (ps). Use CHOTKO_PASSWORD environment variable instead.

Config File

Configuration is stored in ~/.config/chotko/config.yaml:

server:
  url: "https://zabbix.example.com"

auth:
  # API Token (recommended for Zabbix 5.4+)
  token: "your-api-token-here"
  # Or use username/password
  # username: "Admin"
  # password: "zabbix"

display:
  refresh_interval: 30  # seconds
  min_severity: 0       # 0=all, 1-5=filter
  theme: "nord"
  window_title: true    # show alert counts in terminal title
  emoji_title: true     # use emoji in title (disable for basic terminals)
  title_min_severity: 0 # minimum severity to show in title

graphs:
  categories:           # item categories for Graphs tab
    - "CPU"
    - "Memory"
    - "Disk"
    - "Network"
  history_hours: 24     # hours of history to fetch
  max_items_per_host: 50 # limit items fetched per host

Precedence: CLI flags > Environment variables > Config file

TLS Configuration

For servers with self-signed or internal CA certificates:

server:
  url: "https://zabbix.example.com"
  insecure_skip_verify: true  # Skip TLS certificate verification

Warning: Only use insecure_skip_verify: true for testing or when connecting to servers with self-signed certificates in trusted networks. This disables certificate validation and makes the connection vulnerable to man-in-the-middle attacks. For production use, configure proper CA certificates instead.

Rate Limiting

To prevent overwhelming the Zabbix server with API requests:

server:
  url: "https://zabbix.example.com"
  rate_limit: 10  # Max API requests per second (optional, default: unlimited)

Recommended values are 10-20 requests per second for most Zabbix servers. Set to 0 or omit for no rate limiting.

Key Bindings

Graphs Tab

Trigger Editor

Macro Editor

Mouse Support

• Click tabs to switch between tabs
• Click list items to select them
• Click tree nodes to select and expand/collapse (Graphs tab)
• Click panes to change focus
• Scroll wheel scrolls the pane under the mouse cursor

Themes

Built-in themes:

• default - Classic Zabbix-inspired colors
• nord - Arctic, cool-toned (default)
• dracula - Dark purple/pink aesthetic
• gruvbox - Retro warm tones
• catppuccin - Soothing pastels
• tokyonight - Cool blues and purples
• solarized - Precision-balanced
• high-contrast - WCAG AAA compliant for accessibility

Custom Themes

Create a custom theme in ~/.config/chotko/themes/mytheme.yaml:

name: "mytheme"
description: "My custom theme"

colors:
  disaster: "#FF0000"
  high: "#FF6600"
  average: "#FFAA00"
  warning: "#FFCC00"
  information: "#6699FF"
  not_classified: "#999999"
  ok: "#00CC00"
  unknown: "#AAAAAA"
  maintenance: "#AA66FF"
  primary: "#6699FF"
  secondary: "#00CC00"
  background: "#1a1a1a"
  foreground: "#EEEEEE"
  muted: "#666666"
  border: "#444444"
  focused_border: "#6699FF"
  highlight: "#333366"
  surface: "#2a2a2a"

Then use it with --theme mytheme or set in config.

Requirements

• Zabbix 7.x (API compatibility)
• Terminal with true color support recommended

License

MIT