https://github.com/rhee876527/pushbullet-notifier

Simple pushbullet-notifier for Linux desktop.
https://github.com/rhee876527/pushbullet-notifier

api libnotify linux-desktop notifications pushbullet pushbullet-api python systemd-service websocket

Last synced: 3 months ago
JSON representation

Simple pushbullet-notifier for Linux desktop.

• Host: GitHub
• URL: https://github.com/rhee876527/pushbullet-notifier
• Owner: rhee876527
• License: mit
• Created: 2025-03-04T09:45:14.000Z (about 1 year ago)
• Default Branch: main
• Last Pushed: 2025-03-04T10:53:36.000Z (about 1 year ago)
• Last Synced: 2025-03-04T11:31:03.082Z (about 1 year ago)
• Topics: api, libnotify, linux-desktop, notifications, pushbullet, pushbullet-api, python, systemd-service, websocket
• Language: Python
• Homepage:
• Size: 20.5 KB
• Stars: 0
• Watchers: 1
• Forks: 0
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# pushbullet-notifier

Simple pushbullet-notifier for Linux desktop.

![Example](https://github.com/rhee876527/pushbullet-notifier/blob/main/example.png?raw=true)

### Why:

The Chrome extension store has ended support for MV2 extensions and the author has no plans to port the Pushbullet extension to MV3 as far as am aware.

So we make our own replacement listener client using the API. And queue incoming notifications to desktop using `notify-send`.

### Requirements: 

`python` and `libnotify`. 

Works on:

![Python 3.13](https://img.shields.io/badge/Python-3.13-brightgreen.svg)

### Benefits:

- Extremely simple - Uses std python libraries for websocket connections to Pushbullet's API.

- Local cache of client pushes.

- Resilient auto-resume from last message. HTTP polling keeps pushes always fresh.

### Use: Easy as 1,2,3

1. Get API Access Token from https://www.pushbullet.com/#settings/account

2. Create pushbullet client aka $DEVICE_ID.

   ```

   curl -u $PUSHBULLET_API_KEY: -X POST https://api.pushbullet.com/v2/devices \

       -H "Content-Type: application/json" \

       -d '{"nickname": "LinuxPC", "icon": "laptop"}'

   

   ```

 

     from the response `iden` is your `$PUSHBULLET_DEVICE_ID`

3. Run the python app as a daemon service to listen for new pushes

   Configure the environment variables in the service

   ``nano ~/.config/systemd/user/pushbullet-notify.service``

   

   ```

    [Unit]

    Description=Pushbullet Notification Service

    After=graphical-session.target network-online.target

    Requires=graphical-session.target

    

    [Service]

    ExecStartPre=/bin/sleep 15

    ExecStart=%h/.stuff/push.py

    Restart=always

    WatchdogSec=900

    Type=notify

    RestartSec=10

    WorkingDirectory=%h/.stuff

    

    # Pushbullet API

    Environment="PUSHBULLET_API_KEY=o.8ZxSAMPLEpKo8uRp"

    Environment="PUSHBULLET_DEVICE_ID=ujxSAMPLEZ32i"

    

    [Install]

    WantedBy=graphical-session.target

   ```

   then run:

   `systemctl --user enable --now pushbullet-notify.service `

Learn more about the pushbullet API here: https://docs.pushbullet.com/