**SpacenearUS** is a bot that sits in [[https://web.libera.chat/#highaltitude|#highaltitude]] and [[https://web.libera.chat/#habhub|#habhub]] IRC channels on Libera.Chat. The bot provides notifications about recent activity on the tracker and a couple of useful commands.


====== spacenear.us ======

^ Command  ^  Admin\\ Req.  ^ Example(s)  ^ Typical response  ^
| !whereis <name> \\ !status <name>     | | !whereis b-64         | B-64 was over ... Russia (61.6213,38.2415) at 12258 meters about 3 days ago       |
| !ping <name>                          | | !ping b-63            | Last contact with B-63 was 17 days ago                                            |

====== Habitat ======

^ Command  ^  Admin\\ Req.  ^ Example(s)  ^ Typical response/What it does  ^
| !flights                              | | !flights              | Current flights: XABEN78 (a812), PS-18 434.650 OLIVIA 8/250 Enable RSID (797d)    |
| !flight <name or id>                 | | !flight a812          | Flight (a812): XABEN78 (2 payloads) - Launch date Today at 12:00 from ...         |
|:::                                    | | !flight HL1           |::: |
| !payloads <name or id> \\ !payload <name or id> \\  | | !payloads a812        | Payload XABEN0 (a812) - 434.3 MHz USB RTTY 50/600Hz ASCII-7 none 2 \\ Payload HL1 (a812) - 434.25 MHz USB RTTY 50/600Hz ASCII-7 none 1 |
|:::                                    |::: |:::                    |::: |
|:::                                    | | !payload HL1          | Payload HL1 (a812) - 434.25 MHz USB RTTY 50/600Hz ASCII-7 none 1                  |
| !dial <name or id>                    | | !dial b-66            | Latest dials for B-66 (705b): 434.5 MHz |
|:::                                    | | !dial 705b            |::: |
| !window <name or id>                  | | !window hl11          | Flight window for XABEN78 (a812) is from Today at 00:00 to Today at 23:59         |
| !tracker                              | | !tracker              | Here you go - http://habhub.org/mt/                                               |
| !track <name(s)>                      | | !track b-63           | Here you go - [[http://habhub.org/mt/?filter=b-63]]                               |
|:::                                    | | !track b-63 b-64      | Here you go - [[http://habhub.org/mt/?filter=b-63;b-64]]                          |
|:::                                    | | !track b-*            | Here you go - [[http://habhub.org/mt/?filter=b-*]]                                |
|:::                                    | | !track !b-* !*chase   | Here you go - [[http://habhub.org/mt/?filter=!b-*;!*chase]]                       |
| !id <id or name>                      | | !id b-63              | Responds with info about the doc (depending on doc type) \\ Looks through approved and unapproved flights. |
|:::                                    | | !id a812              |::: |
|:::                                    | | !id ..a812            |::: |
| !amiadmin                             |  ✓  | | Check if the bot recognizes you as an admin |
| !approve                              |  ✓  | | (context sensitive) Approve a previously mentioned flight doc |
| !cancel <doc id>                      |  ✓  | | Remove approval on an already approved flight doc |
| !extend <doc id> <1h,1d>       |  ✓  | | Extend flight window for a flight doc. |
| !monocle \\ !monocle <doc id> \\ !monocle <any id>  |  ✓  | | (context sensitive) Get Monocle JSON explorer url |
|:::                                    |:::  |::: | Get Monocle JSON explorer url for specified id |
|:::                                    |:::  |::: |::: |

====== HYSPLIT ======
Give you access to on-demand trajectory prediction for anything on tracker.

^ Command  ^  Admin\\ Req.  ^ What it does  ^
| !hysplit help | | Provides a web link to this section |
| !hysplit [list]                       | | List available HYSPLIT runs |
| !hysplit [gif/get] <callsign>             | | Get URL to a GIF of the current prediction for <callsign> |
| !hysplit kml <callsign>                   | | Get URL to a KML of the current prediction for <callsign> |
| !hysplit defaults                     | | List of calsigns that are run when a new GFS model is available |
| !hysplit run <callsign>               |  ✓  | Find match callsign currently on the map and run HYSPLIT (wildcard is %) \\ This will not add the callsign to the defaults list. \\ The defaults list in ran once every 6hrs and overwrite previous HYSPLITs. |
| !hysplit rerun                        |  ✓  | Runs new HYSPLITs for callsign in the defaults list |
| !hysplit clear                        |  ✓  | Clears all callsigns from the defaults list |
| !hysplit add <callsign>               |  ✓  | Add a single callsign to the defaults list (wildcard is %)|
| !hysplit remove <callsign>            |  ✓  | Remove a single callsgin from the defaults list (wildcard is %) |

====== APRS Gateway ======
Balloons in flight are automatically imported to http://tracker.habhub.org
Any callsign can be manually added with the add/remove commands to import all packets.

^ Command ^  Admin\\ required  ^ What it does ^
| !aprs | | Lists callsigns set to be auto-imported onto http://spacenear.us |
| !aprs help | | Provides a web link to this section |
| !aprs status | | Displays internal stats about the APRS Gateway service |
| !aprs <add/remove> <callsign> [display callsign] |  ✓  | Add/remove callsign from auto-importer |
| !aprs list-bal [interval] | | List callsigns with balloon symbol. Interval specifies freshness in hours. |
| !aprs list-bal-url [interval] | | Same as above, but instead provides a link to aprs.fi |
| !aprs find <callsign/pattern> | | Find the location of callsign(s). Up to 3. Wildcard possible. |
| !aprs info <callsign/pattern> | | Verbose info of a single callsign. Up to 1. Wildcard possible. |
| !aprs telemetry <callsign/pattern> | | Telemetry of a single callsign. Up to 3. Wildcard possible. |
| !aprs ping <callsign/pattern> | | Latest contact of a single callsign. Up to 15. Wildcard possible. |


====== Misc. ======
^ Command  ^  Admin\\ Req.  ^ Example(s)  ^ Typical response  ^
| !wiki <text> | | !wiki beginners guide | Wiki page beginners_guide_to_high_altitude_ballooning - [[http://...]]            |
| !help | | | Provides a link to this very page |