Awesome
PB for Desktop
<p align="center"> <b>PB for Desktop</b> is a <b>lightweight</b> open-source <b>Desktop app</b> for <b><a href="https://pushbullet.com/">PushBullet</a></b>.<br> Receive native push notifications on macOS, Windows and Linux.</b><br><br> <img height="200px" src="https://raw.githubusercontent.com/sidneys/pb-for-desktop/master/resources/graphics/icon.png"/><br><br> <i>Not affiliated with PushBullet, Inc.</i><br><br> </p><p align="center"> <img alt="Pushbullet for Desktop, macOS" width="75%" src="https://raw.githubusercontent.com/sidneys/pb-for-desktop/master/resources/screenshots/screenshot-macos.png"/><br> <sub><sup>macOS</sup></sub> </p> <p align="center"> <img alt="Pushbullet for Desktop on Windows" width="75%" src="https://raw.githubusercontent.com/sidneys/pb-for-desktop/master/resources/screenshots/screenshot-win32.png"/><br> <sub><sup>Windows</sup></sub> </p> <p align="center"> <img alt="Pushbullet for Desktop, Linux" width="75%" src="https://raw.githubusercontent.com/sidneys/pb-for-desktop/master/resources/screenshots/screenshot-linux.png"/><br> <sub><sup>Linux</sup></sub> </p>
Cross Platform
Tested on:
- macOS Mojave 10.14.6 (18G1012)
- Windows 10 1607, 1703, 1709, 1803
- Linux Ubuntu 19, elementaryOS 0.4
Unobtrusive
Runs as a Menubar (macOS) or a SysTray (Windows) app. Small resource footprint.
Native Notifications
Uses macOS' Notification Center, the Windows 10 Action Center and libnotify for Linux.
Notification Thumbnails
For text-based pushes, notification thumbnails are generated on-the-fly based on a the originating Websites' favicon. For pushes containing image content, a thumbnail-sized image is shown within the notification.
Custom Sound Effects
Use the default PushBullet sound or one of your choice.
Ships multiple sound effect sets: Android, iOS, Tesla Motors, Slack, Nintendo, Windows, macOS
Or use your own custom sound (supported formats: .m4a
, .mp3
, .mp4
, .ogg
and .wav
)
Notification Filter
A portable, file-based filter allows you to skip notifications you don't need. Supports regular expressions.
Simple Setup
No wrestling with API-Keys or other technical knowledge required. Login to Pushbullet using Google or Facebook.
Send & receive SMS to Android devices.
Reply to SMS messages directly within native Desktop notifications (macOS).
Channel Images for IFTTT and Zapier
Channel-specific (e.g. IFTTT, Zapier, Chat) icon images for most notifications.
Notification Mirroring
Mirror Android notifications (Android).
Direct Pushes to Desktop
Adds a PB for Desktop
PushBullet device for sending pushes to your desktop.
Developer Friendly
Ships multiple NodeJS-driven command scripts for Developers, as code contributions are welcome.
Contents
<a name="installation"/></a>Installation
Standard Installation
Grab the latest version here: Download Pushbullet for Desktop
Installation as global nodejs module
npm install --global pb-for-desktop
<a name="development"/></a>Development
Getting the Sourcecode
To clone the Git repository and install the required dependencies, run these Shell commands:
git clone https://github.com/sidneys/pb-for-desktop.git
cd pb-for-desktop
npm install
Developer Commands
The following npm
scripts are available for development purposes:
start
Runs the app in development mode.
npm run start
Parameters:
--debug
Start with development tools
localsetup
Installs the app in the System app folder and starts it.
npm run localsetup
Parameters:
--build
Rebuilds app before installation--preview
Build "Preview" app--debug
Start with enabled development tools
<a name="build"/></a>build
Builds the application and creates platform-specific installation packages (see requirements). If no parameter is supplied, the current platform is built. Supports building a Beta application version, which is running side-by-side with the regular version.
npm run build
Parameters:
--macos
Build & Package for macOS--windows
Build & Package for Windows--linux
Build & Package for Linux--preview
Build "Preview" app
<a name="building"/></a>Building
Build the App for the current Platform
See the build
Developer command.
Multi-Platform Builds
- Only macOS can build all other platforms and requires Homebrew to install the prerequisite software.
- Building Windows (on macOS, Linux) requires
wine
,mono
- Building Linux (on macOS, Windows) requires
fakeroot
,dpkg
Build-for-Windows Preparation on macOS
brew install wine mono
Build-for-Linux Preparation on macOS
brew install fakeroot dpkg
Build-for-Windows Preparation on Linux
apt-get install wine mono gcc-multilib g++-multilib
<a name="roadmap"/></a> Roadmap
- Binaries signed for Distribution (macOS, Windows)
- End-To-End Tests (see Spectron)
<a name="contribute"/></a> Contribute
Read the contribution documentation first.
- Issues File bugs and document issues.
- Developer Chat: Talk about features and suggestions.
<a name="license"/></a> License
MIT
<a name="author"/></a> Author
sidneys 2019