Navi is a tiny bot for Matrix that sends notifications to users. It is build upon the Matrix Python SDK.
The motivation behind Navi is to send notifications from anywhere to everywhere. This includes the push services GCM and APNs that Riot bridges to, without having to rely on services such as Pushbullet or Pushover.
The first time you use it, Navi creates a new room and invites your user to it. The room will be reused afterwards. If you leave the room, so will Navi, and invite you to a new room. You can also specify room ids that Navi should join and push to directly. If a private room is specified, make sure that you have invited Navi to that room.
$ navi -q -m "Hey, listen"
$ tail -10 some.log | navi
Connecting to https://matrix.org...
Current rooms:
!sjgkDaSSBKduHRADCe:matrix.org
Pushing message...
Connection closed.- Initialize the Matrix SDK submodule:
git submodule update --init - Link it into your path (e.g.
ln -s /path/to/navi.py /usr/local/bin/navi) - Set up a matrix account for Navi
- Create a configuration in
~/.navi.cfg:
The Matrix Python SDK requires requests. Install it with pip install requests.
Navi uses filetype. Install it with pip install filetype.