____ _ / ___|___ _ __ ___ _ __ ___ __ _ _ __ __| |___ | | / _ \| '_ ` _ \| '_ ` _ \ / _` | '_ \ / _` / __| | |__| (_) | | | | | | | | | | | (_| | | | | (_| \__ \ \____\___/|_| |_| |_|_| |_| |_|\__,_|_| |_|\__,_|___/

ElmerEmail Email Commands


Email responses from ElmerEmail

Responses from ElmerEmail in email form are designed to provide information in longer format while still being simple and quickly sent over a low bandwidth connection. Most responses will be greater than 250 characters (unless the "short" setting is enabled, which will reduce the email size to a maximum of 144 characters).

Some commands may also contain small attachments, such as maps, Grib files, etc, but only if the "attch" setting is activated.

Locations

Many of the commands on ElmerEmail are location based. This is the argument {location} or {loc}. In commands where there is only ONE location argument, that argument is possibly optional. Many email services, such as WinLink, embed your current location in the email message headers (the "headers" are the parts of the email message you typically don't see or interact with). There is also a setting that allows you to specify a more permeant location for yourself. If there is only one {location} argument needed, and you did not send us a location in your request, our software will attempt to divine your location from first the email message headers and then second check to see if you have set a permeant location in the settings, and then use that location to fulfill the request. This makes it much easier to make location based requests, particularly if the request involves information from where you are right now.

A {location} could be blank (if you want to use your current or permeant location), a set of GPS coordinates in the decimal format latitude,longitude such as 35.9521,-85.0327 (note there is NO SPACE after the comma), a Maidenhead Grid Square such as EM75lw58, or just a place name/address such as Knoxville, TN or 6071 Buford Hwy Atlanta, GA.

If the location you entered was incorrectly formatted, or simple not found through geocoding, you may get an error reply

Formatting Commands

Commands and Subcommands sent to ElmerEmail are case insensitive, we convert them anyway to lower case for processing. Arguments however may be case sensitive depending on what the request you are making.

How to read the Examples

Examples are given in this format: commands subcommand|subcommand argument {argument}

Possible Subcommands are delimited by the pipe symbol "|". When you see the subcommand "self" this means that the command can be sent without any subcommands, though the arguments may vary, see the description for details.

Arguments that are encapsulated be the curly brackets "{}" are optional, Arguments without curly brackets "{}" are madatory. The argument name should give you some idea about what information is expected by that argument

Some commands require that arguments have "markers" on them. This could be something like from: to: start: end:, etc. Markers will always have colons ":" and be shown/noted in the example

Service Notice

Because we are still in the pre-release phase of this project, these commands, especially their examples, are not yet standardized nor fully correct

Commands

Here are a list of all the currently active ElmerEmail commands:

Help

Returns a help message with instructions and commands
Example: help

Weather

Sends a detailed weather report for the location, the option {radar} adds an image attachment (if settings permit) for various types of wether images. Those options are: radar, cloud, and rain
Example: weather {location}

Directions

This gives back a message in text with directions from the location {from} to the location {to}. If {from} is blank, the system will presume your current location if available.
Example: directions from:{loc} to:{loc}

Headlines

Sends back a list of news headlines and a brief summery
Example: headlines

Distance

Sends back the distance between two location. If only one is sent, the the system will presume your current location if available
Example: distance from:{loc} to:{loc}

GridSquare

Sends back the grid square for the location. If {location} is blank, the system will presume your current location if available.
Example: gridsquare {location}

Qrz

Send back qrz details for the call sign given.
Example: grz {callsign}

APRSlocation

Sends the latest APRS location beacons from aprs.fi for the given {ssid}
Example: aprslocation {ssid}

Wikipedia

Send back the wikipedia information. Subcommands "self" and "seach" will seach for the {text} you provide. Subcommand "summary" will send back a summary of the artical title you send as the {text} argument. Subcommand "all" will send back the entire article title you send as the {text} argument.
Example: wikipedia self|search|summary|all {text}

ISS

Sends the next pass for the ISS for a given {location}
Example: iss {location}

Satellite

Sends the next pass for a given {satellite} for a {location}. Sending the command without any arguments will send back a list of avaiable satellites.
Example: satellie {satellite} {location}

Settings

Sends back all the current and possible settings for your email. Subcommands are "set" to save a setting, "del" to delete a setting, or "show" to see a single setting. The argument {setting} is the setting name, and you only use the agument {value} when you want to set or change a {setting}.
Example: settings set|del|show {setting} {value}

ChatGPT

Sends back a response to a ChatGPT question you send as the {quary} argument.
Example: chatgpt {quary}

Test

Testing Module - sends back a simple test message
Example: test

DAPNET

Send a message to a DAPNET Pager. You must have your own callsign setup in settings.
Example: dapnet to:{callsign} message:{message}

GMRS

Sends back FCC data for a given gmrs {callsign}
Example: gmrs {callsign}

Future Commands

Here are a list of some of the ElmerEmail commands that will be working soon:

Map

Sends back an image attachment with a map for the location. Type options are: street, topo, or satellite. Default is street map. Zoom options are for the area to cover, higher zoom gives more detail but less area, it is a number 1 to 10. 10 should give you about 1 square mile, 1 will give you you about 100 square miles. Default is 5.

SMS

Sends an SMS Text message to the number given.

Swapshop

Sends a list of items in users have posted for sale. swapshop post {description} - will post an item for sale. Your name, email, location, and call sign will be automatically added to the listing. Swapshop items will be automatically removed after 7 days . Limit 250 sharacters.

APRSbeacon

This will post an APRS location beacon on aprs.fi with the given location. You much have an SSID set in the options and settings to use tis feature

Texts

Sends text file or information about the text file collection. Subcommands "self" and "search" send back a list of files that contain the term you send at the argument {text}. Subcommand "cat" sends back a list of all the catagories, or if you put in a catagory name as the {text} argument, it will send back a list of all files in that catagory. The subcommand "send" will send back the text document for the ID or title you enter as the {text} argument.

Grib

Sends back a Grib file for the given location

Subscriptions

Sends a list of subscriptions showing all and the ones you are subscribed to

Subscribe

Subscribes you to the {name} subscription. The Subscription might also require an addtional argument.

Unsubscribe

Unsubscribes you to the {name} subscription.

LastLocation

Sends back the location of a given {callsign,email} as last recorded by ElmerEmail only if the user has allowed their location to be shared.