PHPackages fr3nch13/pushover-bash - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Mail & Notifications](/categories/mail) 4. / 5. fr3nch13/pushover-bash ActiveLibrary[Mail & Notifications](/categories/mail) fr3nch13/pushover-bash ====================== Pushover Bash Script 1.0.4(2y ago)01.2kGPL-3.0-or-laterShell Since Jul 20Pushed 2y agoCompare [ Source](https://github.com/fr3nch13/pushover-bash)[ Packagist](https://packagist.org/packages/fr3nch13/pushover-bash)[ Docs](https://github.com/fr3nch13/pushover-bash)[ RSS](/packages/fr3nch13-pushover-bash/feed)WikiDiscussions main Synced 1mo ago READMEChangelog (2)DependenciesVersions (5)Used By (0) [![CI Bash](https://github.com/fr3nch13/pushover-bash/actions/workflows/bash.yml/badge.svg)](https://github.com/fr3nch13/pushover-bash/actions/workflows/bash.yml)[![CI Composer](https://github.com/fr3nch13/pushover-bash/actions/workflows/composer.yml/badge.svg)](https://github.com/fr3nch13/pushover-bash/actions/workflows/composer.yml)[![CI NPM](https://github.com/fr3nch13/pushover-bash/actions/workflows/npm.yml/badge.svg)](https://github.com/fr3nch13/pushover-bash/actions/workflows/npm.yml) Pushover Bash Script ==================== [](#pushover-bash-script) A Bash shell script to send pushover notifications. A [Pushover account](https://pushover.net/) is required to use this script. Based on the original [Pushover Bash](https://github.com/akusei/pushover-bash) by [akusei](https://github.com/akusei). Usage ----- [](#usage) ``` usage: pushover.sh [options] -t, --token APIKEY The pushover.net API Key for your application -u, --user USERKEY Your pushover.net user key -m, --message MESSAGE The message to send; supports HTML formatting -a, --attachment filename The Picture you want to send -T, --title TITLE Title of the message -d, --device NAME Comma seperated list of devices to receive message -U, --url URL URL to send with message --url-title URLTITLE Title of the URL -p, --priority PRIORITY Priority of the message -2 - no notification/alert -1 - quiet notification 0 - normal priority 1 - bypass the user's quiet hours 2 - require confirmation from the user -e, --expire SECONDS Set expiration time for for notifications with priority 2 (default 180) -r, --retry COUNT Set retry period for notifications with priority 2 (default 30) -s, --sound SOUND Notification sound to play with message pushover - Pushover (default) bike - Bike bugle - Bugle cashregister - Cash Register classical - Classical cosmic - Cosmic falling - Falling gamelan - Gamelan incoming - Incoming intermission - Intermission magic - Magic mechanical - Mechanical pianobar - Piano Bar siren - Siren spacealarm - Space Alarm tugboat - Tug Boat alien - Alien Alarm (long) climb - Climb (long) persistent - Persistent (long) echo - Pushover Echo (long) updown - Up Down (long) none - None (silent) -x, --validate If set, it will only validate the account -v, --verbose Return API execution reply to stdout -d, --debug Print out debugging information WARNING, this will output your user key and token to stdout ``` Configuration ------------- [](#configuration) Configuration files can be placed in **/etc/pushover/pushover-config**, in the user's home directory at **$HOME/.pushover/pushover-config**, or in the root of this repository. The options are processed in order of importance for location. You can copy pushover-config-dist to pushover-config in any of these places. 1. Options in /etc/pushover/pushover-config are processed first 2. Options in $HOME/.pushover/pushover-config are processed next 3. Options in ./pushover-config are processed next 4. Command line arguments override all configuration values The default configuration is empty and contains the following: ``` api_token= user_key= device= url= url_title= priority= title= sound= ``` **NOTE:** If you have a value defined in /etc/default/ and also have overrides in $HOME/.pushover/ all empty options in $HOME/.pushover/ must not exist in the file. For example, I have the following configuration in /etc/default/ ``` api_token=my-app-api-token user_key=my-user-key device= url= url_title="I want all URLs to have this title" priority= title="this is a generic title" sound= ``` If I want to override only **title** for a specific user, the configuration in $HOME/.pushover/ will look like this ``` title="title for specific user" ``` Support ------- [](#support) - For PHP Composer based projects, see [COMPOSER.md](COMPOSER.md) - For Node.js/NPM based projects, see [NPM.md](NPM.md) - Currently working on Python's PyPi Examples -------- [](#examples) Send a simple "This is a test" message to all devices using the stored configuration in either **/etc/default/pushover-config**, **$HOME/.pushover/pushover-config**, or **./pushover-config** ``` pushover.sh -m "This is a test" ``` Send a simple "This is a test" message to all devices using the specified API token and user key ``` pushover.sh -t token -u key -m "This is a test" ``` Send a simple "This is a test" message with the title "Test Title" to all devices using the specified API token and user key ``` pushover.sh -t token -u key -m "This is a test" -T "Test Title" ``` Send a simple "This is a test" message to the devices named "Phone" and "Home Desktop" using the specified API token and user key ``` pushover.sh -t token -u key -m "This is a test" -d "Phone,Home Desktop" ``` Send a simple "This is a test" message to all devices that contains a link to [www.google.com](http://www.google.com) titled "Google" using the specified API token and user key ``` pushover.sh -t token -u key -m "This is a test" -U "http://www.google.com" --url-title Google ``` Send a simple "This is a test" high priority message to all devices using the specified API token and user key ``` pushover.sh -t token -u key -m "This is a test" -p 1 ``` Send a simple "This is a test" message to all devices that uses the sound of a bike bell as the notification sound using the specified API token and user key ``` pushover.sh -t token -u key -m "This is a test" -s bike ``` Sends a simple "This is a test Pic" message to all devices and send the Picture with the message ``` pushover.sh -t token -u key -m "This is a test Pic" -a /path/to/pic.jpg ``` ### Health Score 25 — LowBetter than 37% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity14 Limited adoption so far Community11 Small or concentrated contributor base Maturity47 Maturing project, gaining track record Bus Factor1 Top contributor holds 83.3% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~2 days Total 3 Last Release 1020d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/a8db156d8ccab278b11d1d79631bbeb9374b93193d5408fd05417cd3e51ba27f?d=identicon)[fr3nch13](/maintainers/fr3nch13) --- Top Contributors [![fr3nch13](https://avatars.githubusercontent.com/u/7828?v=4)](https://github.com/fr3nch13 "fr3nch13 (115 commits)")[![akusei](https://avatars.githubusercontent.com/u/12972900?v=4)](https://github.com/akusei "akusei (16 commits)")[![mtiurin-JNPR](https://avatars.githubusercontent.com/u/72055867?v=4)](https://github.com/mtiurin-JNPR "mtiurin-JNPR (4 commits)")[![j1r1k](https://avatars.githubusercontent.com/u/8515215?v=4)](https://github.com/j1r1k "j1r1k (2 commits)")[![TobiasKWF](https://avatars.githubusercontent.com/u/18166322?v=4)](https://github.com/TobiasKWF "TobiasKWF (1 commits)") --- Tags notificationsbashpushover ### Embed Badge ![Health badge](/badges/fr3nch13-pushover-bash/health.svg) ``` [![Health](https://phpackages.com/badges/fr3nch13-pushover-bash/health.svg)](https://phpackages.com/packages/fr3nch13-pushover-bash) ``` ### Alternatives [minishlink/web-push Web Push library for PHP 1.9k12.0M52](/packages/minishlink-web-push)[thomasjohnkane/snooze Schedule future notifications and reminders in Laravel 9321.5M2](/packages/thomasjohnkane-snooze)[mouse0270/bootstrap-growl This is a simple pluging that turns standard Bootstrap alerts into "Growl-like" notifications. 2.2k119.1k](/packages/mouse0270-bootstrap-growl)[paragraph1/php-fcm PHP application server for google firebase cloud messaging (FCM) 1991.2M10](/packages/paragraph1-php-fcm)[benwilkins/laravel-fcm-notification Laravel FCM (Firebase Cloud Messaging) Notification Channel 210964.1k1](/packages/benwilkins-laravel-fcm-notification)[alymosul/exponent-server-sdk-php Server-side library for working with Expo push notifications using PHP 1541.5M14](/packages/alymosul-exponent-server-sdk-php) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)