# Network Ping

#### *ping-skill.nogre*

### Description:

This is a 3rd party skill that uses keywords to get either a server's ping time or status via ICMP echo requests. This can be used to check that a server is responding correctly. Alternatively, one can use this to send simple HTTP GET requests to a server to start or stop services. By using the Network Ping Skill, custom commands can be created for webhook-enabled online services.

For instance, saying, *Mycroft: Send a Ping to network node Google* garners a reply of `Pinged in 9.03 milliseconds.`

If a keyword is set to get the server response, then Mycroft will reply, `Server says: OK 200`, or `Bad Gateway 502`, et cetera.

***

Configuration of network node aliases is stored in a text file, `hosts.txt`, with one "keyword,setting,URL" per line:

google,0,<https://google.com>

This line will tell the Ping Skill that **google** is the keyword, **0** is for a *Ping* response and then the URL to ping. Alternatively, this

linux,1,<https://linux.com>

will respond to the **linux** keyword and return the server *Status* of `linux.com`, because of the **1** after the keyword.

If you are running server software that can respond to GET requests, such as [Huginn](https://github.com/cantino/huginn), or there is a webservice without a prepackaged Mycroft skill that accepts webhooks, then a line like

hug, 1, <https://www.HuginnDomain.com/users/1/web\\_requests/2/supersecretstring?service=start>

and the corresponding settings on the remote end will make the Ping Skill into a basic remote control. Saying *Mycroft: Send a Ping Hug* will load that URL, which will execute code on the server. Mycroft will reply, in the case of Huginn with a default Webhook Agent, with the custom server response, `Event Created 201`, to confirm the instruction was received and followed.

#### Platform:

![Mark I](https://500835181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzX1y2oL49APvqHoV5o%2Fuploads%2Fgit-blob-20518efa3a75671db56c323c5962b4108102367b%2Fmark-1-icon.png?alt=media) ![Mark II](https://500835181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzX1y2oL49APvqHoV5o%2Fuploads%2Fgit-blob-72e32b84335e1f575f6e5b7b684320acc72e799f%2Fmark-2-icon.png?alt=media) ![Picroft](https://500835181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzX1y2oL49APvqHoV5o%2Fuploads%2Fgit-blob-b7dc7493983981386b73158927c1ddf91597de7a%2Fpicroft-icon.png?alt=media) ![plasmoid](https://500835181-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzX1y2oL49APvqHoV5o%2Fuploads%2Fgit-blob-e517091d0124a9f790e778e3219fa05a3f71d7f0%2Fkde.png?alt=media)

#### Examples:

> Send a Ping to network node Google.\
> Send ICMP echo to ten dot zero dot zero dot thirty.\
> Send ping to dns name mycroft dot AI.

### Installation:

{% hint style="warning" %}
This skill is not aproved by Mycroft skill tester.
{% endhint %}

{% tabs %}
{% tab title="Install by mycroft-msm" %}
`mycroft-msm install https://github.com/nogre/ping-skill`
{% endtab %}
{% endtabs %}

### Summary:

**Github:** <https://github.com/nogre/ping-skill>\
**Owner:** [@nogre](https://github.com/nogre)\
**Created:** 2017 Feb 17 18:45:39 UTC **Last updated:** 2019 Jun 10 21:07:35 UTC\
**License:** MIT License

**Categories:** \[ IoT ]\
**Tags:** #network #ping #utility