hemna/aprsd
1
0
Fork 0
mirror of https://github.com/craigerl/aprsd.git synced 2025-05-24 10:32:25 -04:00
Code Issues Projects Releases Wiki Activity

more README.rst cleanup

Browse Source
This commit is contained in:
Hemna 2021-12-07 15:22:08 -05:00
parent 7c653cc100
commit 28b54c330d
1 changed files with 19 additions and 44 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

63
README.rst
View File

@ -46,56 +46,31 @@ callsigns to look out for. The watch list can notify you when a HAM callsign
in the list is seen and now available to message on the APRS network. in the list is seen and now available to message on the APRS network.
List of core server plugins Current List of built-in plugins:
===========================
Plugins function by specifying a regex that is searched for in the APRS message.
If it matches, the plugin runs. IF the regex doesn't match, the plugin is skipped.
* EmailPlugin - Check email and reply with contents. Have to configure IMAP and SMTP settings in aprs.yml
* FortunePlugin - Replies with old unix fortune random fortune!
* LocationPlugin - Checks location of ham operator
* PingPlugin - Sends pong with timestamp
* QueryPlugin - Allows querying the list of delayed messages that were not ACK'd by radio
* TimePlugin - Current time of day
* WeatherPlugin - Get weather conditions for current location of HAM callsign
* VersionPlugin - Reports the version information for aprsd
* NotifySeenPlugin - Send a message when a message is seen from a callsign in
the watch list. This is helpful when you want to know
when a friend is online in the ARPS network, but haven't
been seen in a while.
Current messages this will respond to:
====================================== ======================================
:: ::
APRS messages: └─> aprsd list-plugins
l(ocation) [callsign] = descriptive current location of your radio Plugin Name Plugin Path Type Info
8 Miles E Auburn CA 1673' 39.92150,-120.93950 0.1h ago ---------------------- ----------------------------------------- ------------ ----------------------------------------------------------
w(eather) = weather forecast for your radio's current position EmailPlugin aprsd.plugins.email.EmailPlugin RegexCommand Send and Receive email
58F(58F/46F) Partly Cloudy. Tonight, Heavy Rain. FortunePlugin aprsd.plugins.fortune.FortunePlugin RegexCommand Give me a fortune
t(ime) = respond with the current time LocationPlugin aprsd.plugins.location.LocationPlugin RegexCommand Where in the world is a CALLSIGN's last GPS beacon?
f(ortune) = respond with a short fortune NotifySeenPlugin aprsd.plugins.notify.NotifySeenPlugin WatchList Notify me when a CALLSIGN is recently seen on APRS-IS
-email_addr email text = send an email, say "mapme" to send a current position/map PingPlugin aprsd.plugins.ping.PingPlugin RegexCommand reply with a Pong!
-2 = resend the last 2 emails from your imap inbox to this radio QueryPlugin aprsd.plugins.query.QueryPlugin RegexCommand APRSD Owner command to query messages in the MsgTrack
p(ing) = respond with Pong!/time TimeOWMPlugin aprsd.plugins.time.TimeOWMPlugin RegexCommand Current time of GPS beacon's timezone. Uses OpenWeatherMap
v(ersion) = Respond with current APRSD Version string TimeOpenCageDataPlugin aprsd.plugins.time.TimeOpenCageDataPlugin RegexCommand Current time of GPS beacon timezone. Uses OpenCage
anything else = respond with usage TimePlugin aprsd.plugins.time.TimePlugin RegexCommand What is the current local time.
VersionPlugin aprsd.plugins.version.VersionPlugin RegexCommand What is the APRSD Version
AVWXWeatherPlugin aprsd.plugins.weather.AVWXWeatherPlugin RegexCommand AVWX weather of GPS Beacon location
OWMWeatherPlugin aprsd.plugins.weather.OWMWeatherPlugin RegexCommand OpenWeatherMap weather of GPS Beacon location
USMetarPlugin aprsd.plugins.weather.USMetarPlugin RegexCommand USA only METAR of GPS Beacon location
USWeatherPlugin aprsd.plugins.weather.USWeatherPlugin RegexCommand Provide USA only weather of GPS Beacon location
Meanwhile this code will monitor a single imap mailbox and forward email installation:
to your BASECALLSIGN over the air. Only radios using the BASECALLSIGN are allowed
to send email, so consider this security risk before using this (or Amatuer radio in
general). Email is single user at this time.
There are additional parameters in the code (sorry), so be sure to set your
email server, and associated logins, passwords. search for "yourdomain",
"password". Search for "shortcuts" to setup email aliases as well.
Installation:
============= =============
pip install aprsd pip install aprsd