The main purpose of this article is for archive and personal blog about what I’m doing in my work. For more info and best practice, I suggest you should visit official website of pypi.

I’m not familiar with python, but since I need to use python with my raspberry pi project I think this is a good chance to getting started. In my case, I need to transmit data from sensor that connected to GPIO to online server so that other people can monitor the what the current status of my sensor. Originally I will using http protocol to send data from raspberry pi via curl but this won’t work if we want to get realtime data since there will be too much latency. Then again this won’t be efficient if we have to sending data with say, 10 second interval?

After spending some time reading article from internet, I found about websocket. Even thought I’m a web developer, I don’t even know about websocket until recently. So here it is.


Fortunately, python (version 2.7) comes preinstalled in raspbian-jessie that I’m using. So I don’t have to install it manually. All I need is to install websocket client library using command sudo pip install websocket-client and done. I’m ready to write a python script. For more info about installation, please read the official repository.

The Code

Let’t start it by creating a project directory named my-websocket-client-project. Now we can change to working directory and create a new file name and type this code

Note: please make sure that your filename is not conflicting with library that we will import.

import websocket
import thread
import time

def on_message(ws, message):
    print message

def on_error(ws, error):
    print error

def on_close(ws):
    print "### closed ###"
    # Attemp to reconnect with 2 seconds interval

def on_open(ws):
    print "### Initiating new websocket connection ###"
    def run(*args):
        for i in range(30000):
            # Sending message with 1 second intervall
            ws.send("Hello %d" % i)
        print "thread terminating..."
    thread.start_new_thread(run, ())

def initiate():
    ws = websocket.WebSocketApp("ws://",
        on_message = on_message,
        on_error = on_error,
        on_close = on_close)
    ws.on_open = on_open


if __name__ == "__main__":

There you have it, run it with command python To stop it, press ctrl+c twice.

Next time we will sending actual data to server from sensor.