Documentation • Supported Services • Install • Github Action • Configuration • Contributing • Show Your Support
PingMe is a personal project to satisfy my needs of having alerts, mostmajor platforms have integration to send alerts but its not always useful,either you are stuck with one particular platform, or you have to do alot ofintegrations. I needed a small utility which i can just call from my backup scripts,cron jobs, CI/CD pipelines or from anywhere to send a message with particularinformation. And i can ship it everywhere with ease. Hence, the birth of PingMe.
Everything is configurable via environment variables, and you can simply exportthe logs or messages to a variable which will be sent as message, and most ofall this serves as a swiss army knife sort of tool which supports multipleplatforms.
brew install kha7iq/tap/pingme
# build from sources
yay -S pingme
# binary
yay -S pingme-bin
export PINGME_VERSION="0.2.4"
wget -q https://github.com/kha7iq/pingme/releases/download/v${PINGME_VERSION}/pingme_Linux_x86_64.tar.gz && \
tar -xf pingme_Linux_x86_64.tar.gz && \
chmod +x pingme && \
sudo mv pingme /usr/local/bin/pingme
scoop bucket add pingme https://github.com/kha7iq/scoop-bucket.git
scoop install pingme
Alternatively you can head over to release pagesand download deb
, rpm
or binary
for windows & all other supported platforms.
Docker container is also available on both dockerhub and github container registry.
latest
tag will always pull the latest version available, or you can also downloadspecific version. Checkout releasepage for available versions.
Docker Registry
docker pull khaliq/pingme:latest
Github Registry
docker pull ghcr.io/kha7iq/pingme:latest
Run
docker run ghcr.io/kha7iq/pingme:latest
A github action is available for integration with your workflows, you can find it onGithub Market Place orhere Github Repo.
- name: PingMe-Action
uses: kha7iq/pingme-action@v1
❯ pingme
NAME:
PingMe - Send message to multiple platforms
USAGE:
main [global options] command [command options] [arguments...]
DESCRIPTION:
PingMe is a CLI tool which provides the ability to send messages or alerts to multiple
messaging platforms and also email, everything is configurable via environment
variables and command line switches.Currently supported platforms include Slack, Telegram,
RocketChat, Discord, Pushover, Mattermost, Pushbullet, Microsoft Teams, Twillio, Mastodon,
email address, Line, Gotify and Wechat.
COMMANDS:
telegram Send message to telegram
rocketchat Send message to rocketchat
slack Send message to slack
discord Send message to discord
teams Send message to microsoft teams
pushover Send message to pushover
email Send an email
mattermost Send message to mattermost
pushbullet Send message to pushbullet
twillio Send sms via twillio
zulip Send message to zulip
mastodon Set status message for mastodon
line Send message to line messenger
wechat Send message to wechat official account
gotify Send push notification to gotify server
help, h Shows a list of commands or help for one command
GLOBAL OPTIONS:
--help, -h show help (default: false)
Check Documentation Page for more details.
All the flags have corresponding environment variables associated with it. Youcan either provide the value with flags or export to a variable.
View the Documentation Page for moredetails.
Contributions, issues and feature requests are welcome!
Feel free to checkissues page. You can also take a lookat the contributing guide.
Give a
Fork it
Make it better
This project is based on amazing library Notify