This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

This library contains an easy-to-use binding for the Velbus protocol. Currently, all messages of the VMB4RYLD and VMB6IN modules are supported since these are the only two modules I have.

Layout of the velbus library is as follows:
  • The connections dir contains two type of connections that can be the source of velbus messages. These are currently the velbus USB controller and a Netstring connection (more on that later)
  • The messages dir contains all supported message types

Dependencies for this library are the simpjeson package ( and twisted ( Install these first.

Install this package is as simple as executing ‘python install’ on the command-line.

I have included three example scripts that use this library (see examples dir)


The forwarder script captures all Velbus packets from the physical bus through the USB controller and forwards them using a Netstring protocol (see for more information on this protocol).

You can use the velbus.connections.netstring module to capture the packets on another computer and continue processing. I use this to forward packets to Google App Engine where the processing of my home automation system occurs.

What you need to be aware of: * The forwarder listens on port 8007 (see file in the src/velbus directory to change this) * To change the device name of your usb controller, see file src/velbus/connections/usb/ and change DEVICE_NAME


I have regular pre-home automation switches but want to emulate the behavior of push button switches because my lights are also controlled by other means than switches (for example: the web interface).

To achieve this without buying new switches, I developed the src/velbusconfig python package.

This package reads a file on startup (currently /etc/velbus_switch_config, see src/velbusconfig/ to change this) and uses this to link regular switches to relays.


Different ‘services’ like the forwarder and switchconfig script can easily be combined because the library uses a publish-subscribe mechanism internally. See on how the two previous scripts are combined.

Release History

Release History


This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting