Getting Started: Pushbullet
We understand that you have a 'real life' outside your online presence. We also understand the fact that IRC is an addictive protocol and used by many, religiously. Hence, why we think you need to be informed and alert when you are 'Away From Keyboard' in regards to your projects and devel team members. Here is where Push Technology comes into the limelight. It pushes notifications to your Smartphone, Smartwatch, Tablet, Desktop even Web Browser notifying you when someone mentions your username on any IRC channel or network you reside on. It will output the message too.
We find Pushbullet to be a perfect fit for our users. Get a Pushbullet account. It is free, non-trial version. — Authenticate via your Google Mail (GMail) or Facebook account. Once you have successfully authenticated to Pushbullet, you will be automatically redirected to the Pushbullet Dashboard.
On the left-hand side column, you should see a section titled "Devices". Click on the "+" sign / add button, choose your device of choice and install the official Pushbullet application on your preferred device(s). — Pushbullet supports: Android, Apple iOS, Google Chrome, Mozilla Firefox, Opera, Safari, Windows OS, Apple Mac OS X etc. Ubuntu, Windows Phone, Blackberry available via third-party.
Now that you have it installed and authenticated, you should now see the device information appear on the "Devices" section. — Refresh the webpage if it does not output. Else, it is not paired or identifying your device for some odd reason. Contact the Pushbullet support team, if so.
Now, in order to setup your ZNC to push notification through Pushbullet, you will need two bits of codes. The two codes being:-
- Device ID (target)
- Pushbullet Application Program Interface API Key (secret)
Retrieving the Device ID
On the left-hand side "Devices" column, click on the device that you have added.
Upon clicking, notice the address bar on your Web browser now outputs some ransom gibberish-like text, comprising of alphabets and numerics.
In this case, the Device ID would be "ujzkrcGk2wKdjzWIEVDzOK", being your Device ID.
Retrieving the API Key
The API Key resides on your "Account Settings" page. — Click on your 'Avatar' on the Pushbullet Dashboard and choose "Account Settings" from that that dropdown menu.
Scroll down, you should see the "Access Token" section. If you do not see one assigned, hit the "Reset Access Token" and wait for a second or two.
Commands to Execute on ZNC
First and foremost, login to your ZNC account. Make sure you are connected to a Network on your bouncer in order to configure/setup the push module.
/msg *status loadmodule push
/msg *push set service pushbullet
/msg *push set target _DEVICE_ID_
/msg *push set secret _API_KEY_
Switch the 'debug' option on, for testing purposes:
/msg *push set debug on
Now, test it by sending a "Hello, World!" message:
/msg *push send Hello, World!
If successful, you should see the "Hello, World!" message on your device and on the Pushbullet's feed stream. Else, sip some coffee and start the process all over again.
/msg *push set debug off
Done. You can go ahead and configure other bits yourself by executing:
/msg *push get
Other Features of Pushbullet
There are much more options that you can set to your liking. For more information or commands, kindly read the official GitHub Repository for znc-push by the developer himself, John Reese and the Pushbullet API Documentation and Security:-