APRS-Agent

Connection

APRS-IS Server

Port

Callsign

Station Filter

Which stations to monitor from APRS-IS. Wildcards OK: TA3* = all TA3 stations

Full World Feed (port 10152)

Receive all worldwide APRS traffic — ignores Station Filter

Rate limit (pkt/s)

Max packets dispatched to extensions per second. 0 = unlimited.

Repeater DB Path

Path to a Turkey Repeaters JSON file. Stations tab will enrich matching callsigns with city, frequency and tone data.

Public View Port

Read-only Live Log / Stations / Map page on this port — no settings, no start/stop. 0 = off. Only this port is safe to expose to the internet.

Auto-start agent

Print config on startup

Logger

Log incoming APRS packets

Log comments

Include server comment lines (#)

Filter by packet type

Comma-separated chars

Exclude packet types

Keyword filter

Comma-separated, case-insensitive

Fixed Beacon

Periodically send station position

QTH Locator

Maidenhead grid (4/6/8 chars) — auto-fills lat/lon

Station SSID

Latitude / Longitude

Symbol

Comment

Interval (minutes)

Twitter / X

Forward APRS messages as tweets (paid API)

API Key

API Secret

Access Token Key

Access Token Secret

Add #APRS hashtag

Allowed APRS recipients

Comma-separated callsigns

Allowed APRS senders

Bluesky

Post APRS messages to Bluesky (free API)

Username (handle)

App Password

bsky.app → Settings → App Passwords

Add #APRS hashtag

Allowed APRS recipients

Allowed APRS senders

APRS ↔ WhatsApp via Meta Cloud API

Phone Number ID

From Meta Business dashboard

Access Token

Webhook Verify Token

Custom string — must match Meta webhook config

Recipient Phone

Default WhatsApp number for outgoing messages

Add #APRS hashtag

Allowed APRS recipients

Allowed APRS senders

📥 Receive — WhatsApp → Radio (Webhook)

On air from

Own: from the callsign above. Gateway: from the gateway callsign, the text opening with the owner's call.

Gateway callsign

Empty = the first trigger alias

From callsign

APRS sender for WhatsApp messages

Default APRS destination

Allowed phone numbers

Comma-separated, empty = allow all

Bidirectional APRS ↔ Telegram messaging (free)

Bot Token

Get from @BotFather on Telegram

Chat ID

Your Telegram user or group ID

Add #APRS hashtag

Allowed APRS recipients

Comma-separated callsigns

Allowed APRS senders

📥 Receive — Telegram → Radio

Poll Telegram

Forward Telegram messages to APRS

Poll interval (seconds)

On air from

Own: from the callsign above. Gateway: from the gateway callsign, the text opening with the owner's call.

Gateway callsign

Empty = the first trigger alias

Person to person (licensed amateurs)

Anyone may link their chat to their callsign: /bagla CALL in Telegram, then LINK <code> from the radio. Linked chats send on air under their own callsign.

From callsign

APRS sender for forwarded Telegram messages

Default APRS destination

If set, messages without a callsign prefix go here

AI Gateway

Auto-respond to APRS messages with AI. This is the master switch for ALL AI calls — turning it off also stops Silence Map, Propagation and Station AI assessments, even if those are individually enabled below

AI Callsign

Provider

API Key

Stored separately per provider — switching providers recalls its own key instead of overwriting one shared field.

Custom Base URL

Only for custom provider

Model

Leave empty for provider default

System Prompt

Trigger Prefix

Only messages starting with this prefix trigger AI

Trigger Aliases

Extra APRS addressees, comma-separated

Extra SMS Parts

Off

Whitelist

Only respond to listed callsigns

Allowed Callsigns

Wildcards OK

Questions in a row

How many a sender may ask back to back before being asked to wait. 0 = no limit

Refill (seconds)

One more question per this many seconds, back up to the burst once idle. 0 = no limit

Daily ceiling

Total questions answered per day across ALL senders. 0 = no ceiling. Per-sender limits do not protect you from many strangers asking once each

📤 Send — Radio → Email (SMTP)

SMTP Send

SMTP Server

Username

Password

Allowed APRS senders

Allowed APRS recipients

Allowed destination emails

Comma-separated, empty = allow all

From address

Person to person (licensed amateurs)

A station links its address from the radio: LINK addr, then LINK <code> from the mail. Anyone may then send "CALL text" to a linked callsign. Sent through the transport below, never the account above.

Person-to-person SMTP

Person-to-person From

An address of your own domain that passes SPF and DKIM from this server

📥 Receive — Email → Radio (IMAP)

IMAP Receive

IMAP Server

Username

Password

Gmail: use App Password

Poll interval (min)

From callsign

Allowed sender emails

Comma-separated, empty = allow all

Person to person (licensed amateurs)

This server's own mail server takes mail for CALL@domain into the Maildir below. Only a DMARC pass from an address linked to a callsign goes on air, under that callsign. The IMAP account above is not used.

Maildir

Mail domain

Authserv-id

The name your mail server writes in Authentication-Results

Station AI

AI Station Analysis

Periodically send station comments to AI for org name and description extraction. Uses the AI Gateway provider settings.

Run every (hours)

AI Gateway (provider/API key) must be configured. Each new station is analysed once and cached for the session.

Max per run

Monitor

Repeater Monitor

Notify when a DB repeater goes offline or comes back online

Notify via

Check interval (min)

Watch callsigns

Comma-separated base callsigns to monitor. Leave empty to monitor all repeaters in the DB.

Silence map region

Maidenhead fields (first 2 characters) that silence detection is limited to. A prefix station filter also matches callsigns abroad; without this, their outages raise alerts too. Turkey = KM, KN, LM, LN. Empty = worldwide.

Silence alert digest (min)

Batch silence alerts into one combined notification every N minutes. 0 = send each alert immediately. Recommended for wide-area monitoring, where individual alerts would flood the channel.

Propagation notify region

Maidenhead fields (first 2 characters) a band-opening notification is limited to — matches if EITHER end of any link in the opening falls in these fields, so a cross-continent opening reaching your region still notifies. The map and timeline always show every opening worldwide regardless of this setting; it only scopes the Telegram/email message. Turkey = KM, KN, LM, LN. Empty = notify on every opening.

Extension Server

Bidirectional TCP stream for external programs

Listen host

Listen port

Config File

Path

0 stations

Callsign	Type	Location	Organization	Freq (MHz)	Status	Last Heard

Time		From	To	Channel	Message

Person-to-person bridges: what was carried and what was refused, per UTC day. Recent refusals are kept in memory only, until restart.

Event	Today	30 days

Recent refusals

Time	Event	Who

Regional silence (possible outage) IGate failure One shared gate — its own state unknown Internet-connected clients — no local witness Measured, not announced Opening < 600 km 600–1200 km > 1200 km Faint: gate too new to have a normal Grey dotted: suspect - position jump or balloon Badges: stations heard in the last 24 h · Close up: every station heard, fainter the longer it has been silent (1-10 days half, older faint) Show suspect links

Received

Sent

Errors

Packets

HeardHeard / Registry

Registry

Callsigns

—

Uptime

—

Lifetime

● Stopped

APRS-Agent

About APRS-Agent