Skip to content
This repository


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

Turn your devices into buckets. Impress your friends with "magic" :-)

branch: master

Fetching latest commit…


Cannot retrieve the latest commit at this time

Octocat-spinner-32 public
Octocat-spinner-32 templates
Octocat-spinner-32 app.js
Octocat-spinner-32 buckets.js
Octocat-spinner-32 config.js

Bucket Balls

Bucket Balls lets you connect multiple devices (Smartphones, Laptops,...). Each device becomes a "Bucket". You can create some colored balls inside a bucket. If the device supports the "deviceorientation"-event you can slop the balls inside a bucket into another bucket. You can create rulesets to define which bucket is allowed to drop its balls in which other buckets. Buckets Balls is build with Node.JS and box2d. It's a fun weekend project, so I wont commit it to the NPM repository since I dont know if I will be able to maintain it in future.

Wanna see Bucket Balls in action?

Have a look at this Video on YouTube:

Bucket Balls on YouTube


Simply clone the project and install express, and jqtpl in the projects directory like this:

npm install express
npm install
npm install jqtpl


You can setup bucket balls within the config.js file. There you can define rulesets and and map client IDs to them.


When everything is setup run the bucket balls server with node app.js. Afterwards connect the devices ('buckets') by calling http://[host:port]/client/[clientID] in their browsers. You can then init client 1 for example with 30 balls by typing this command into the bucket command line:

Something went wrong with that request. Please try again.