Web-based dashboard for monitoring trunk-recorder status in real-time with live updates, charts, and administrative controls.

• Features
• Install
• Configure
  • Plugin Options
• Usage
• API Endpoints

• Real-time updates via Server-Sent Events (SSE)
• Active call monitoring with talkgroup details, frequencies, and durations
• Historical charts for decode rates and call activity (5m, 15m, 60m views)
• Recorder status with detailed device information
• System information including control channels, talkgroups, and unit tags
• Live console output
• Admin panel with basic configuration editor and restart controls
• Two-tier authentication (info-level and admin-level access)
• UI themes (Nostromo, Classic, Hot Dog Stand)
• HTTPS support
• No external dependencies!
• More and more stuff!!!

1. Clone Trunk Recorder source following these instructions.

2. Build and install the plugin:

  This plugin source should be cloned into the /user_plugins directory of the Trunk Recorder 5.0+ source tree. It will be built and installed along with Trunk Recorder.

Note: The build uses a minimal shell script with standard Unix tools (sh, sed, cat) to embed web assets into the web_assets.h header.

cd [your trunk-recorder github source directory]
cd user_plugins
git clone https://github.com/taclane/tr-web.git
cd [your trunk-recorder build directory]
cmake ..
make
sudo make install

Plugin Usage:

Add the plugin to your trunk-recorder config.json to get started:

{
  "plugins": [
    {
      "library": "libtr_web_plugin.so",
      "name": "tr-web",
      "port": 8080,
      "admin_username": "trunkadmin",
      "admin_password": "admintrunk"
    }
  ]
}

The plugin supports two-tier authentication:

• Info-level (username/password): Read-only access to status, calls, and console
• Admin-level (admin_username/admin_password): Full access including config editor and restart

If only info-level credentials are set, all authenticated users have read-only access. If admin credentials are also set, admin features require the admin credentials. The /health endpoint always bypasses authentication for monitoring.

Generate a self-signed certificate:

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes

Configure paths in config.json:

{
  "ssl_cert": "/path/to/cert.pem",
  "ssl_key": "/path/to/key.pem"
}

Access the dashboard at http://your-server:8080 (or https:// if configured).

• Status: Active/recent calls, recorder grid, system summary, device tiles
• Recorders: Detailed recorder status table
• Systems: Per-system info, control channels, talkgroup/unit tag data
• Console: Live console output with ANSI colors and filtering
• Affiliations: Unit/talkgroup association tracking with heatmap data and JSON export
• Admin: System status, login history, config editor, restart controls

Real-time updates via /events:

{
  "systems": [{
    "sys_name": "CountyP25",
    "sys_num": 0,
    "type": "p25",
    "control_channel": 851000000,
    "control_channels": [851000000, 852000000]
  }],
  "recorders": [{
    "id": 0,
    "type": "P25",
    "rec_state_type": "RECORDING",
    "talkgroup": 101
  }],
  "calls": [{
    "call_num": 12345,
    "talkgroup": 101,
    "talkgroup_alpha_tag": "Fire Dispatch",
    "freq": 851025000,
    "emergency": false,
    "encrypted": false
  }],
  "callHistory": [],
  "rates": {"CountyP25": {"decoderate": 35.7}},
  "rateHistory": {"CountyP25": []},
  "callRateHistory": {"CountyP25": []},
  "devices": [{
    "driver": "rtlsdr",
    "device": "0",
    "center": 851000000,
    "rate": 2400000,
    "gain": 38.6
  }],
  "consoleLogs": [],
  "config": {"theme": "nostromo"}
}