What is Bump?

Use bump to inform yourself when that long-running script is finally done. Or threw an error. Did you write an event-based script? Get a notification on your phone immediately. Secure your messages with end2end encryption. Best of all? You can set it up in seconds, by scanning a single QR code with the bump app.

Data Removal

There are two ways to remove all personal data from the Bump Servers:

• If you have the app, click Clear Log; this removes all messages on the server; Please back up all your data before, as there is no way to revert this.
• If you no longer have the app, you can request removal, by writing me an email raphael@maenle.net, which includes your secret key.
• If you no longer have your secret key, all data older than 30 days is automatically removed from the server.

Get the App

Bump is in early testing alpha; there’s an android app and a python package.

The Android App

Find the Android App with the id com.maenle.bump on the playstore and download it to your device.

Python Package

Using pip, do

pip install git+https://git.maenle.net/raphael/bump_python

to install bump on your computer.

Usage example

Command-Line Interface

The python package you installed comes with a convenient CLI. If this is your first time using bump, call the CLI:

1

bump

This will show you a QR code (similar to the one in the above picture). Scan it with the Bump app. Now, try sending yourself a notification:

1
2

bump "Hello World"
bump foo

fantastic, you’ve just received your first bump notifications on your phone.

You can also use the Python Package inside python scripts

Instantiate a bump object:

1
2

import bump
bp = bump.Bump()

if this is your first time using bump, a new secret QR code will automatically appear in your command line. If you’ve used bump before, use bp.show_secret() to get the QR code printed.

Open the android app, and scan the QR code. The sender + passcode on the phone and in your terminal should now match up.

And that’s it. Use:

1

bp.push("Hello World")

and receive that notification on your phone! Exhilarating.

Additional features

You can also bp.peek() or bp.pop() to access the stack of messages on the server if you want. Should you want to remove all your data immediately, use

• bp.clear() to remove all your messages on the server message stack immediately
• bp.delete_sender() to delete the sender id your’e currenty using from the sender. This will sever the connection to connected mobile devices.

How does it work?

An elixir rest server promises scalable robust software. Your bump token is matched with your firebase token(s) in a database, alongside your past 24 hours of messages. A message includes an encrypted section (of which the key is only known to you) and an unencrypted section (which is necessary for clear-text notifications on the phone, when the app is not running). Note, that the message transportation and storage is fully encrypted no matter which one you’re using.

Right now, the app only shows the clear-text notification. End2End encrypted messages are received and only visualized in-app. Elixir client support will be added shortly.

Further details of the tech stack will become available over the course of this project, when the documented server and android source-code will become available. The python client is open source and you can go through the code, please consider the early alpha stage of the project.