KISSPush.

Personal smartphone notifications, the easy way.


Fran├žais

INTRODUCTION

KISSPush is an Android app doing only one thing, one simple thing, but doing it well: to display notifications on phones.

In the KISSPush world, you may adopt one or two of the following roles: Producer or Consumer. A Producer emits notifications while consumers phones display them.

DO YOU HAVE AN EXAMPLE ?

  • You may want to get notified if its going to rain today.
  • In a company, employees may want to receive notifications about internal events.
  • You have a group of friends, each one is able to notify others when he goes out for a beer.
  • Everything else you want to be aware of but you don't want to get a mail for this

HOW DO I START ?

First, you may install the KISSPush application from Google Play and start to add a channel like firstname-lastname or a pseudonym or whatever a bit uniq your mind can catch.

WHAT IS A CHANNEL ?

In the KISSPush world, you never publicly share your phone identity, instead, you join and leave channels. When you or someone want to throw a notification, the notification is sent to a channel. If at this moment you're on the channel, you'll receive it.

There is no procedure to create a channel, join it, it exists.

You may stay alone on your channel, consider it private, if its name is hard to guess like john-doe-fasj2hsi82hskfk, and never join a second channel, or you may join some public channels like XKCD to receive a notification when XKCD publishes a new strip

I WANT TO SEND A NOTIFICATION

There is a simple API over an HTTP POST on api.kisspush.net/channel/CHANNEL_NAME, you may try it using :

curl -X POST -H "Content-Type: text/plain" --data "Hello world" api.kisspush.net/channel/john_doe
Be aware, I'm pedantic about Content-Type, you're sending me plain text, so please put a "Content-Type: text/plain" header, else, I'll ignore your message.