vPilot Pushover

Relay vPilot and Hoppie messages to your mobile device via Pushover.
Hoppie is integrated directly, meaning you can use any aircraft with this plugin.

Have also a look at my other projects at my homepage: https://blt950.com

Prerequisites

1. vPilot that you use to connect to VATSIM
2. Pushover app on your device and subscription
3. Creating your own Pushover API key which is for your personal use

Pushover has a 30-day trial you can try out before you pay the one-time $5 for a lifetime subscription. You can use Pushover to much more than this plugin, the subscription is in no way tied to this plugin

Installation

1. Make sure your vPilot is not running
2. Download the latest release .zip only from the releases page
3. Extract the zip file and move both vPilot-Pushover.dll and vPilot-Pushover.ini to your vPilot plugin folder, usually C:\Users\<your username>\AppData\Local\vPilot\Plugins
4. Open vPilot-Pushover.ini in a text editor and configure your desired settings
5. When you start vPilot you should now get an "Connected. Running version x.x.x" push notification. If not, see troubleshooting below.

(Optional) Using Telegram bot instead of Pushover

1. In Telegram message BotFather with /newbot
2. Give your bot a name by replying (name must end in bot) for example with vPilot_bot
3. This will generate a reply with a BotToken and link to join the chat with your bot, join this chat
4. Send a message to you bot for example Hello world
5. In a browser navigate to https://api.telegram.org/bot<API-token>/getUpdates (Replace with the token obtainend in step 3)
6. In the browser you will see your message object from which you can copy the ChatId, an example of how such a message looks like is shown below

{
    "update_id": 8393,
    "message": {
        "message_id": 3,
        "from": {
            "id": 7474,
            "first_name": "AAA"
        },
        "chat": {
            "id": <ChatId>,
            "title": "<Group name>"
        },
        "date": 25497,
        "new_chat_participant": {
            "id": 71, 
            "first_name": "NAME",
            "username": "YOUR_BOT_NAME"
        }
    }

5. Enable the Telegram option in vPilot-Pushover.ini and fill in the BotToken (step 3) and ChatId (step 4)
6. When you start vPilot you should now get an "Connected. Running version x.x.x" message from your Telegram bot.

Troubleshooting

I don't receive any connected notification

• Make sure you have placed the plugin in the correct folder, usually like this C:\Users\<your username>\AppData\Local\vPilot\Plugins\vPilot-Pushover.dll and .ini in the same folder.
• Your Windows might have blocked the .dll file. This is because the .dll is not code-signed as it's a hobby project and I don't have $200/yearly to purchase a verification. Before you unblock the file, check it with your antivirus or upload it to VirusTotal. If you're comfortable to proceed, right click on the vPilot-Pushover.dll, open Properties, unblock and apply to allow vPilot to load the plugin.

Still having an issue? Make an issue request here on Github.

Settings

In the vPilot-Pushover.ini file, you can configure the following settings:

[Pushover]

UserKey = Your Pushover user key. You can find this on the Pushover dashboard
ApiKey = Your Pushover API key. You need to create this youself in Pushover
Device = The device name to send the notifications to. If you leave this blank, it will send to all devices. If you want to specifify multiple devices, separate them with a comma, e.g. iphone,nexus5

[Telegram]

Enabled = Whether or not to use a Telegram bot instead of Pushover. Set to true or false
BotToken = Your Telgram bot API key, see this for instructions ChatId = Your Telgram bots chat id key, see this for instructions

[Hoppie]

Enabled = Whether or not to relay Hoppie messages to Pushover. Set to true or false
LogonCode = Your Hoppie logon code.

[RelayPrivate]

Enabled = Whether or not to relay private messages to Pushover. Set to true or false

[RelayRadio]

Enabled = Whether or not to relay radio messages to Pushover. Only sends radio messages meant for your callsign, e.g. ATC writing to you on text. Set to true or false

[EnableSelcal]

Enabled = Whether or not to relay SELCAL messages to Pushover. Set to true or false

[Disconnect]

Enabled= Whether or not to send message when disconneted from network to Pushover. Set to true or false

Contribution

Feel free to contribute by creating pull requests or issues in this Github!